SirenoDECKv0.2.10

Declarative control for
your Stream Deck

brew install sergiocarracedo/tap/sirenodeck

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.

SirenoDECK is not affiliated with Elgato in any way.

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.

Overlay deck guide

Addons & Themes

Extend Sireno Deck with installable addons and custom themes. Addons contribute button types and generated decks; themes customize the deck's visual style.

Browse addons Browse themes

Coding Agents

Monitor OpenCode and Claude Code sessions from the deck. See status counts, open a generated deck of session tiles, and inspect session details. Preview uses illustrative sessions.

Overlay deck guide

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

Demo deck shown inside a landscape phone mockup; remote mode displays the same deck on your phone

QR code linking to the SirenoDECK remote emulator

scan at runtime for your deck URL

Customization

Themes that fit you

From built-in essentials to independently crafted looks. Create your own with color and typography tokens.

Default

official

The built-in slate dark theme. Deep slate background, cyan accents, IBM Plex Sans + Plex Mono typography.

darkdefaultminimal

Light

official

Clean minimal light theme. Perfect for bright environments and daytime use.

lightminimal

Folio

community

Soft ivory tiles, graphite typography and a single deep-blue accent. A calm, tactile third-party theme inspired by the clarity of mobile interfaces.

lightminimaleditorial

Browse All Themes

Ecosystem

Included addons

6 first-party addons ship with the CLI — plus more workspace addons and a growing community list in the registry.

Core

built-in

The built-in button toolkit for actions, deck navigation, and stateful toggles. The runtime also injects the settings/back key on each deck.

navigationcorerequired

Date Time

built-in

Add live digital time, localized dates, a custom-formatted date and time, or an analog clock to any deck.

clockcalendarproductivity

Media

built-in

Show the current system media track and playback state, with separate controls for playback, mute, and output volume.

systemmediavolume

System Status

built-in

Build system-monitor tiles from selectable CPU, memory, storage, network, battery, sensor, and uptime metrics.

systemmetricsmonitoring

Weather

built-in

Show current weather for a configured location using Open-Meteo; no API key is required.

weatherproductivity

Coding Agents

built-in

Monitor discovered OpenCode and Claude Code sessions from the deck. The summary shows session status counts; tapping it opens a generated deck with one dynamic tile per session.

aiagentscoding

Browse Addon Registry

Get started

Up in 60 seconds

Install with Homebrew on macOS, Linux, or Windows through WSL.

Install the CLI

brew install sergiocarracedo/tap/sirenodeck

Start the onboarding

sirenodeck start

First run launches onboarding: pick your device (or the emulator), connect, done. A starter config.yml is generated for you.

Make it yours

~/.config/sirenodeck/config.yml

Edit the generated config — decks, buttons, themes. Changes apply on save.Full configuration reference

Extend it

pnpm i -g @sirenodeck/addon-app-shortcuts

Then reference it in your config:addons: ["@sirenodeck/addon-app-shortcuts"].Browse the addon registry

GitHub Documentation

Declarative control foryour Stream Deck

Overlay Decks

Addons & Themes

Coding Agents

A tree of decks, linear navigation

Shape your deck.See it as you go.

Your setup, explained in your own words.

Your deck,in your pocket.

Default

Light

Folio

Core

Date Time

Media

System Status

Weather

Coding Agents

Up in 60 seconds

Declarative control for
your Stream Deck

Shape your deck.
See it as you go.

Your deck,
in your pocket.