# timothycrosley/streamdeck-ui

A Linux compatible UI for the Elgato Stream Deck.

Repository: https://github.com/timothycrosley/streamdeck-ui
Canonical: https://ross.abutalabs.com/products/streamdeck-ui
Homepage: https://timothycrosley.github.io/streamdeck-ui/
Language: Python
License: MIT
License Family: permissive
Last push: 2024-04-28T16:28:55+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2533, "days_push": 857, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1270, forks 245 (observed 2026-08-28T04:04:11.801630+00:00)

## What it is
streamdeck_ui is a Linux-compatible graphical application for configuring and using Elgato Stream Deck devices (Original, MK2, Mini, XL, and Pedal). It lets users map buttons to commands, text input, and hotkey combinations, with multi-device, multi-page, and auto-dim support.

## Use cases
- configure elgato stream deck buttons on linux
- run shell commands from stream deck buttons
- map hotkeys to stream deck keys
- manage multiple stream deck devices
- set up button pages with switching
- auto-dim stream deck display when idle
- import and export stream deck configurations
- use stream deck pedal on linux

## When to choose
- you use an Elgato Stream Deck or Pedal on Linux and want a GUI configurator
- you need multi-action buttons that run commands, type text, or press hotkeys
- you want the app to run as a systemd user service with auto-reconnect

## When to avoid
- you are on Windows or macOS and can use the official Elgato software
- you need a headless or script-only configuration tool without a UI
- you use a non-Elgato macro pad unsupported by the underlying library

## Facets
- artifact type: application
- maturity: stable
- function: gui, developer-tools, workflow-automation
- domain: desktop-applications, developer-tools, hardware
- platform: python
- tags: elgato-stream-deck, stream-deck, hardware-ui, hotkeys, systemd-service, macro-buttons, automation, linux, desktop

## Member repositories
- timothycrosley/streamdeck-ui (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:11.801630+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:03:28.546702+00:00, confidence not recorded.
  - readme: https://github.com/timothycrosley/streamdeck-ui (fetched 2026-08-28T04:04:11.801630+00:00, sha ffed43ed9846)
  - homepage: https://timothycrosley.github.io/streamdeck-ui/ (fetched 2026-08-29T12:15:05.942747+00:00, sha d18c9264d0e6)
- Data as of 2026-08-30T08:39:29.467469+00:00.