LaMetric CLI

CLI tool for controlling LaMetric TIME/SKY devices. Send notifications, control settings, manage timers, and stream content.

Prerequisites

Installation

# Homebrew (macOS/Linux)
brew install dedene/tap/lametric

# Or Go install
go install github.com/dedene/lametric-cli/cmd/lametric@latest

Setup

1. Get API key from LaMetric mobile app: Device Settings > API Key
2. Run setup wizard:

lametric setup

Or configure manually:

# Store API key securely
lametric auth set-key --device=living-room

# Or use environment variables
export LAMETRIC_API_KEY=your-api-key
export LAMETRIC_DEVICE=192.168.1.100

Config file location: ~/.config/lametric-cli/config.yaml

Core Workflows

Sending Notifications

Simple notification:

lametric notify "Hello World"

With icon and sound:

lametric notify "Build passed" --icon=checkmark --sound=positive1

Critical alert (wakes device, plays alarm):

lametric notify "ALERT: Server down" --priority=critical --sound=alarm1

Progress indicator:

lametric notify "Upload progress" --goal=75/100 --icon=upload

Sparkline chart:

lametric notify "CPU Usage" --chart=10,25,50,30,45,80,60

From stdin (for pipelines):

echo "Build complete" | lametric notify
git log -1 --format="%s" | lametric notify --icon=github

Wait for user dismissal:

lametric notify "Confirm deployment?" --wait

Device Control

Get device info:

lametric device

Display brightness:

lametric display get
lametric display brightness 50      # Set to 50%
lametric display mode auto          # Auto brightness

Audio volume:

lametric audio get
lametric audio volume 30            # Set to 30%

Bluetooth:

lametric bluetooth get
lametric bluetooth on
lametric bluetooth off

Built-in Apps

Timer:

lametric app timer set 5m           # Set 5 minute timer
lametric app timer set 1h30m        # Set 1 hour 30 minutes
lametric app timer start
lametric app timer pause
lametric app timer reset

Stopwatch:

lametric app stopwatch start
lametric app stopwatch pause
lametric app stopwatch reset

Radio:

lametric app radio play
lametric app radio stop
lametric app radio next
lametric app radio prev

App navigation:

lametric app list                   # List installed apps
lametric app next                   # Switch to next app
lametric app prev                   # Switch to previous app

Streaming

Stream images or video to the display:

lametric stream start               # Start streaming session
lametric stream image logo.png      # Send static image
lametric stream gif animation.gif   # Send animated GIF
lametric stream stop                # End streaming

Pipe from ffmpeg:

ffmpeg -i video.mp4 -vf "scale=37:8" -f rawvideo -pix_fmt rgb24 - | lametric stream pipe

Discovery

Find LaMetric devices on your network:

lametric discover
lametric discover --timeout=10s

Common Patterns

Build/CI Notifications

# Success
lametric notify "Build #123 passed" --icon=checkmark --sound=positive1

# Failure
lametric notify "Build #123 failed" --icon=error --sound=negative1 --priority=warning

# Deployment
lametric notify "Deployed to prod" --icon=rocket --sound=positive2

System Monitoring

# CPU alert
lametric notify "High CPU: 95%" --priority=warning --icon=warning

# Disk space
lametric notify "Disk: 85% full" --goal=85/100 --icon=harddrive

Pomodoro Timer

lametric app timer set 25m && lametric app timer start

Meeting Reminder

lametric notify "Meeting in 5 min" --icon=calendar --sound=alarm3 --priority=warning

Quick Reference

Popular Icons

Alias	Description
checkmark	Success/complete
error	Error/failure
warning	Warning/caution
info	Information
rocket	Deploy/launch
github	GitHub
slack	Slack
mail	Email
calendar	Calendar/meeting
download	Download
upload	Upload

Run lametric icons for full list.

Popular Sounds

Sound	Category
positive1-5	Success sounds
negative1-5	Error sounds
alarm1-13	Alarm sounds
notification1-4	Gentle notifications

Run lametric sounds for full list.

Global Flags

Flag	Description
-d, --device	Device name or IP
-j, --json	Output JSON
--plain	Output TSV (for scripting)
-v, --verbose	Verbose logging

Troubleshooting

Connection Failed

1. Verify device IP: lametric discover
2. Check device is on same network
3. Ensure API key is correct: lametric auth get-key --device=NAME

Authentication Error

# Re-set API key
lametric auth set-key --device=living-room

# Or use environment variable
export LAMETRIC_API_KEY=your-api-key

Device Not Found

# Discover devices
lametric discover --timeout=10s

# Add to config
lametric setup

Installation

brew install dedene/tap/lametric