tuxcast 0.1.0__tar.gz

tuxcast-0.1.0/.gitignore

@@ -0,0 +1,21 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+build/
+dist/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Docs
+site/
+
+# Editors
+.idea/
+.vscode/
+*.swp
+wiki/
+docs/demo/

tuxcast-0.1.0/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to tuxcast are listed here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and tuxcast uses
+[semantic versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-10-08
+
+The first release: the problems every Linux streamer hits, each solved by one command.
+
+### Added
+
+- `tuxcast ui` opens a control desk for everything below: a go-live tally, the Stream Deck with
+  StreamController's real pages and a key-by-key preview of dropped Elgato profiles, the doctor's
+  checks with one-click fixes, an audio mixer with faders, mute and drag-and-drop app routing, the
+  Discord bridge and patches. It listens on 127.0.0.1 only and requires the token it prints. The
+  website has a live demo of it.
+- `tuxcast doctor` checks a streaming setup in eight areas (display server, audio, GPU
+  encoding, OBS, Stream Deck, Discord, Spotify, network) and prints the fix for each
+  problem. `--json` for scripts, `--only` to focus on some areas.
+- `tuxcast convert` turns Elgato Stream Deck profiles (`.streamDeckProfile`, backups and
+  `.sdProfile` folders, versions 1 and 2) into StreamController pages: images, titles,
+  folders, multi actions, hotkeys translated for AZERTY and QWERTZ keyboards, OBS,
+  Discord and Twitch actions. A report lists the keys to redo by hand.
+- `tuxcast bridge discord` exposes Discord's IPC socket installed as a snap, Vesktop or a
+  native package to Flatpak clients such as StreamController, with an optional login service.
+- `tuxcast audio` creates separate PipeWire sinks (game, music, voice, alerts) and routes
+  apps to them, so each part of the mix is its own OBS source.
+- `tuxcast deck` lists Stream Decks, prints the udev rule they need, and resets a deck stuck
+  after a crash without unplugging it.
+- `tuxcast patch` re-applies local edits that app updates wipe, through a systemd path unit.
+
+[Unreleased]: https://github.com/achedon12/tuxcast/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/achedon12/tuxcast/releases/tag/v0.1.0

tuxcast-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 achedon12
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tuxcast-0.1.0/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.5
+Name: tuxcast
+Version: 0.1.0
+Summary: The toolkit for streaming on Linux: diagnose your setup, convert Elgato Stream Deck profiles, bridge sandboxed apps and split your audio.
+Project-URL: Homepage, https://achedon12.github.io/tuxcast/
+Project-URL: Documentation, https://achedon12.github.io/tuxcast/
+Project-URL: Repository, https://github.com/achedon12/tuxcast
+Project-URL: Issues, https://github.com/achedon12/tuxcast/issues
+Project-URL: Changelog, https://github.com/achedon12/tuxcast/blob/main/CHANGELOG.md
+Author: achedon12
+License-Expression: MIT
+License-File: LICENSE
+Keywords: discord,flatpak,linux,obs,pipewire,stream-deck,streamcontroller,streaming,twitch
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia :: Video :: Capture
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src=".github/assets/banner.svg" alt="tuxcast: the toolkit for streaming on Linux" width="100%">
+</p>
+
+<p align="center">
+  <a href="https://github.com/achedon12/tuxcast/actions/workflows/ci.yml"><img src="https://github.com/achedon12/tuxcast/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://github.com/achedon12/tuxcast/releases"><img src="https://img.shields.io/github/v/release/achedon12/tuxcast?color=8b5cf6&label=release" alt="Latest release"></a>
+  <img src="https://img.shields.io/badge/python-3.11%2B-3776ab" alt="Python 3.11+">
+  <img src="https://img.shields.io/badge/dependencies-0-22c55e" alt="Zero dependencies">
+  <img src="https://img.shields.io/badge/root-not%20needed-22c55e" alt="No root needed">
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/achedon12/tuxcast?color=blue" alt="MIT license"></a>
+  <a href="https://achedon12.github.io/tuxcast/"><img src="https://img.shields.io/badge/docs-website-8b5cf6" alt="Documentation"></a>
+</p>
+
+<p align="center">
+  <b>English</b> · <a href="README.fr.md">Français</a>
+</p>
+
+**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.
+
+```sh
+pipx install git+https://github.com/achedon12/tuxcast.git
+tuxcast doctor
+```
+
+<p align="center">
+  <a href="https://achedon12.github.io/tuxcast/#intro">
+    <img src=".github/assets/intro-poster.jpg" alt="Watch tuxcast in 22 seconds" width="720"><br>
+    <sub>▶ Watch tuxcast in 22 seconds</sub>
+  </a>
+</p>
+
+<p align="center">
+  <img src=".github/assets/terminal-doctor.svg" alt="tuxcast doctor checking a Stream Deck, Discord, Spotify and the network" width="820">
+</p>
+
+## 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
+
+| Command | |
+| --- | --- |
+| [`tuxcast ui`](https://achedon12.github.io/tuxcast/commands/ui/) | Opens a control desk for everything below: a go-live tally, your Stream Deck and its pages, a mixer with faders, one-click fixes ([live demo](https://achedon12.github.io/tuxcast/demo/index.html)) |
+| [`tuxcast doctor`](https://achedon12.github.io/tuxcast/commands/doctor/) | Checks display server, audio, GPU encoder, OBS, Stream Deck, Discord, Spotify and network. Each problem comes with its fix |
+| [`tuxcast convert`](https://achedon12.github.io/tuxcast/commands/convert/) | Turns Elgato `.streamDeckProfile` exports into [StreamController](https://streamcontroller.core447.com/) pages: images, folders, multi actions, hotkeys (AZERTY and QWERTZ aware), OBS, Discord and Twitch keys |
+| [`tuxcast bridge discord`](https://achedon12.github.io/tuxcast/commands/bridge/) | Exposes Discord's socket (snap, Vesktop, native) to Flatpak clients, and recreates the bridge at every login |
+| [`tuxcast audio`](https://achedon12.github.io/tuxcast/commands/audio/) | Separate PipeWire sinks for game, music, voice and alerts, and routes apps to them |
+| [`tuxcast deck`](https://achedon12.github.io/tuxcast/commands/deck/) | Lists Stream Decks, prints the udev rule they need, and resets one that froze after a crash, without unplugging it |
+| [`tuxcast patch`](https://achedon12.github.io/tuxcast/commands/patch/) | Re-applies the fixes you made to app files every time an update wipes them |
+
+### 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](https://achedon12.github.io/tuxcast/demo/index.html), no install needed.
+
+<p align="center">
+  <a href="https://achedon12.github.io/tuxcast/demo/index.html">
+    <img src="docs/assets/ui-desk.png" alt="The tuxcast dashboard: the tally, a Stream Deck with its pages, the checks and the audio mixer" width="900">
+  </a>
+</p>
+
+### Bring your Stream Deck profiles from Windows
+
+<p align="center">
+  <img src=".github/assets/terminal-convert.svg" alt="tuxcast convert turning an Elgato profile into StreamController pages" width="760">
+</p>
+
+## Install
+
+You need Python 3.11 or newer, which every current distribution ships.
+
+```sh
+pipx install git+https://github.com/achedon12/tuxcast.git
+```
+
+or `uv tool install git+https://github.com/achedon12/tuxcast.git`, or the
+[installer script](install.sh) (`curl -fsSL https://raw.githubusercontent.com/achedon12/tuxcast/main/install.sh | sh`).
+Then start with `tuxcast doctor`.
+
+## Guides
+
+The [website](https://achedon12.github.io/tuxcast/) (also in the [wiki](https://github.com/achedon12/tuxcast/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](https://achedon12.github.io/tuxcast/guides/streaming-on-linux/) ·
+[OBS on Linux](https://achedon12.github.io/tuxcast/guides/obs/) ·
+[Stream Deck on Linux](https://achedon12.github.io/tuxcast/guides/stream-deck/) ·
+[Audio routing](https://achedon12.github.io/tuxcast/guides/audio/) ·
+[Discord and Spotify in sandboxes](https://achedon12.github.io/tuxcast/guides/sandboxes/) ·
+[Music without claims](https://achedon12.github.io/tuxcast/guides/music/) ·
+[Network](https://achedon12.github.io/tuxcast/guides/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
+
+- [x] 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](https://github.com/achedon12/tuxcast/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](CONTRIBUTING.md). Issues labelled
+[good first issue](https://github.com/achedon12/tuxcast/labels/good%20first%20issue) are a
+good start; most Elgato mappings are one line.
+
+If tuxcast saved your stream, a ⭐ helps other Linux streamers find it.
+
+## License
+
+[MIT](LICENSE). tuxcast is not affiliated with Elgato, OBS, Discord, Spotify or Twitch.

tuxcast-0.1.0/README.md

@@ -0,0 +1,136 @@
+<p align="center">
+  <img src=".github/assets/banner.svg" alt="tuxcast: the toolkit for streaming on Linux" width="100%">
+</p>
+
+<p align="center">
+  <a href="https://github.com/achedon12/tuxcast/actions/workflows/ci.yml"><img src="https://github.com/achedon12/tuxcast/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://github.com/achedon12/tuxcast/releases"><img src="https://img.shields.io/github/v/release/achedon12/tuxcast?color=8b5cf6&label=release" alt="Latest release"></a>
+  <img src="https://img.shields.io/badge/python-3.11%2B-3776ab" alt="Python 3.11+">
+  <img src="https://img.shields.io/badge/dependencies-0-22c55e" alt="Zero dependencies">
+  <img src="https://img.shields.io/badge/root-not%20needed-22c55e" alt="No root needed">
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/achedon12/tuxcast?color=blue" alt="MIT license"></a>
+  <a href="https://achedon12.github.io/tuxcast/"><img src="https://img.shields.io/badge/docs-website-8b5cf6" alt="Documentation"></a>
+</p>
+
+<p align="center">
+  <b>English</b> · <a href="README.fr.md">Français</a>
+</p>
+
+**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.
+
+```sh
+pipx install git+https://github.com/achedon12/tuxcast.git
+tuxcast doctor
+```
+
+<p align="center">
+  <a href="https://achedon12.github.io/tuxcast/#intro">
+    <img src=".github/assets/intro-poster.jpg" alt="Watch tuxcast in 22 seconds" width="720"><br>
+    <sub>▶ Watch tuxcast in 22 seconds</sub>
+  </a>
+</p>
+
+<p align="center">
+  <img src=".github/assets/terminal-doctor.svg" alt="tuxcast doctor checking a Stream Deck, Discord, Spotify and the network" width="820">
+</p>
+
+## 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
+
+| Command | |
+| --- | --- |
+| [`tuxcast ui`](https://achedon12.github.io/tuxcast/commands/ui/) | Opens a control desk for everything below: a go-live tally, your Stream Deck and its pages, a mixer with faders, one-click fixes ([live demo](https://achedon12.github.io/tuxcast/demo/index.html)) |
+| [`tuxcast doctor`](https://achedon12.github.io/tuxcast/commands/doctor/) | Checks display server, audio, GPU encoder, OBS, Stream Deck, Discord, Spotify and network. Each problem comes with its fix |
+| [`tuxcast convert`](https://achedon12.github.io/tuxcast/commands/convert/) | Turns Elgato `.streamDeckProfile` exports into [StreamController](https://streamcontroller.core447.com/) pages: images, folders, multi actions, hotkeys (AZERTY and QWERTZ aware), OBS, Discord and Twitch keys |
+| [`tuxcast bridge discord`](https://achedon12.github.io/tuxcast/commands/bridge/) | Exposes Discord's socket (snap, Vesktop, native) to Flatpak clients, and recreates the bridge at every login |
+| [`tuxcast audio`](https://achedon12.github.io/tuxcast/commands/audio/) | Separate PipeWire sinks for game, music, voice and alerts, and routes apps to them |
+| [`tuxcast deck`](https://achedon12.github.io/tuxcast/commands/deck/) | Lists Stream Decks, prints the udev rule they need, and resets one that froze after a crash, without unplugging it |
+| [`tuxcast patch`](https://achedon12.github.io/tuxcast/commands/patch/) | Re-applies the fixes you made to app files every time an update wipes them |
+
+### 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](https://achedon12.github.io/tuxcast/demo/index.html), no install needed.
+
+<p align="center">
+  <a href="https://achedon12.github.io/tuxcast/demo/index.html">
+    <img src="docs/assets/ui-desk.png" alt="The tuxcast dashboard: the tally, a Stream Deck with its pages, the checks and the audio mixer" width="900">
+  </a>
+</p>
+
+### Bring your Stream Deck profiles from Windows
+
+<p align="center">
+  <img src=".github/assets/terminal-convert.svg" alt="tuxcast convert turning an Elgato profile into StreamController pages" width="760">
+</p>
+
+## Install
+
+You need Python 3.11 or newer, which every current distribution ships.
+
+```sh
+pipx install git+https://github.com/achedon12/tuxcast.git
+```
+
+or `uv tool install git+https://github.com/achedon12/tuxcast.git`, or the
+[installer script](install.sh) (`curl -fsSL https://raw.githubusercontent.com/achedon12/tuxcast/main/install.sh | sh`).
+Then start with `tuxcast doctor`.
+
+## Guides
+
+The [website](https://achedon12.github.io/tuxcast/) (also in the [wiki](https://github.com/achedon12/tuxcast/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](https://achedon12.github.io/tuxcast/guides/streaming-on-linux/) ·
+[OBS on Linux](https://achedon12.github.io/tuxcast/guides/obs/) ·
+[Stream Deck on Linux](https://achedon12.github.io/tuxcast/guides/stream-deck/) ·
+[Audio routing](https://achedon12.github.io/tuxcast/guides/audio/) ·
+[Discord and Spotify in sandboxes](https://achedon12.github.io/tuxcast/guides/sandboxes/) ·
+[Music without claims](https://achedon12.github.io/tuxcast/guides/music/) ·
+[Network](https://achedon12.github.io/tuxcast/guides/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
+
+- [x] 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](https://github.com/achedon12/tuxcast/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](CONTRIBUTING.md). Issues labelled
+[good first issue](https://github.com/achedon12/tuxcast/labels/good%20first%20issue) are a
+good start; most Elgato mappings are one line.
+
+If tuxcast saved your stream, a ⭐ helps other Linux streamers find it.
+
+## License
+
+[MIT](LICENSE). tuxcast is not affiliated with Elgato, OBS, Discord, Spotify or Twitch.

tuxcast-0.1.0/contrib/README.md

@@ -0,0 +1,11 @@
+# contrib
+
+Ready-made files for tuxcast and for people who prefer to set things up by hand.
+
+| File | What it is |
+| --- | --- |
+| [`patches/twitch-oauth-port.toml`](patches/twitch-oauth-port.toml) | A [`tuxcast patch`](https://achedon12.github.io/tuxcast/commands/patch/) moving StreamController's Twitch login off port 3000 |
+| [`udev/70-streamdeck.rules`](udev/70-streamdeck.rules) | The udev rule giving your user access to Elgato devices |
+
+Have a patch that fixes an app for everyone? Add it here with a comment explaining why, and
+open a pull request.

tuxcast-0.1.0/contrib/patches/twitch-oauth-port.toml

@@ -0,0 +1,18 @@
+# StreamController's Twitch plugin listens on port 3000 for its OAuth login, which clashes with
+# local web dev servers (Next.js, Vite, Rails…). This moves it to 6948.
+#
+# Install:  cp twitch-oauth-port.toml ~/.config/tuxcast/patches/ && tuxcast patch install
+# The plugin's Twitch application must allow the new redirect URI: http://localhost:6948/auth
+
+file = "~/.var/app/com.core447.StreamController/data/plugins/com_imdevinc_StreamControllerTwitchPlugin/constants.py"
+
+# Plugin updates delete and recreate the plugin folder, so watch its parent.
+watch = "~/.var/app/com.core447.StreamController/data/plugins"
+
+[[replace]]
+pattern = '^OAUTH_PORT = \d+$'
+with = "OAUTH_PORT = 6948"
+
+[[replace]]
+pattern = '^OAUTH_REDIRECT_URI = "http://localhost:\d+/auth"$'
+with = 'OAUTH_REDIRECT_URI = "http://localhost:6948/auth"'

tuxcast-0.1.0/contrib/udev/70-streamdeck.rules

@@ -0,0 +1,6 @@
+# Elgato Stream Deck: let the logged-in user talk to the device.
+# Same rule as `tuxcast deck udev`. Install:
+#   sudo cp 70-streamdeck.rules /etc/udev/rules.d/
+#   sudo udevadm control --reload && sudo udevadm trigger
+SUBSYSTEM=="usb", ATTRS{idVendor}=="0fd9", TAG+="uaccess"
+KERNEL=="hidraw*", ATTRS{idVendor}=="0fd9", TAG+="uaccess"

tuxcast-0.1.0/pyproject.toml

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tuxcast"
+dynamic = ["version"]
+description = "The toolkit for streaming on Linux: diagnose your setup, convert Elgato Stream Deck profiles, bridge sandboxed apps and split your audio."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+authors = [{ name = "achedon12" }]
+keywords = ["linux", "streaming", "obs", "stream-deck", "streamcontroller", "twitch", "pipewire", "discord", "flatpak"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Multimedia :: Video :: Capture",
+    "Topic :: Utilities",
+]
+# No runtime dependencies on purpose: tuxcast must install anywhere with pipx in seconds.
+dependencies = []
+
+[project.urls]
+Homepage = "https://achedon12.github.io/tuxcast/"
+Documentation = "https://achedon12.github.io/tuxcast/"
+Repository = "https://github.com/achedon12/tuxcast"
+Issues = "https://github.com/achedon12/tuxcast/issues"
+Changelog = "https://github.com/achedon12/tuxcast/blob/main/CHANGELOG.md"
+
+[project.scripts]
+tuxcast = "tuxcast.cli:main"
+
+[tool.hatch.version]
+path = "src/tuxcast/__init__.py"
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "contrib", "README.md", "CHANGELOG.md", "LICENSE"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra"
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "UP", "SIM", "RUF", "PTH", "PL"]
+ignore = [
+    "PLR0911", "PLR0912", "PLR0913", "PLR0915", "PLR0917", "PLR2004", "PLW0603",
+    "PLC0415",  # lazy imports keep `tuxcast --help` fast and register doctor checks on demand
+    "RUF001",   # the CLI prints symbols such as ✔ on purpose
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["PLR2004", "PLC0415"]
+".github/scripts/render-terminal.py" = ["E501"]  # the SVG template reads best unwrapped

tuxcast-0.1.0/src/tuxcast/__init__.py

@@ -0,0 +1,3 @@
+"""tuxcast: the toolkit for streaming on Linux."""
+
+__version__ = "0.1.0"

tuxcast-0.1.0/src/tuxcast/__main__.py

@@ -0,0 +1,3 @@
+from tuxcast.cli import main
+
+raise SystemExit(main())