This project is under active development

[Lexonight1]

TRCC Linux is under active development. This means:

• Documentation (README, Install Guide, etc.) may change at any time
• Features may be added, modified, or reorganized between releases
• CLI commands and their output format may change
• Config file format may evolve (migrations will be handled where possible)
• Branch structure: main is the primary development branch, stable tracks tested releases, and feature branches (like hid-protocol-testing) may be rebased

What's stable

• SCSI device support (VID:PID 87CD:70DB, 0416:5406, 0402:3922)
• Core GUI functionality (themes, overlays, video, masks, carousel)
• CLI commands (detect, send, setup-udev, gui)
• Per-device configuration persistence

What's in progress

• HID device support (hid-protocol-testing branch — needs real hardware testers)
• Linting / formatting (ruff)
• Packaging for PyPI / wheel distribution

Reporting issues

If something breaks or changes unexpectedly:

1. git pull to make sure you're on the latest
2. Check the CHANGELOG for recent changes
3. Open an issue with your distro, kernel version, and trcc detect --all output

This issue will be closed when TRCC reaches a 2.0 stable release.

[Lexonight1]

Moved to a living doc: doc/DEVELOPMENT_STATUS.md

A doc is easier to keep current than an issue with stacking comments. The new page covers what's stable, HID testing progress, and the roadmap.

[Lexonight1]

v1.2.0 Status Update

Major packaging fix shipped — pip install . now produces a working wheel with all GUI assets (~188MB). Previously the wheel was ~239KB and missing all images/fonts/theme data.

What's changed since the original post

Now stable:

• Linting (ruff E/F/W/I rules enforced, 0 violations)
• Packaging — pip install . works end-to-end, assets included in wheel
• HID device auto-detection (no --testing-hid flag needed)
• Autostart on login (trcc --last-one)
• Reference theme save (config.json with path references)
• 1836 tests, 96% coverage on non-Qt backend

Still in progress:

• HID hardware testing (need real device feedback on hid-protocol-testing branch)
• PyPI publish
• Type annotation hardening (pyright basic → strict on key modules)

[Lexonight1]

v2.0.1 Status Update

The project has matured significantly since the last update here.

Current state:

• v2.0.1 released on PyPI and GitHub
• 2105 tests, ruff + pyright clean, CI on every push
• Auto-publish: tag push triggers GitHub Release + PyPI publish automatically
• 4 protocols supported: SCSI, HID, Bulk, LED — all auto-detected
• 45/49 Windows features ported (4 remaining are hidden/unreleased in Windows)
• 15 LCD resolutions supported (240x240 through 1920x462)
• On-demand download: theme/preview/mask archives fetched from GitHub at runtime — wheel is lightweight

No longer in progress:

• PyPI publish — automated via OIDC trusted publishing
• HID auto-detection — stable since v1.2.9
• Type annotations — pyright clean across all modules

Active work:

• User device testing (8 open issues, mostly awaiting retest on v2.0.1)
• SELinux compatibility audit

[Lexonight1]

v8.2.5 Status Update

The project has reached production-grade hexagonal/SOLID architecture.

Current state:

• v8.2.5 released on PyPI and GitHub
• 4660 tests across 57+ files in 9 hexagonal directories, ruff + pyright clean
• Hexagonal architecture: strict DI, all service constructors enforce deps, composition roots wire adapters
• 5 protocols: SCSI, HID, Bulk, LY, LED — all auto-detected
• 15+ LCD resolutions supported (240x240 through 1920x462)
• 43 REST API endpoints + WebSocket live preview
• 3 adapters: CLI (Typer), GUI (PySide6), API (FastAPI)
• CPU usage: 6% baseline (down from 34% at v7.x)
• SRP complete: largest monolith (uc_theme_setting.py, 1563 lines) split into 5 focused modules
• Packaging: Arch (.pkg.tar.zst), Fedora (.rpm), Debian (.deb), pip/pipx — all automated via CI

No longer in progress:

• Everything from v2.0.1's "active work" list is resolved
• Architecture debt is zero — no pending refactors, no lint warnings, no type errors

---

If this project helps you, consider buying me a beer 🍺 or Ko-fi ☕