SirenoDECKv0.2.1

Declarative control for
your Stream Deck

A Node.js CLI that drives your Elgato Stream Deck from a single YAML config. Emulator, real hardware, and dev SPA — all from the same React interface.

Get Started View on GitHub

Star on GitHub—

brew install sergiocarracedo/tap/sirenodeck

Features

Power up your workflow

Three execution surfaces from the same codebase: browser emulator, real hardware, and Vite-powered development SPA.

Overlay Decks

Contextual decks that appear automatically when you switch applications. Your main deck stays intact while an app-specific overlay takes over temporarily. Overlays maintain their own navigation and return to the previous deck when you close the app.

Addons & Themes

Extensible plugin system with a well-defined API. Share addons via npm. Custom themes use a JSON manifest for color, typography, and more. Twelve addons included or distributed across the workspace.

Coding Agents

Live status of OpenCode and Claude Code sessions on the deck — see active agents, send prompts, manage contexts. Preview uses illustrative sessions.

Navigation

Intuitive deck hierarchy

Decks are organised as a tree, but navigation stays linear — at any deck you can move to the next deck in the current branch or go back to the previous one.

A tree of decks, linear navigation

Decks form a tree: a deck can have sub-decks, and a sub-deck can have its own sub-decks.
You navigate linearly along the current branch — tap into the next deck level, or back to the previous one.
Hold the back button from any sub-deck to return straight to Main.
The same rules apply to overlay decks — they follow their own branch and return to the deck that was active before the overlay appeared.

Deck tree

Main
├── Deck 1
│   └── Deck 3
└── Deck 2
    ├── Deck 4
    │   └── Deck 5
    └── Deck 6

Any point → next level or previous · hold back → Main

Configuration

Simple, straightforward YAML

No JavaScript required for basic usage. Define decks, buttons, and actions in a human-readable YAML file.

config.yml

theme: default

decks:
  main:
    name: Main
    buttons:
      - position: 0
        type: core:action
        config:
          icon: icon://github
          label: GitHub
        actions:
          tap: "xdg-open https://github.com"

      - position: 2
        type: date-time:time
        config:
          variant: big

      - position: 4
        type: weather:weather
        config:
          location:
            latitude: 42.2304
            longitude: -8.7256
            name: Vigo

Strict typing

Full schema validation prevents runtime errors before your deck ever boots.

Hot reload

YAML changes reload automatically via SIGUSR1 — no restart loop.

Addons as types

Simple addon:type syntax for any button — your own, third-party, or core.

Full configuration reference

Visual configuration

Shape your deck.
See it as you go.

The config UI pairs a live deck preview with an editor for your decks and buttons. Start in emulator mode to try changes before using hardware.

sirenodeck start --emulator

Explore the emulator

Weather demo deck preview with configured city tiles — Illustrative editor layout · weather demo deck preview

For your coding agent

Your setup, explained in your own words.

The optional SirenoDECK skill helps your agent find the right config, understand included YAML, and propose changes to decks, buttons, and themes. You review edits before they happen.

Read the config skill

Install for your preferred agent

sirenodeck skills

Or install directly, without running SirenoDECK:

npx skills add https://github.com/sergiocarracedo/sireno-deck/tree/main/skills/sirenodeck-config --skill sirenodeck-config --global

Optional on first interactive startup. The agent asks before modifying your configuration.

Remote mode

Your deck,
in your pocket.

No Stream Deck hardware required. Start the daemon with--remoteand it serves a token-gated, deck-only view on your LAN. Scan the QR it prints and your phone becomes the deck.

sirenodeck start --remote

The URL is token-gated — only devices with the QR-scoped link can connect. Buttons tap straight into the same runtime as hardware.

Connectivity & remote docs