tuxcast 0.1.0

English · Français

tuxcast finds what will break your stream before you go live, then fixes it. It converts your Elgato Stream Deck profiles, connects the apps Flatpak and snap keep apart, and splits your audio so every source gets its own fader. One command each, no root, no dependencies.

pipx install git+https://github.com/achedon12/tuxcast.git
tuxcast doctor

_{▶ Watch tuxcast in 22 seconds}

Why

Streaming on Linux works well, until it doesn't, and it always breaks in the same places:

• 🎛️ Your Stream Deck. Elgato's app does not exist for Linux, and your 8 pages of keys need rebuilding by hand.
• 🔇 Discord keys that do nothing. Your Stream Deck app is a Flatpak, Discord is a snap, and neither can see the other.
• ⏯️ Media buttons that do nothing either. The Spotify snap ignores remote control.
• 🎚️ One audio mix. You can't keep the music out of your VODs or lower Discord alone.
• 📶 "Unstable bitrate." Twitch blames your connection and your speed test says it's fine (it's the Wi-Fi).

Each of these has a fix buried in a forum thread. tuxcast checks for all of them and applies the fixes.

What it does

Or run it from a control desk

tuxcast ui opens a dashboard on your machine: a tally that tells you whether you can go live, your Stream Deck with its real pages, a mixer with a fader per audio channel, and a button for every fix. Try the live demo, no install needed.

Bring your Stream Deck profiles from Windows

Install

You need Python 3.11 or newer, which every current distribution ships.

pipx install git+https://github.com/achedon12/tuxcast.git

or uv tool install git+https://github.com/achedon12/tuxcast.git, or the installer script (curl -fsSL https://raw.githubusercontent.com/achedon12/tuxcast/main/install.sh | sh). Then start with tuxcast doctor.

Guides

The website (also in the wiki) has a guide for each part of a Linux streaming setup, with the manual steps for people who prefer to do it by hand:

Streaming on Linux in 2026 · OBS on Linux · Stream Deck on Linux · Audio routing · Discord and Spotify in sandboxes · Music without claims · Network

Principles

• Reads before it writes. doctor never changes anything. Other commands say what they wrote, and most take --dry-run.
• Never needs root. Everything happens in your user session. The one privileged step (the udev rule) is printed for you to run.
• Zero dependencies. Python's standard library only, so it installs in seconds and keeps working.
• Explains itself. Every warning says why it matters on stream and how to fix it.

Roadmap

• Doctor, converter, Discord bridge, audio sinks, deck tools, patch keeper
• tuxcast obs: apply encoder presets and multistream outputs to an OBS profile
• More Elgato plugins in convert (soundboard, Spotify, Voicemeeter equivalents)
• A doctor --watch mode to keep in an OBS dock while live
• Packages on PyPI and the AUR

Ideas and votes go to Discussions.

Contributing

Every Linux setup is a little different, so your reports matter as much as code: a doctor check that got your machine wrong, an Elgato action that didn't convert, a guide missing your desktop. See CONTRIBUTING.md. Issues labelled good first issue are a good start; most Elgato mappings are one line.

If tuxcast saved your stream, a ⭐ helps other Linux streamers find it.

License

MIT. tuxcast is not affiliated with Elgato, OBS, Discord, Spotify or Twitch.