trcc-linux 9.7.0__tar.gz → 9.7.1__tar.gz

trcc_linux-9.7.1/.gitignore

@@ -0,0 +1,104 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Build artifacts
+dist/
+build/
+*.egg-info/
+
+# Virtual environment
+.venv/
+env/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+*.code-workspace
+pyrightconfig_strict.json
+
+# AI tooling
+CLAUDE.md
+.claude/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Image editor project files
+*.xcf
+
+# FFmpeg temp
+.video_temp/
+
+# Logs
+*.log
+
+# ──────────────────────────────────────────────
+# Theme & Web archives: .7z files ARE tracked.
+# Extracted dirs are regenerated at runtime via on-demand download.
+# ──────────────────────────────────────────────
+
+# Extracted theme dirs (from theme*.7z archives)
+src/trcc/data/theme*/Theme[1-5]/
+src/trcc/data/theme*/Custom_*/
+src/trcc/data/theme*/[0-9]*/
+src/trcc/data/theme*/Theme.zt
+src/trcc/data/theme*/Theme.dc
+src/trcc/data/theme*/01.png
+
+# Extracted Web dirs (from *.7z and zt*.7z archives)
+src/trcc/data/web/[0-9]*/
+src/trcc/data/web/zt*/[0-9]*/
+src/trcc/data/web/**/*.mp4
+src/trcc/data/web/**/*.png
+
+# Keep all .7z archives tracked
+!src/trcc/data/theme*.7z
+!src/trcc/data/web/*.7z
+
+# Runtime data
+src/trcc/data/web_cache/
+src/trcc/data/themes/
+src/trcc/data/images/
+src/trcc/data/settings.json
+src/trcc/data/ui_*.json
+
+# ──────────────────────────────────────────────
+# Dev / reference files
+# ──────────────────────────────────────────────
+# dev/ is SHARED contributor tooling — track it ALL by default so a new dev
+# script is never silently hidden behind a whitelist.  Ignore ONLY the runtime
+# artifacts the mock writes (dev/.trcc*, bytecode) and each developer's LOCAL
+# fleet config (devices.json — seed it from the committed devices.json.example).
+/dev/.trcc/
+/dev/.trcc-user/
+/dev/__pycache__/
+/dev/devices.json
+/dev_*
+# Dev scripts at root
+/test_*.py
+/probe_*.py
+/*.sh
+!install.sh
+
+# Dev tooling
+tools/
+
+# Large binary docs
+doc/*.pdf
+
+# C# audit docs (reference only, not for distribution)
+doc/audit/

trcc_linux-9.7.1/PKG-INFO

@@ -0,0 +1,473 @@
+Metadata-Version: 2.4
+Name: trcc-linux
+Version: 9.7.1
+Summary: Linux implementation of Thermalright LCD Control Center
+Project-URL: Homepage, https://github.com/Lexonight1/thermalright-trcc-linux
+Project-URL: Documentation, https://github.com/Lexonight1/thermalright-trcc-linux#readme
+Project-URL: Repository, https://github.com/Lexonight1/thermalright-trcc-linux
+Project-URL: Issues, https://github.com/Lexonight1/thermalright-trcc-linux/issues
+Author: TRCC Linux Contributors
+License-Expression: GPL-3.0-or-later
+License-File: LICENSE
+Keywords: cooling,hardware,lcd,monitor,thermalright
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Hardware
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.10
+Requires-Dist: certifi>=2023.7.22
+Requires-Dist: click>=7.0
+Requires-Dist: fastapi>=0.100
+Requires-Dist: libusb-package>=1.0.26.3; sys_platform == 'win32' and python_version < '3.14'
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: pyside6>=6.5.0
+Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: pyudev>=0.24.1; sys_platform == 'linux'
+Requires-Dist: pyusb>=1.2.0
+Requires-Dist: sounddevice>=0.4.6
+Requires-Dist: typer>=0.9.0
+Requires-Dist: tzdata>=2024.1; sys_platform == 'win32'
+Requires-Dist: uvicorn[standard]>=0.20
+Requires-Dist: wmi>=1.5.1; sys_platform == 'win32'
+Provides-Extra: all
+Requires-Dist: dbus-python>=1.3.0; extra == 'all'
+Requires-Dist: hidapi>=0.14.0; extra == 'all'
+Requires-Dist: httpx>=0.24.0; extra == 'all'
+Requires-Dist: nvidia-ml-py>=11.0.0; extra == 'all'
+Requires-Dist: pygobject>=3.42.0; extra == 'all'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'all'
+Requires-Dist: pytest-qt>=4.0.0; extra == 'all'
+Requires-Dist: pytest>=7.0.0; extra == 'all'
+Requires-Dist: qrcode>=7.0; extra == 'all'
+Requires-Dist: ruff>=0.4.0; extra == 'all'
+Requires-Dist: types-qrcode>=7.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: httpx>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-qt>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Requires-Dist: types-qrcode>=7.0; extra == 'dev'
+Provides-Extra: hid
+Requires-Dist: hidapi>=0.14.0; extra == 'hid'
+Provides-Extra: nvidia
+Requires-Dist: nvidia-ml-py>=11.0.0; extra == 'nvidia'
+Provides-Extra: remote
+Requires-Dist: qrcode>=7.0; extra == 'remote'
+Provides-Extra: wayland
+Requires-Dist: dbus-python>=1.3.0; extra == 'wayland'
+Requires-Dist: pygobject>=3.42.0; extra == 'wayland'
+Provides-Extra: windows
+Requires-Dist: pywin32>=306; (sys_platform == 'win32') and extra == 'windows'
+Requires-Dist: wmi>=1.5.1; (sys_platform == 'win32') and extra == 'windows'
+Description-Content-Type: text/markdown
+
+# Intro
+> "I’ll do it while you talk" - Józef Piłsudski, was the founding father of modern Poland
+
+> "Free software is a matter of liberty, not price. To understand the concept, you should think of free as in free speech, not as in free beer." - [Richard Stallman](https://stallman.org/), founder of the [Free Software Foundation](https://www.fsf.org/)
+# TRCC Linux
+> **Looking for testers!** We need **Linux**, **Windows**, **macOS**, and **BSD** testers. If you have a Thermalright LCD or LED device on any platform, grab the latest [release](https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest) and [let us know how it goes](https://github.com/Lexonight1/thermalright-trcc-linux/issues) — run `trcc report` and paste the output in an issue. Every test report helps, even if nothing works yet!
+
+> **Solo hobbyist project** — built in my spare time, one device, no corporate backing. Just a Linux user who got tired of waiting for Thermalright to support us. If something breaks, please be patient — I do this for free because I like helping people. If this project helps you, consider [buying me a beer](https://buymeacoffee.com/Lexonight1) 🍺 or [Ko-fi](https://ko-fi.com/lexonight1) ☕
+
+> **Need help?** [Open a GitHub issue](https://github.com/Lexonight1/thermalright-trcc-linux/issues/new) — that's the only place I see support requests. I don't monitor Reddit, forums, Discord, or Discussions. Run `trcc report` and paste the output so I can actually help you.
+
+[![GitHub Release](https://img.shields.io/github/v/release/Lexonight1/thermalright-trcc-linux?color=green&logo=github)](https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest)
+[![PyPI](https://img.shields.io/pypi/v/trcc-linux)](https://pypi.org/project/trcc-linux/)
+[![GitHub Downloads](https://img.shields.io/github/downloads/Lexonight1/thermalright-trcc-linux/total?color=blue&logo=github&label=downloads)](https://github.com/Lexonight1/thermalright-trcc-linux/releases)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/trcc-linux?label=PyPI%20downloads&color=blue)](https://pypi.org/project/trcc-linux/)
+[![License](https://img.shields.io/badge/license-GPL--3.0-green.svg)](LICENSE)
+[![Platform](https://img.shields.io/badge/platform-Linux-FCC624?logo=linux&logoColor=black)](https://github.com/Lexonight1/thermalright-trcc-linux)
+
+[![CI](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml/badge.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
+[![Tests](https://img.shields.io/badge/tests-6096_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
+[![Coverage](https://img.shields.io/badge/coverage-72%25-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://python.org)
+[![Code Style](https://img.shields.io/badge/code_style-ruff-D7FF64?logo=ruff&logoColor=black)](https://docs.astral.sh/ruff/)
+[![Type Check](https://img.shields.io/badge/type_check-pyright-blue?logo=python&logoColor=white)](https://microsoft.github.io/pyright/)
+
+[![Stars](https://img.shields.io/github/stars/Lexonight1/thermalright-trcc-linux?style=flat&logo=github)](https://github.com/Lexonight1/thermalright-trcc-linux/stargazers)
+[![Forks](https://img.shields.io/github/forks/Lexonight1/thermalright-trcc-linux?style=flat&color=blue&logo=github)](https://github.com/Lexonight1/thermalright-trcc-linux/network/members)
+[![Issues](https://img.shields.io/github/issues/Lexonight1/thermalright-trcc-linux?color=orange&logo=github)](https://github.com/Lexonight1/thermalright-trcc-linux/issues)
+[![Last Commit](https://img.shields.io/github/last-commit/Lexonight1/thermalright-trcc-linux?color=purple&logo=git&logoColor=white)](https://github.com/Lexonight1/thermalright-trcc-linux/commits/main)
+[![Code Size](https://img.shields.io/github/languages/code-size/Lexonight1/thermalright-trcc-linux?color=lightgrey&logo=github)](https://github.com/Lexonight1/thermalright-trcc-linux)
+
+**Packages:**
+
+[![Fedora](https://img.shields.io/badge/Fedora-RPM-51A2DA?logo=fedora&logoColor=white)](https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest)
+[![openSUSE](https://img.shields.io/badge/openSUSE-RPM-73BA25?logo=opensuse&logoColor=white)](https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest)
+
+[![Ubuntu](https://img.shields.io/badge/Ubuntu-DEB-E95420?logo=ubuntu&logoColor=white)](https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest)
+[![Debian](https://img.shields.io/badge/Debian-DEB-A81D33?logo=debian&logoColor=white)](https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest)
+
+[![Arch](https://img.shields.io/badge/Arch-pkg.tar.zst-1793D1?logo=archlinux&logoColor=white)](https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest)
+[![CachyOS](https://img.shields.io/badge/CachyOS-pkg.tar.zst-6B8E23?logo=archlinux&logoColor=white)](https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest)
+[![Manjaro](https://img.shields.io/badge/Manjaro-pkg.tar.zst-35BF5C?logo=manjaro&logoColor=white)](https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest)
+
+[![NixOS](https://img.shields.io/badge/NixOS-flake-5277C3?logo=nixos&logoColor=white)](https://github.com/Lexonight1/thermalright-trcc-linux/blob/main/flake.nix)
+[![Gentoo](https://img.shields.io/badge/Gentoo-ebuild-54487A?logo=gentoo&logoColor=white)](https://github.com/Lexonight1/thermalright-trcc-linux/tree/main/packaging/gentoo)
+
+[![Buy Me a Beer](https://img.shields.io/badge/Buy_Me_a_Beer-🍺-FF5F5F?style=flat)](https://buymeacoffee.com/Lexonight1)
+[![Ko-fi](https://img.shields.io/badge/Ko--fi-☕-FF5E5B?style=flat&logo=kofi&logoColor=white)](https://ko-fi.com/lexonight1)
+
+> Huge thanks to **[@Xentrino](https://github.com/Xentrino)**, **[@javisaman](https://github.com/javisaman)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@Reborn627](https://github.com/Reborn627)**, **[@Mr-Renegade](https://github.com/Mr-Renegade)**, **[@knappstar](https://github.com/knappstar)**, **[@woebygon](https://github.com/woebygon)**, **[@Smokemic](https://github.com/Smokemic)**, **[@chava-byte](https://github.com/chava-byte)**, **[@nihilistqueen](https://github.com/nihilistqueen)**, **[@rhuggins573-crypto](https://github.com/rhuggins573-crypto)**, **[@unfirthman](https://github.com/unfirthman)**, **Glyn**, **dugalex**, and **Dunvcpi** for the beers — you guys are legends.
+
+Native Linux port of the Thermalright LCD Control Center (Windows TRCC 2.1.2). Control and customize the LCD displays and LED segment displays on Thermalright CPU coolers, AIO pump heads, and fan hubs — entirely from Linux.
+
+> **This project wouldn't exist without our testers.** I only own one device. Every supported device in this list works because someone plugged it in, ran `trcc report`, and told me what broke. 32 testers helped us go from "SCSI only" to full C# feature parity with 6 USB protocols, 16 FBL resolutions, and 12 LED styles. Open source at its best — see [Contributors](#contributors) below.
+
+> Unofficial community project, not affiliated with Thermalright. Built with [Claude](https://claude.ai) (AI) for protocol reverse engineering and code generation, guided by human architecture decisions and logical assessment.
+
+## Install
+
+### Native packages (recommended)
+
+Pre-built packages are available for every major distro. No pip, no venv, no PEP 668 headaches — just download and install like any other app. Every release is built automatically from source using [GitHub Actions](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/release.yml) — the build logs are public so anyone can verify what went in.
+
+> For detailed step-by-step instructions, troubleshooting, and alternative install methods, see the **[Install Guide](doc/GUIDE_INSTALL.md)**.
+
+| Distro | Install Guide |
+|--------|--------------|
+| Fedora / Nobara / openSUSE | [Fedora](doc/GUIDE_INSTALL.md#fedora--nobara) |
+| Bazzite / Bluefin / Aurora / Universal Blue | [Immutable Fedora](doc/GUIDE_INSTALL.md#bazzite--aurora--bluefin--fedora-atomic) |
+| Ubuntu 24.04+ / Debian 13+ / Mint 22+ / Pop!_OS / Zorin | [Ubuntu / Debian](doc/GUIDE_INSTALL.md#ubuntu--debian--mint--pop_os--zorin) |
+| Ubuntu 22.04 / Mint 21.x / Debian 12 (older) | [Legacy DEB](doc/GUIDE_INSTALL.md#ubuntu-2204--mint-21x--debian-12-legacy-deb) |
+| Arch / CachyOS / Manjaro / EndeavourOS / Garuda | [Arch](doc/GUIDE_INSTALL.md#arch--cachyos--manjaro--endeavouros--garuda) |
+| NixOS | [NixOS](doc/GUIDE_INSTALL.md#nixos) |
+| Gentoo | [Gentoo](doc/GUIDE_INSTALL.md#gentoo) |
+| SteamOS (Steam Deck) | [SteamOS](doc/GUIDE_INSTALL.md#steamos-steam-deck) |
+| Windows 10/11 | [Windows](doc/GUIDE_INSTALL.md#windows-experimental) |
+| macOS 11+ | [macOS](doc/GUIDE_INSTALL.md#macos-experimental) |
+| FreeBSD | [FreeBSD](doc/GUIDE_INSTALL.md#freebsd-experimental) |
+
+Each guide has a one-liner copy-paste command and step-by-step instructions. After installing, unplug and replug the USB cable, then run `trcc gui`.
+
+### Verify your download
+
+Every release includes a `SHA256SUMS.txt` file. Download it from the same release page, then:
+
+```bash
+cd ~/Downloads
+sha256sum -c SHA256SUMS.txt --ignore-missing
+```
+
+If you see `OK` next to your package — it's clean. Source code is GPL-3.0, fully auditable — no binaries, no obfuscation, no telemetry.
+
+### PyPI
+
+Best option for very old distros (Ubuntu 20.04, Debian 11) or if you prefer Python packaging. For Ubuntu 22.04 / Mint 21.x / Debian 12, the [Legacy DEB](doc/GUIDE_INSTALL.md#ubuntu-2204--mint-21x--debian-12-legacy-deb) is easier.
+
+```bash
+# Install system dependencies first
+sudo apt install pipx libusb-1.0-0 sg3-utils p7zip-full libxcb-cursor0  # Debian/Ubuntu/Mint
+sudo dnf install pipx libusb-1.0.0 sg3_utils p7zip                      # Fedora
+
+# Install trcc-linux
+pipx install trcc-linux
+trcc setup        # interactive wizard — udev rules, desktop entry
+```
+
+Then **unplug and replug the USB cable** and run `trcc gui`.
+
+> `pipx` not installed? `sudo apt install pipx` (Debian/Ubuntu), `sudo dnf install pipx` (Fedora), `sudo pacman -S python-pipx` (Arch). See the **[Install Guide](doc/GUIDE_INSTALL.md)** for your distro.
+
+### Automatic (git clone)
+
+```bash
+git clone https://github.com/Lexonight1/thermalright-trcc-linux.git
+cd thermalright-trcc-linux
+sudo ./install.sh
+```
+
+Detects your distro, installs system packages, Python deps, udev rules, and desktop shortcut.
+
+### Supported distros
+
+Fedora, Nobara, Ubuntu, Debian, Mint, Pop!_OS, Zorin, elementary OS, Arch, Manjaro, EndeavourOS, CachyOS, Garuda, openSUSE, Void, Gentoo, Alpine, NixOS, Bazzite, Aurora, Bluefin, SteamOS (Steam Deck).
+
+> **`trcc: command not found`?** Open a new terminal — pip installs to `~/.local/bin` which needs a new shell session to appear on PATH.
+
+> See the **[Install Guide](doc/GUIDE_INSTALL.md)** for distro-specific instructions and troubleshooting.
+
+### Have an untested device?
+
+Run `trcc report` and [paste the output in an issue](https://github.com/Lexonight1/thermalright-trcc-linux/issues/new) — takes 30 seconds. See the **[full list of devices that need testers](doc/TESTERS_WANTED.md)**.
+
+![TRCC Linux GUI](doc/screenshots/screenshot.png)
+
+## Usage
+
+### GUI
+
+```bash
+trcc gui
+```
+
+Full desktop app with theme browser, video player, overlay editor, LED control panel, and hardware sensor dashboard.
+
+### CLI
+
+```bash
+trcc detect               # Show connected devices
+trcc send image.png       # Send image to LCD
+trcc color "#ff0000"      # Fill LCD with solid color
+trcc video clip.mp4       # Play video on LCD
+trcc screencast           # Live screen capture to LCD
+trcc brightness 2         # Set brightness (1=25%, 2=50%, 3=100%)
+trcc rotation 90          # Rotate display (0/90/180/270)
+trcc theme-list           # List available themes
+trcc theme-load NAME      # Load a theme by name
+trcc overlay              # Render and send overlay
+trcc led-color "#00ff00"  # Set LED color
+trcc led-mode breathing   # Set LED effect mode
+trcc report               # Generate diagnostic report
+trcc doctor               # Check system dependencies
+trcc setup                # Interactive setup wizard
+trcc uninstall            # Remove TRCC completely
+```
+
+See the **[CLI Reference](doc/REFERENCE_CLI.md)** for the full command list.
+
+### REST API
+
+Start the API server and control your devices remotely:
+
+```bash
+trcc serve                    # Start on http://localhost:9876
+trcc serve --port 8080        # Custom port
+trcc serve --tls              # HTTPS with auto-generated self-signed cert
+trcc serve --host 0.0.0.0     # Listen on all interfaces (LAN access)
+```
+
+78 endpoints covering devices, display, LED, themes, and system metrics. Use `trcc api` to list all endpoints.
+
+```bash
+# Examples with curl
+curl http://localhost:9876/devices              # List devices
+curl -X POST http://localhost:9876/display/send \
+  -F "file=@wallpaper.png"                     # Send image
+curl -X POST http://localhost:9876/led/color \
+  -H "Content-Type: application/json" \
+  -d '{"color": "#ff0000"}'                    # Set LED color
+```
+
+### Tips
+
+**Mounting your device vertically?**
+Set the angle to **90°** (or 270°) in the GUI, then open **Cloud Themes** — the browser will automatically show portrait-orientation themes for your device's rotated dimensions. Download and apply one of those for a proper vertical layout. Local themes are landscape-only; portrait layouts come from the cloud theme packs.
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Install Guide](doc/GUIDE_INSTALL.md) | Installation for all major distros |
+| [CLI Reference](doc/REFERENCE_CLI.md) | All CLI commands with options and examples |
+| [User Guide](doc/GUIDE_USER.md) | How to use everything — GUI, themes, overlays, media, LED |
+| [API Reference](doc/REFERENCE_API.md) | All 78 REST API endpoints with request/response models |
+| [Troubleshooting](doc/GUIDE_TROUBLESHOOTING.md) | Common issues and fixes |
+| [New to Linux](doc/GUIDE_NEW_TO_LINUX.md) | Guide for Linux beginners |
+| [Changelog](doc/CHANGELOG.md) | Version history |
+| [Supported Devices](doc/REFERENCE_DEVICES.md) | Full device list with USB IDs and protocols |
+| [Testers Wanted](doc/TESTERS_WANTED.md) | Devices that need hardware validation |
+| [Device Testing Guide](doc/GUIDE_DEVICE_TESTING.md) | How to test and report device compatibility |
+| [Architecture](doc/ARCHITECTURE.md) | Project layout and design |
+| [Technical Reference](doc/REFERENCE_TECHNICAL.md) | SCSI protocol and file formats |
+
+### Protocol documentation (reverse-engineered from Windows TRCC)
+
+| Document | Description |
+|----------|-------------|
+| [Technical Reference](doc/REFERENCE_TECHNICAL.md) | SCSI protocol, FBL detection, PM/SUB mapping |
+| [USBLCDNEW Protocol](doc/PROTOCOL_USBLCDNEW.md) | USB bulk/LY frame transfer protocol |
+| [USBLED Protocol](doc/PROTOCOL_USBLED.md) | HID LED segment display protocol |
+
+## Features
+
+| Category | What you get |
+|----------|-------------|
+| **GUI** | Full PySide6 desktop app — theme browser, video player, overlay editor, LED control panel, 38 languages |
+| **CLI** | `trcc gui`, `trcc send`, `trcc video`, `trcc led-color`, `trcc screencast`, `trcc shell`, and more |
+| **REST API** | 78 endpoints — control everything remotely, build integrations, automate your setup |
+| **Themes** | Local, cloud, and masks — carousel mode, export/import as `.tr` files, custom mask upload with X/Y positioning, 5 starters + 120 masks per resolution |
+| **Media** | Video/GIF playback on LCD, video trimmer, image cropper, screen cast (X11 + Wayland), mic audio visualization |
+| **Overlay Editor** | Text, sensors, date/time overlays — font picker, dynamic scaling, color picker |
+| **Hardware Sensors** | 77+ sensors — CPU/GPU temp, fan speed, power, usage — customizable dashboard |
+| **LED Control** | 12 LED styles, zone carousel, breathing/rainbow/static/wave modes, per-zone color |
+| **Display** | 16 resolutions (240x240 to 1920x462), 0/90/180/270 rotation, 3 brightness levels |
+| **Multi-device** | Per-device config, auto-detect, multi-device with device selection |
+| **Security** | udev rules, polkit policy, SELinux support, no root required after setup |
+
+**Under the hood**: 147 source files, ~49K lines of Python, 5799 tests across 96 test files in 9 directories. Hexagonal architecture with strict dependency injection — GUI, CLI, and API all talk to the same core services. 6 USB protocols reverse-engineered from the Windows C# app.
+
+### What we do better than Windows TRCC
+
+- **38 languages** — Windows has 10 (baked into PNGs). We render text at runtime, community can add more
+- **CLI + REST API** — Windows is GUI-only. We have full CLI and 49 API endpoints for automation
+- **Custom mask upload** — upload your own PNG overlay, position with X/Y controls, saved to `~/.trcc-user/`
+- **No admin required** — udev rules handle permissions. Windows needs "Run as Administrator"
+- **Open source** — read the code, fix bugs, add features. Windows TRCC is closed-source .NET
+- **Screencast on Wayland** — Windows can't do that either
+- **Audio visualization** — mic spectrum analyzer on screencast. Windows doesn't have this
+- **Hexagonal architecture** — GUI, CLI, and API share the same core. No feature lag between interfaces
+
+### 38-Language GUI (i18n)
+
+The Windows TRCC app ships 10 languages by baking translated text into separate PNG background images — 129 PNGs just for panel labels. We replaced all of that with a runtime i18n system: language-neutral background PNGs + QLabel text overlays rendered from `core/i18n.py`. Switching languages updates every label instantly — no restart, no extra files.
+
+**Supported languages:** Simplified Chinese, Traditional Chinese, English, German, Russian, French, Portuguese, Japanese, Spanish, Korean, Italian, Dutch, Polish, Turkish, Arabic, Hindi, Thai, Vietnamese, Indonesian, Czech, Swedish, Danish, Norwegian, Finnish, Hungarian, Romanian, Ukrainian, Greek, Hebrew, Malay, Bengali, Urdu, Farsi, Tagalog, Tamil, Punjabi, Swahili, Burmese
+
+Adding a new language is one dict entry per string in `core/i18n.py` — no PNG editing, no asset pipeline. Community translations welcome.
+
+### Supported Devices
+
+Run `lsusb` to find your USB ID (`xxxx:xxxx` after `ID`), then match it below.
+
+**SCSI devices** — fully supported:
+| USB ID | Devices |
+|--------|---------|
+| `87CD:70DB` | FROZEN HORIZON PRO, FROZEN MAGIC PRO, FROZEN VISION V2, CORE VISION, ELITE VISION, AK120, AX120, PA120 DIGITAL, Wonder Vision |
+| `0416:5406` | LC1, LC2, LC3, LC5 (AIO pump heads) |
+| `0402:3922` | FROZEN WARFRAME, FROZEN WARFRAME 360, FROZEN WARFRAME SE, ELITE VISION 360 |
+
+**Bulk USB devices** — raw USB protocol:
+| USB ID | Devices |
+|--------|---------|
+| `87AD:70DB` | GrandVision 360 AIO, Mjolnir Vision 360, Wonder Vision Pro 360, Frozen Warframe Pro |
+
+**LY USB devices** — chunked bulk protocol:
+| USB ID | Devices |
+|--------|---------|
+| `0416:5408` | Trofeo Vision 9.16 LCD |
+| `0416:5409` | (LY1 variant) |
+
+**HID LCD devices** — auto-detected:
+| USB ID | Devices |
+|--------|---------|
+| `0416:5302` | Trofeo Vision LCD, Assassin Spirit 120 Vision ARGB, AS120 VISION, BA120 VISION, FROZEN WARFRAME, FROZEN WARFRAME 360, FROZEN WARFRAME SE, FROZEN WARFRAME PRO, ELITE VISION, LC5 |
+| `0418:5303` | TARAN ARMS |
+| `0418:5304` | TARAN ARMS |
+
+**HID LED devices** — RGB LED control:
+| USB ID | Devices |
+|--------|---------|
+| `0416:8001` | AX120 DIGITAL, PA120 DIGITAL, Peerless Assassin 120 DIGITAL ARGB White, Assassin X 120R Digital ARGB, Phantom Spirit 120 Digital EVO, HR10 2280 PRO Digital, and others (model auto-detected via handshake) |
+
+> See the [full device list with protocol details](doc/REFERENCE_DEVICES.md) and the [Device Testing Guide](doc/GUIDE_DEVICE_TESTING.md) if you have an untested device.
+
+## Architecture
+
+```text
+src/trcc/
+├── core/           # Models, enums, domain constants — zero I/O
+├── services/       # Business logic — pure Python, no framework deps
+├── adapters/       # USB device protocols (SCSI, HID, Bulk, LY, LED)
+├── ui/
+│   ├── gui/        # PySide6 GUI — themes, video, overlay, LED, sensors
+│   ├── cli/        # Typer CLI — 95 commands across 8 modules
+│   └── api/        # FastAPI REST API — 78 endpoints across 7 modules
+├── _boot.py        # Composition root — returns Trcc or TrccProxy
+├── daemon.py       # Optional singleton daemon mode (TRCC_DAEMON=1)
+├── ipc.py          # Manifold IPC — UI ↔ daemon over Unix socket
+├── conf.py         # Settings singleton
+└── assets/         # GUI images, desktop entry, polkit policy, systemd service
+```
+
+**Hexagonal architecture** — GUI, CLI, and API are interchangeable adapters over the same core services. Adding a new interface (Android app, Home Assistant plugin) means writing a new adapter, not touching business logic.
+
+### Reproducing reporter bugs (contributors)
+
+When a `trcc report` lands on an issue, the harness in `dev/smoke_anything.py` runs every probe — handshake idempotency, video target dims, RAPL discovery, WMI CoInitialize, addr-threading, sleep/resume cycle — through the fully DI'd stack at the reporter's exact OS + device:
+
+```bash
+PYTHONPATH=src python3 dev/smoke_anything.py --from-report report.txt
+PYTHONPATH=src python3 dev/smoke_anything.py --os linux --device 87ad:70db
+PYTHONPATH=src python3 dev/smoke_anything.py --list-probes
+```
+
+If a probe goes `BAD`, that's the bug — fix in `src/`, re-run, see `PASS`. Every reproduced regression becomes a new probe in `PROBES`, so the next reporter with the same root cause gets caught in 30 seconds. Discipline: never reply "try vX.Y.Z" until a probe has actually gone `PASS` against the reporter's environment.
+
+**6 USB protocols** reverse-engineered from the Windows C# app:
+
+| Protocol | Transport | Devices |
+|----------|-----------|---------|
+| SCSI | SG_IO ioctl | Frozen Warframe, Elite Vision, AK/AX120, PA120, LC1-5 |
+| HID Type 2 | pyusb interrupt | Trofeo Vision, Assassin Spirit, AS/BA120, Frozen Warframe SE/PRO |
+| HID Type 3 | pyusb interrupt | TARAN ARMS |
+| Bulk | pyusb bulk | GrandVision 360, Mjolnir Vision 360, Wonder Vision Pro 360, Frozen Warframe Pro |
+| LY | pyusb bulk (chunked) | Trofeo Vision 9.16 LCD |
+| LED | pyusb HID | All LED segment display devices (12 styles) |
+
+## Contributors
+
+A huge thank you to every single person who filed an issue, pasted a `trcc report`, or just said "it doesn't work." You are the reason this project supports 6 USB protocols, 16 resolutions, and 12 LED styles from a single developer with one device. Every bug report, every test on hardware I don't own, every "hey this is broken" — that's open source at its best. You're not wasting your time. You're building something together.
+
+Special thanks to everyone who has contributed invaluable reports to this project:
+
+**Frozen Warframe** — **[gizbo](https://github.com/gizbo)** · **[knappstar](https://github.com/knappstar)** · **[Scifiguygaming](https://github.com/Scifiguygaming)** · **[apj202-ops](https://github.com/apj202-ops)** · **[loosethoughts19-hash](https://github.com/loosethoughts19-hash)** · **[Edoardo-Rossi-EOS](https://github.com/Edoardo-Rossi-EOS)** · **[edoargo1996](https://github.com/edoargo1996)** · **[stephendesmond1-cmd](https://github.com/stephendesmond1-cmd)** · **[riodevelop](https://github.com/riodevelop)** · **[wobbegongus](https://github.com/wobbegongus)** · **[Pallemz](https://github.com/Pallemz)** · **[pawbtism](https://github.com/pawbtism)**
+
+**Trofeo Vision** — **[N8ghtz](https://github.com/N8ghtz)** · **[PantherX12max](https://github.com/PantherX12max)** · **[ravensvoice](https://github.com/ravensvoice)** · **[beret21](https://github.com/beret21)** · **[jimmister1234-bit](https://github.com/jimmister1234-bit)** · **[Tavus1990](https://github.com/Tavus1990)** · **[ImlostinIKEA](https://github.com/ImlostinIKEA)** · **[ronny79privat](https://github.com/ronny79privat)** · **[OptimalKiller](https://github.com/OptimalKiller)**
+
+**GrandVision 360 AIO** — **[bipobuilt](https://github.com/bipobuilt)** · **[cadeon](https://github.com/cadeon)** · **[Reborn627](https://github.com/Reborn627)** · **[TheManchineel](https://github.com/TheManchineel)** · **[ImlostinIKEA](https://github.com/ImlostinIKEA)**
+
+**Assassin Spirit 120 Vision** — **[michael-spinelli](https://github.com/michael-spinelli)** · **[acioannina-wq](https://github.com/acioannina-wq)**
+
+**Assassin X 120R Digital ARGB** — **[hexskrew](https://github.com/hexskrew)** · **[rhuggins573-crypto](https://github.com/rhuggins573-crypto)**
+
+**Peerless Assassin 120 Digital ARGB** — **[Xentrino](https://github.com/Xentrino)** · **[Vydon](https://github.com/Vydon)**
+
+**PA120 Digital** — **[Pewful2021](https://github.com/Pewful2021)** · **[lallemandgianni-boop](https://github.com/lallemandgianni-boop)** · **[mody446](https://github.com/mody446)**
+
+**Phantom Spirit 120 Digital EVO** — **[javisaman](https://github.com/javisaman)** · **[Rizzzolo](https://github.com/Rizzzolo)** · **[chava-byte](https://github.com/chava-byte)**
+
+**Wonder Vision** — **[Civilgrain](https://github.com/Civilgrain)** · **[Alb3e3](https://github.com/Alb3e3)**
+
+**AX120 Digital** — **[shadowepaxeor-glitch](https://github.com/shadowepaxeor-glitch)**
+
+**Elite Vision 360** — **[tensaiteki](https://github.com/tensaiteki)**
+
+**Mjolnir Vision 360** — **[Pikarz](https://github.com/Pikarz)** · **[RonyPony1234](https://github.com/RonyPony1234)**
+
+**Peerless Assassin 140 Digital** — **[MioHorizon](https://github.com/MioHorizon)**
+
+**Peerless Vision** — **[Mr-Renegade](https://github.com/Mr-Renegade)**
+
+**Stream Vision** — **[Me-shok](https://github.com/Me-shok)**
+
+**HR10 2280 PRO Digital** — **[Lcstyle](https://github.com/Lcstyle)**
+
+**macOS** — **[jaminmc](https://github.com/jaminmc)** (Apple Silicon sensor research, PR #114 feedback)
+
+**General** — **[wrightbyname](https://github.com/wrightbyname)** · **[mog199](https://github.com/mog199)** · **[jezzaw007](https://github.com/jezzaw007)** · **[sleeper14200](https://github.com/sleeper14200)** · **[kabi02](https://github.com/kabi02)** · **[david43](https://github.com/david43)** · **[Deltawolf](https://github.com/Deltawolf)** · **[JoshWrites](https://github.com/JoshWrites)** · **[jun3010me](https://github.com/jun3010me)** · **[Litsas](https://github.com/Litsas)** · **[MoltenMonster](https://github.com/MoltenMonster)** · **[ProfessorJoed](https://github.com/ProfessorJoed)** · **[qwerty22121998](https://github.com/qwerty22121998)** · **[unfirthman](https://github.com/unfirthman)** · **[ux370](https://github.com/ux370)** · **[vlad1](https://github.com/vlad1)** · **GlynL**
+
+## Stars
+
+Thanks to everyone who took a moment to star this project.
+
+**[akasvi](https://github.com/akasvi)** · **[alessa-lara](https://github.com/alessa-lara)** · **[alicepolice](https://github.com/alicepolice)** · **[ArcaneCoder404](https://github.com/ArcaneCoder404)** · **[Arty-x-g](https://github.com/Arty-x-g)** · **[azrael1911](https://github.com/azrael1911)** · **[betolink](https://github.com/betolink)** · **[bfesfbsbfesfbn](https://github.com/bfesfbsbfesfbn)** · **[bive242](https://github.com/bive242)** · **[BrunoLeguizamon05](https://github.com/BrunoLeguizamon05)** · **[cancos1](https://github.com/cancos1)** · **[capiazmi](https://github.com/capiazmi)** · **[cesarnr21](https://github.com/cesarnr21)** · **[codeflitting](https://github.com/codeflitting)** · **[curttheg](https://github.com/curttheg)** · **[dabombUSA](https://github.com/dabombUSA)** · **[damachine](https://github.com/damachine)** · **[DasFlogetier](https://github.com/DasFlogetier)** · **[david43](https://github.com/david43)** · **[DavidKirkitadze](https://github.com/DavidKirkitadze)** · **[eap5](https://github.com/eap5)** · **[emaspa](https://github.com/emaspa)** · **[enricomarchesin](https://github.com/enricomarchesin)** · **[falumamx](https://github.com/falumamx)** · **[Gdetrane](https://github.com/Gdetrane)** · **[greaseyjockey](https://github.com/greaseyjockey)** · **[gupsterg](https://github.com/gupsterg)** · **[immenz](https://github.com/immenz)** · **[israelsz](https://github.com/israelsz)** · **[jamespo](https://github.com/jamespo)** · **[jaminmc](https://github.com/jaminmc)** · **[jezzaw007](https://github.com/jezzaw007)** · **[jhlasnik](https://github.com/jhlasnik)** · **[jmo808](https://github.com/jmo808)** · **[Jorann](https://github.com/Jorann)** · **[k1w3l](https://github.com/k1w3l)** · **[knappstar](https://github.com/knappstar)** · **[Langustensorbet](https://github.com/Langustensorbet)** · **[Legendarycentaur](https://github.com/Legendarycentaur)** · **[Leonnaki](https://github.com/Leonnaki)** · **[lotte25](https://github.com/lotte25)** · **[m-marcal](https://github.com/m-marcal)** · **[mgaruccio](https://github.com/mgaruccio)** · **[michelle0812](https://github.com/michelle0812)** · **[mkogut](https://github.com/mkogut)** · **[mrsaraiva](https://github.com/mrsaraiva)** · **[narfel](https://github.com/narfel)** · **[nathanielhernandez](https://github.com/nathanielhernandez)** · **[NostraTiepus](https://github.com/NostraTiepus)** · **[NuiQuant](https://github.com/NuiQuant)** · **[oddajpierscien](https://github.com/oddajpierscien)** · **[okrzanowska](https://github.com/okrzanowska)** · **[PantherX12max](https://github.com/PantherX12max)** · **[Pewful2021](https://github.com/Pewful2021)** · **[Pikarz](https://github.com/Pikarz)** · **[psyrie](https://github.com/psyrie)** · **[qussaif10](https://github.com/qussaif10)** · **[qwerty22121998](https://github.com/qwerty22121998)** · **[Reborn627](https://github.com/Reborn627)** · **[Rehaell](https://github.com/Rehaell)** · **[rhuggins573-crypto](https://github.com/rhuggins573-crypto)** · **[riodevelop](https://github.com/riodevelop)** · **[RolandTaverner](https://github.com/RolandTaverner)** · **[rslater](https://github.com/rslater)** · **[satoru8](https://github.com/satoru8)** · **[saucymcbeef](https://github.com/saucymcbeef)** · **[shadowepaxeor-glitch](https://github.com/shadowepaxeor-glitch)** · **[ShaunnyBwoy](https://github.com/ShaunnyBwoy)** · **[sigizito](https://github.com/sigizito)** · **[Smokemic](https://github.com/Smokemic)** · **[Spebelgenenst](https://github.com/Spebelgenenst)** · **[spiritofjon](https://github.com/spiritofjon)** · **[stephenvalente](https://github.com/stephenvalente)** · **[sudo-st8less](https://github.com/sudo-st8less)** · **[Thymur](https://github.com/Thymur)** · **[TimG-NL](https://github.com/TimG-NL)** · **[Torotin](https://github.com/Torotin)** · **[trizmark](https://github.com/trizmark)** · **[TuxLux40](https://github.com/TuxLux40)** · **[urbnywrt](https://github.com/urbnywrt)** · **[vindocel](https://github.com/vindocel)** · **[Viwyn](https://github.com/Viwyn)** · **[Vydon](https://github.com/Vydon)** · **[Xentrino](https://github.com/Xentrino)** · **[YahusRevus](https://github.com/YahusRevus)** · **[zhanghangt](https://github.com/zhanghangt)** · **[Ziusz](https://github.com/Ziusz)**
+
+## Faulkers
+
+Thanks for carrying the torch — these folks forked the repo to build on it.
+
+**[capiazmi](https://github.com/capiazmi)** · **[dabombUSA](https://github.com/dabombUSA)** · **[danleyb2](https://github.com/danleyb2)** · **[DasFlogetier](https://github.com/DasFlogetier)** · **[elsiedotcafe](https://github.com/elsiedotcafe)** · **[jaminmc](https://github.com/jaminmc)** · **[jemte](https://github.com/jemte)** · **[jezzaw007](https://github.com/jezzaw007)** · **[JoshWrites](https://github.com/JoshWrites)** · **[jwcrowley](https://github.com/jwcrowley)** · **[maniwaroka](https://github.com/maniwaroka)** · **[taillis](https://github.com/taillis)** · **[TuxLux40](https://github.com/TuxLux40)**
+
+## Donations
+
+If this project saved you from keeping a Windows partition around, consider **[buying me a cold one](https://buymeacoffee.com/Lexonight1)**.
+
+## License
+
+[GPL-3.0](https://www.gnu.org/licenses/gpl-3.0.en.html) — free as in freedom. This project is and always will be free software. You can use it, study it, modify it, and share it. That's the deal.
+
+Built on the shoulders of [Richard Stallman](https://stallman.org/), the [GNU Project](https://www.gnu.org/gnu/thegnuproject.en.html), and the [Free Software Foundation](https://www.fsf.org/). If you care about software freedom, [read why it matters](https://www.gnu.org/philosophy/free-sw.en.html).