A service, Web Interface, and UI for interacting with your computer using a Stream Deck
Read Latest Documentation Release notes
streamdeck_ui A Linux compatible UI for the Elgato Stream Deck.
- Linux Compatible: Enables usage of Stream Deck devices (Original, MK2, Mini and XL) on Linux.
- Multi-device: Enables connecting and configuring multiple Stream Decks on one computer.
- Brightness Control: Supports controlling the brightness from both the configuration UI and buttons on the device itself.
- Configurable Button Display: Icons + Text, Icon Only, and Text Only configurable per button on the Stream Deck.
- Multi-Action Support: Run commands, write text and press hotkey combinations at the press of a single button on your Stream Deck.
- Button Pages: streamdeck_ui supports multiple pages of buttons and dynamically setting up buttons to switch between those pages.
- Auto Reconnect: Automatically and gracefully reconnects, in the case the device is unplugged and replugged in.
- Import/Export: Supports saving and restoring Stream Deck configuration.
- Drag/Drop: Move buttons by simply drag and drop.
- Drag/Drop Image: Configure a button image by dragging it from your file manager onto the button.
- Auto Dim: Configure the Stream Deck to automatically dim the display after a period of time. A button press wakes it up again.
- Animated icons: Use an animated gif to liven things up a bit.
- Runs under systemd: Run automatically in the background as a systemd --user service.
- Stream Deck Pedal: Supports actions when pressing pedals.
Communication with the Stream Deck is powered by the Python Elgato Stream Deck Library.
Once you're up and running, consider installing a systemd service.
Use the troubleshooting guide or search the issues for guidance.
There are scripts for setting up streamdeck_ui on Debian/Ubuntu and Fedora.
Start without showing the user interface
Note you can start streamdeck_ui without showing the configuration user interface as follows:
Enter a value in the command field to execute a command. For example,
gnome-terminal will launch a new terminal on Ubuntu/Fedora or
obs will launch OBS.
These examples are for Ubuntu using xorg. You can use a tool like
xdotoolto interact with other applications.
Find the window with a title starting with
Meet - and bring it to focus. This helps if you have a Google Meet session on a tab somewhere but you lost it behind another window.
xdotool search --name '^Meet - .+$' windowactivate
The meeting tab must be active one if you have multiple tabs open, since the window title is set by the currently active tab.
Find the window with a title starting with
Meet - and then send
ctrl+d to it. This has the effect of toggling the mute button in Google Meet.
xdotool search --name '^Meet - .+$' windowactivate --sync key ctrl+d
Change the system volume up (or down) by a certain percentage. Assumes you're using PulseAudio/Alsa Mixer.
amixer -D pulse sset Master 20%+
If you want you invoke a command that uses shell-script specific things like
|, run it via bash. This command will shift focus to firefox using the
wmctrl, and then shifts focus to the first tab:
bash -c "wmctrl -a firefox && xdotool key alt+1"
Simulates key press combinations (hot keys). The basic format is a group of keys, separated by a
+ sign to press simultaneously. Separate key combination groups with a
, if additional key combinations are needed. For example,
alt+F4,f means press and hold
alt, followed by
F4 and then release both. Next, press and release
You can also specify a KeyCode in hex format, for example,
0x74 is the KeyCode for
t. This is also sometimes called the keysym value.
You can use the
xevtool and capture the key you are looking for. In the output, look for the keysym hex value, for example
(keysym 0x74, t)
plusif you want to actually output
delay <n>to add a delay, where
<n>is the number (float or integer) of seconds to delay. If
<n>is not specified, 0.5 second default is used. If
<n>fails to parse as a valid number, it will result in no delay.
F11- Press F11. If you have focus on a browser, this will toggle full screen.
alt+F4- Closes the current window.
ctrl+w- Closes the current browser tab.
cmd+left- View split on left. Note
cmdis the super key (equivalent of the Windows key).
alt+plus- Presses the alt and the
+key at the same time.
alt+delay+F4- Press alt, then wait 0.5 seconds, then press F4. Release both.
1,delay,delay,2,delay,delay,3- Type 123 with a 1-second delay between key presses (using default delay).
1,delay 1,2,delay 1,3- Type 123 with a 1-second delay between key presses (using custom delay).
echo "test"and press enter.
ctrl+alt+0x74- Opens a new terminal window.
0x74is the KeyCode for
t. TIP: If the character doesn't work, try using the KeyCode instead.
0xffe5- Toggle Caps Lock.
/key on the numeric key pad.
The standard list of keys can be found at the source.
super key (Windows key) can be problematic on some versions of Linux. Instead of using the Key Press feature, you could use the Command feature as follows. In this example, it will press
4, which launches application number 4 in your favorites (Ubuntu).
xdotool key "Super_L+4"
A quick way of typing longer pieces of text (verbatim). Note that unlike the Press Keys action, write text does not accept special (modifier) keys. However, if you type Enter (causing a new line) it will press enter during the output.
Unfortunately that's a hard no. Kind regards, Joe
Confirm you are running the latest release with
pip show streamdeck-ui. Compare it to:
- Streamdeck uses pynput for simulating Key Presses but it lacks proper support for Wayland. Generally your results will be good when using X (Ubuntu/Linux Mint). This thread may be useful.
- Key Press or Write Text does not work on Fedora (outside of the streamdeck itself), which is not particularly useful. However, still do a lot with the Command feature.
- Some users have reported that the Stream Deck device does not work on all on specific USB ports, as it draws quite a bit of power and/or has strict bandwidth requirements. Try a different port.
- If you are executing a shell script from the Command feature - remember to add the shebang at the top of your file, for the language in question.
#!/usr/bin/python3etc. The streamdeck may appear to lock up if you don't under some distros.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for streamdeck_ui-2.0.15-py3-none-any.whl