How do I install the Omarchy Omgato skill?

Run npx skillmds@latest add data-goblin/omarchy-omgato in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Omarchy Omgato safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Omarchy Omgato?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Omarchy Omgato free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Omarchy Omgato?

data-goblin (@data-goblin) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Omarchy Omgato by data-goblin — Agent Skill

Name: Omarchy Omgato
Rating: 4.2 (5 reviews)
Author: data-goblin

Omarchy Omgato

Control Key Light, Stream Deck and Cam Link hardware on Omarchy from the command line - Key Light power, brightness and colour temperature; Stream Deck pages, keys and brightness; the Stream Deck Pedal; and the Cam Link 4K overlay and screen recording. Use whenever the user asks to turn lights on or off, change light brightness or warmth, edit or inspect Stream Deck keys or pages, move or place the camera overlay, or start and stop a screen recording.

data-goblin cc0a450 3.6 KB Updated Sep 17, 2026

File contents

Omgato

Four command line tools. Each prints plain text by default and JSON with --json where a machine-readable answer helps.

Key Lights

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

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 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

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

Panel state and recording

omgato-panel                     # one JSON document: lights, deck, camera, record, 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.

---name: omarchy-omgatodescription: Control Key Light, Stream Deck and Cam Link hardware on Omarchy from the command line - Key Light power, brightness and colour temperature; Stream Deck pages, keys and brightness; the Stream Deck Pedal; and the Cam Link 4K overlay and screen recording. Use whenever the user asks to turn lights on or off, change light brightness or warmth, edit or inspect Stream Deck keys or pages, move or place the camera overlay, or start and stop a screen recording.---# OmgatoFour command line tools. Each prints plain text by default and JSON with `--json`where a machine-readable answer helps.## Key Lights```bashkeylight-ctl ls --json # every light with live statekeylight-ctl on | off | toggle [TARGET] # TARGET is a name, IP, MAC, or "all"keylight-ctl brightness 60 [TARGET] # absolute 0-100keylight-ctl brightness +10 [TARGET] # relative, per lightkeylight-ctl temperature 4500 [TARGET] # kelvin 2900-7000keylight-ctl temperature -300 [TARGET] # relative, per lightkeylight-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 thelight called `Key` even when `Key Light` also exists.## Stream Deck and Pedal```bashstreamdeck-ctl ls --json # kind, key count, rows, columnsstreamdeck-ctl deck pages | show | orderstreamdeck-ctl deck set PAGE INDEX --label L --glyph G --icon PATH \ --bg '#rrggbb' --fg '#rrggbb' --action 'exec:firefox'streamdeck-ctl deck unset PAGE INDEXstreamdeck-ctl deck page-add NAME | page-rm NAME | default NAMEstreamdeck-ctl deck brightness 0-100streamdeck-ctl deck power on | off | toggle # blanks the display, keeps the levelstreamdeck-ctl deck export --out DIR [--radius N] # render every key to PNGstreamdeck-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```bashcamlink-ctl status # JSON: stream, overlay, position and pause statecamlink-ctl show | hide | toggle | fullcamlink-ctl move tl | tr | bl | brcamlink-ctl place "X,Y WxH" # an explicit rectanglecamlink-ctl pick # drag one out with the shared pickercamlink-ctl reset # USB re-authorize a wedged Cam Link```## Panel state and recording```bashomgato-panel # one JSON document: lights, deck, camera, record, shortcutsomgato-panel --lights-only # cheaper, lights onlyomgato-panel sync # every light to the average brightness and temperatureomgato-panel undo | redo # light historyomgato-panel deck-undo | deck-redoomgato-panel cam-undo | cam-redoomgato-panel rename --mac MAC --name NAMEomgato-panel order --macs a,b,comgato-panel record --target pick | last | screen [--desktop-audio] [--mic]omgato-panel record --stopomgato-panel scope-undo | scope-redoomgato-panel install-shortcuts | uninstall-shortcutsomgato-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.

Frequently asked questions