omarchy-omgato

# Omgato Five command line tools. Each prints plain text by default and JSON with `--json` where a machine-readable answer helps. ## Key Lights ```bash keylight-ctl ls --json # every light with live state keylight-ctl on | off | toggle [TARGET] # TARGET is a name, IP, MAC, or "all" keylight-ctl brightness 60 [TARGET] # absolute 0-100 keylight-ctl brightness +10 [TARGET] # relative, per light keylight-ctl temperature 4500 [TARGET] # kelvin 2900-7000 keylight-ctl temperature -300 [TARGET] # relative, per light keylight-ctl set --on --brightness 60 --temp 4500 [TARGET] keylight-ctl discover [--prune] # merges into the cache; --prune drops absent lights ``` An exact name, IP or MAC wins over a substring match, so `Key` addresses the light called `Key` even when `Key Light` also exists. ## Stream Deck and Pedal ```bash streamdeck-ctl ls --json # kind, key count, rows, columns streamdeck-ctl deck pages | show | order streamdeck-ctl deck set PAGE INDEX --label L --glyph G --icon PATH \ --bg '#rrggbb' --fg '#rrggbb' --action 'exec:firefox' streamdeck-ctl deck unset PAGE INDEX streamdeck-ctl deck move PAGE FROM TO [--to-page PAGE] # swaps if TO is taken streamdeck-ctl deck page-add NAME | page-rm NAME | default NAME streamdeck-ctl deck brightness 0-100 streamdeck-ctl deck power on | off | toggle # blanks the display, keeps the level streamdeck-ctl deck export --out DIR [--radius N] # render every key to PNG streamdeck-ctl pedal show | set POSITION GESTURE ACTION ``` POSITION is `left`, `center` or `right`; GESTURE is `tap`, `long` or `double`. An action is `exec:<command>`, `key:<KEY_NAME>`, `page:<name>` or `noop`. ## Cam Link overlay ```bash camlink-ctl status # JSON: stream, overlay, position and pause state camlink-ctl show | hide | toggle | full camlink-ctl move tl | tr | bl | br camlink-ctl place "X,Y WxH" # an explicit rectangle camlink-ctl pick # drag one out with the shared picker camlink-ctl reset # USB re-authorize a wedged Cam Link ``` ## Prompter ```bash prompter-ctl status # JSON: running, connected, mode, script, scripts, playing, speed, font, spacing, brightness, mirror, progress prompter-ctl on | off # off blanks the glass; on returns to the last mode prompter-ctl mode script | monitor # monitor adds a 1024x600 Hyprland output named PROMPTER prompter-ctl load NAME # switches to script mode at the top prompter-ctl play | pause | toggle | top | back | forward prompter-ctl speed 5-600 | faster | slower # pixels per second prompter-ctl font 20-200 | bigger | smaller # pixels prompter-ctl spacing 100-300 # line height, % of text size prompter-ctl brightness 5-100 # dims the picture; the backlight is not reachable prompter-ctl mirror on | off | toggle prompter-ctl script list | show NAME | rm NAME prompter-ctl script write NAME [--text T] # stdin when --text is absent prompter-ctl script edit NAME # opens omarchy-launch-editor ``` Scripts are `~/.local/share/prompter-ctl/scripts/NAME.md`; saving the loaded one redraws the glass in place. Leading `#` is stripped and blank lines start a paragraph. The daemon is `prompter-ctl.service`, started by its udev rule when the Prompter appears; every other subcommand needs it running. ## Panel state and recording ```bash omgato-panel # one JSON document: lights, deck, camera, record, prompter, shortcuts omgato-panel --lights-only # cheaper, lights only omgato-panel sync # every light to the average brightness and temperature omgato-panel undo | redo # light history omgato-panel deck-undo | deck-redo omgato-panel cam-undo | cam-redo omgato-panel rename --mac MAC --name NAME omgato-panel order --macs a,b,c omgato-panel record --target pick | last | screen [--desktop-audio] [--mic] omgato-panel record --stop omgato-panel scope-undo | scope-redo omgato-panel install-shortcuts | uninstall-shortcuts omgato-panel set-shortcut --id ID --keys "SUPER + ALT + L" ``` ## Notes - The Cam Link is a single-open V4L2 device: the overlay and any recorder that wants the camera cannot both hold it. - Light names come from the devices; display names, order and undo history are kept by `omgato-panel` and never written to the lights. - Every tool exits non-zero on failure and prints the reason on stderr.