Your Stream Deck, working on Linux.
Elgato never made a Linux app. StreamController fills the gap: a free, open-source app that runs every key, dial and page on your Stream Deck.
Version 1.5.0-beta.16, released 22 August 2026. stream-deck.zip, 4.0 MB, for Linux.
- Price
- FreeOpen source, GPL-3.0, no account.
- Plugins in the store
- 74Official and community-made.
- Elgato models
- 10From the Mini to the Studio.
- Download
- 4.0 MBOne zip, one install script.
Pages, not just buttons
A page is one full layout of keys. Make one for streaming, one for work, one for music, and jump between them with a key, or let StreamController switch for you when you change windows.
Try it on the deck: switch pages below, or press the keys that lead to another page.
Press a key, or switch pages.
What it does on your desk
The same job Elgato's app does on Windows: put an icon on each key and run something when you press it. A few parts go further.
A plugin store inside the app
Install OBS, Home Assistant, Spotify, volume and media controls with one click. Icon packs and wallpaper packs come from the same store.
Pages that follow your windows
Open Spotify and the music page appears. Focus your editor and the coding page takes over. Works on GNOME, KDE, Hyprland, Sway and X11.
Wallpapers across the keys
Stretch one image or video over the whole deck, and set a screensaver for when you step away.
Locks when your computer does
When the session locks, the deck stops accepting presses until you log back in.
Sticky keys on every page
Pin a key so it shows on all pages, without copying it into each one.
A command line for scripting
Change pages, press keys, set brightness and edit labels from a shell script or over D-Bus.
Installed in three steps
The install script sets up everything StreamController needs: system packages, a Python environment, device permissions and an app-menu entry.
Download the zip
stream-deck.zip, 4.0 MB. It's StreamController 1.5.0-beta.16 with an install script.
Extract it and run the installer
It asks for your password once to install system packages and the Stream Deck permission rule.
Terminal$ unzip stream-deck.zip $ cd stream-deck $ ./install.shReplug the deck and open the app
StreamController is now in your app menu. The first run walks you through the basics.
Every current Stream Deck
Keys, dials, touch strips and pedals all work. Hot-plugging works for Elgato devices; unplug and replug while the app runs.
Stream Deck (Original, V2, MK.2)
15 keys in a 5 × 3 grid.
Stream Deck Mini
6 keys, 3 × 2. Discord Edition included.
Stream Deck XL
32 keys, 8 × 4.
Stream Deck Neo
8 keys, an info bar and two touch points.
Stream Deck +
8 keys, a touch strip and 4 dials.
Stream Deck + XL
36 keys, a touch strip and 6 dials.
Stream Deck Studio
32 keys in two rows of 16, plus 2 dials.
Stream Deck Pedal
3 foot pedals, no screens.
Stream Deck Modules
Bare 6, 15 or 32 key modules.
Mirabox & Ulanzi decks
Stream Dock 293S and Ulanzi D200.
Guides for your distribution
The download is the same everywhere. What differs is the package manager the installer uses and which desktop quirks to know about.
- Ubuntu & MintInstall notes, and the background setting that stops keys freezing.
- Fedora & BazziteWorkstation and KDE, plus notes for Silverblue, Bazzite and other atomic desktops.
- Arch & ManjaroThe installer on Arch, portal packages, and tiling window managers.
- Any other distributionudev rules, page switching per desktop, and what to check first.
Questions people ask first
Does the Elgato Stream Deck work on Linux?
Yes. Elgato only makes its Stream Deck app for Windows and macOS, but the hardware is a standard USB device. StreamController is a free Linux app that drives it: it draws the key images, runs actions when you press keys, and switches pages.
Is StreamController free?
Yes. It is open source under the GPL-3.0 licence, with no paid tier and no account. Plugins in its built-in store are free too.
Which Stream Deck models work?
The Original (including V2 and MK.2), Mini, Mini Discord Edition, XL, Neo, Stream Deck +, Stream Deck + XL, Studio, Pedal and the Stream Deck Modules. Two decks from other makers, the Mirabox Stream Dock 293S and Ulanzi D200, are experimental. Full device list.
Can I use plugins made for Elgato's Stream Deck software?
No. Plugins written for Elgato's app do not run in StreamController. It has its own plugin store with OBS, Home Assistant, Spotify, Discord, volume mixer and many more. Browse the plugins.
How do I install it?
Download stream-deck.zip from this site, extract it, and run ./install.sh inside the folder. The script works on Ubuntu, Mint, Debian, Fedora, Arch and Manjaro. Step-by-step install.
Plug it in and start mapping keys.
StreamController is free. Download the zip, run one script, and plug your deck in.