Your Stream Deck, your rules

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

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 via YAML with color, typography, and more. Twelve addons included or distributed across the workspace.

Coding Agents

Specialized addon for AI coding agent integration. Live status of OpenCode + Claude Code sessions on the deck — see active agents, send prompts, manage contexts.

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:
          command: "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

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.

sireno 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