trcc-linux 9.8.3__tar.gz → 9.8.4__tar.gz

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/.gitignore

@@ -87,6 +87,13 @@ src/trcc/data/ui_*.json
 /dev/.trcc-user/
 /dev/__pycache__/
 /dev/devices.json
+# decompile-miner: track the tool SOURCE, never its inputs/outputs — Windows
+# TRCC binaries are copyrighted (never commit an .exe/.dll), and Ghidra dumps +
+# mined tables are large, derived artifacts.
+/dev/decompiler/**/*.exe
+/dev/decompiler/**/*.dll
+/dev/decompiler/ghidra_projects/
+/dev/decompiler/out/
 /dev_*
 # Dev scripts at root
 /test_*.py

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trcc-linux
-Version: 9.8.3
+Version: 9.8.4
 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
@@ -120,7 +120,9 @@ Description-Content-Type: text/markdown
 [![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**, **Dunvcpi**, **RichardK**, and **Rick** for the beers — you guys are legends.
+> 💛 **Monthly backer: [@Reborn627](https://github.com/Reborn627)** — four straight months of recurring support. Steady backing like that is what actually keeps a one-person project alive. Thank you.
+
+> Huge thanks to **[@Xentrino](https://github.com/Xentrino)**, **[@javisaman](https://github.com/javisaman)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@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)**, **[@Milrite](https://github.com/Milrite)**, **[@BAS-HARBERS](https://github.com/BAS-HARBERS)**, **Glyn**, **dugalex**, **Dunvcpi**, **RichardK**, **Ryan**, **Rick**, and an anonymous supporter for the beers — you're all 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.
 
@@ -219,25 +221,25 @@ Full desktop app with theme browser, video player, overlay editor, LED control p
 
 ### CLI
 
+Device commands take your device **key** (its `VID:PID`, from `trcc detect`) as the first argument — e.g. `0402:3922`:
+
 ```bash
-trcc detect               # Show connected devices
-trcc send image.png       # Send image to LCD
-trcc display 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 system setup                # Interactive setup wizard
-trcc uninstall            # Remove TRCC completely
+trcc detect                                     # Show connected devices + their keys
+trcc display send-image 0402:3922 image.png     # Send an image to the LCD
+trcc display color 0402:3922 "#ff0000"          # Fill the LCD with a solid color
+trcc display load-video 0402:3922 clip.mp4      # Play a video on the LCD
+trcc display screencast 0402:3922               # Live screen capture to the LCD
+trcc display set-brightness 0402:3922 80        # Brightness (0–100%)
+trcc display set-orientation 0402:3922 90       # Rotate display (0/90/180/270)
+trcc led color 0416:8001 "#00ff00"              # Set LED color
+trcc led mode 0416:8001 breathing               # Set LED effect mode
+trcc report                                     # Generate diagnostic report
+trcc doctor                                     # Check system dependencies
+trcc system setup                               # Interactive setup wizard
 ```
 
+> **Command groups:** LCD actions live under `trcc display …`, LED under `trcc led …`, themes under `trcc theme …`; diagnostics (`report`, `detect`, `doctor`, `sensors`) are top-level; OS setup under `trcc system …`. Run `trcc --help` or `trcc display --help` to explore, and see the **[CLI Guide](doc/GUIDE_CLI.md)** for the full walkthrough.
+
 See the **[CLI Reference](doc/REFERENCE_CLI.md)** for the full command list.
 
 ### REST API
@@ -282,7 +284,7 @@ Set the angle to **90°** (or 270°) in the GUI, then open **Cloud Themes** —
 | [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 |
+| [Architecture Guide](doc/GUIDE_ARCHITECTURE.md) | Project layout, hexagonal design, and the unified UI presentation layer |
 | [Technical Reference](doc/REFERENCE_TECHNICAL.md) | SCSI protocol and file formats |
 
 ### Protocol documentation (reverse-engineered from Windows TRCC)
@@ -409,6 +411,15 @@ If a probe goes `BAD`, that's the bug — fix in `src/`, re-run, see `PASS`. Eve
 | LY | pyusb bulk (chunked) | Trofeo Vision 9.16 LCD |
 | LED | pyusb HID | All LED segment display devices (12 styles) |
 
+## Code Contributors
+
+These folks didn't just report a problem — they opened the editor and sent a fix. On a solo project, a merged pull request is about the most generous thing you can do, and every one of these shipped to every user:
+
+- **[@Hythera](https://github.com/Hythera)** — [#209](https://github.com/Lexonight1/thermalright-trcc-linux/pull/209): had the flake read its version straight from `pyproject.toml`, killing an entire place I used to have to bump by hand every release.
+- **[@elsiedotcafe](https://github.com/elsiedotcafe)** — [#123](https://github.com/Lexonight1/thermalright-trcc-linux/pull/123): pinned the PySide6 package to a stable source so the build stops breaking.
+
+Thank you both — genuinely. PRs are always welcome, and you'll land right here.
+
 ## 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.
@@ -459,11 +470,11 @@ Every name here took the time to open an issue and say "hey, this isn't working
 
 ## Stars
 
-Thanks to everyone who took a moment to star this project.
+Every single star is a small vote of confidence that this is worth keeping alive — and on the days the bugs are winning, watching that count tick up genuinely keeps me going. It costs you one click and it means more than you'd think. Thank you to all 120+ of you:
 
 **[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)** · **[audacieuxnumber1](https://github.com/audacieuxnumber1)** · **[azrael1911](https://github.com/azrael1911)** · **[bbrriiaann97](https://github.com/bbrriiaann97)** · **[behold81](https://github.com/behold81)** · **[betolink](https://github.com/betolink)** · **[bfesfbsbfesfbn](https://github.com/bfesfbsbfesfbn)** · **[bive242](https://github.com/bive242)** · **[brook-cheng](https://github.com/brook-cheng)** · **[BrunoLeguizamon05](https://github.com/BrunoLeguizamon05)** · **[cancos1](https://github.com/cancos1)** · **[capiazmi](https://github.com/capiazmi)** · **[cdh407](https://github.com/cdh407)** · **[cesarnr21](https://github.com/cesarnr21)** · **[chirox](https://github.com/chirox)** · **[codeflitting](https://github.com/codeflitting)** · **[CT-Actual](https://github.com/CT-Actual)** · **[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)** · **[Dezinger](https://github.com/Dezinger)** · **[Dezuvo](https://github.com/Dezuvo)** · **[eap5](https://github.com/eap5)** · **[eduu-dudu](https://github.com/eduu-dudu)** · **[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)** · **[guowc](https://github.com/guowc)** · **[gupsterg](https://github.com/gupsterg)** · **[huzky-v](https://github.com/huzky-v)** · **[hydrogen2005](https://github.com/hydrogen2005)** · **[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)** · **[JuanVargas](https://github.com/JuanVargas)** · **[JyeroRayguster404](https://github.com/JyeroRayguster404)** · **[k1w3l](https://github.com/k1w3l)** · **[KawalChlopa](https://github.com/KawalChlopa)** · **[kazhala](https://github.com/kazhala)** · **[knappstar](https://github.com/knappstar)** · **[kyle-tracy](https://github.com/kyle-tracy)** · **[Langustensorbet](https://github.com/Langustensorbet)** · **[Legendarycentaur](https://github.com/Legendarycentaur)** · **[Leonnaki](https://github.com/Leonnaki)** · **[Lfatua](https://github.com/Lfatua)** · **[llauer](https://github.com/llauer)** · **[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)** · **[monkky](https://github.com/monkky)** · **[mrsaraiva](https://github.com/mrsaraiva)** · **[N1sona](https://github.com/N1sona)** · **[narfel](https://github.com/narfel)** · **[nathanielhernandez](https://github.com/nathanielhernandez)** · **[nedimlisica](https://github.com/nedimlisica)** · **[nookpp](https://github.com/nookpp)** · **[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)** · **[reinierjh](https://github.com/reinierjh)** · **[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)** · **[SunnyZorya23](https://github.com/SunnyZorya23)** · **[the-black-eagle](https://github.com/the-black-eagle)** · **[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)** · **[wernerzsolt](https://github.com/wernerzsolt)** · **[Xentrino](https://github.com/Xentrino)** · **[YahusRevus](https://github.com/YahusRevus)** · **[zhanghangt](https://github.com/zhanghangt)** · **[Ziusz](https://github.com/Ziusz)**
 
-## Faulkers
+## Forkers
 
 Thanks for carrying the torch — these folks forked the repo to build on it.
 

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/README.md

@@ -47,7 +47,9 @@
 [![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**, **Dunvcpi**, **RichardK**, and **Rick** for the beers — you guys are legends.
+> 💛 **Monthly backer: [@Reborn627](https://github.com/Reborn627)** — four straight months of recurring support. Steady backing like that is what actually keeps a one-person project alive. Thank you.
+
+> Huge thanks to **[@Xentrino](https://github.com/Xentrino)**, **[@javisaman](https://github.com/javisaman)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@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)**, **[@Milrite](https://github.com/Milrite)**, **[@BAS-HARBERS](https://github.com/BAS-HARBERS)**, **Glyn**, **dugalex**, **Dunvcpi**, **RichardK**, **Ryan**, **Rick**, and an anonymous supporter for the beers — you're all 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.
 
@@ -146,25 +148,25 @@ Full desktop app with theme browser, video player, overlay editor, LED control p
 
 ### CLI
 
+Device commands take your device **key** (its `VID:PID`, from `trcc detect`) as the first argument — e.g. `0402:3922`:
+
 ```bash
-trcc detect               # Show connected devices
-trcc send image.png       # Send image to LCD
-trcc display 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 system setup                # Interactive setup wizard
-trcc uninstall            # Remove TRCC completely
+trcc detect                                     # Show connected devices + their keys
+trcc display send-image 0402:3922 image.png     # Send an image to the LCD
+trcc display color 0402:3922 "#ff0000"          # Fill the LCD with a solid color
+trcc display load-video 0402:3922 clip.mp4      # Play a video on the LCD
+trcc display screencast 0402:3922               # Live screen capture to the LCD
+trcc display set-brightness 0402:3922 80        # Brightness (0–100%)
+trcc display set-orientation 0402:3922 90       # Rotate display (0/90/180/270)
+trcc led color 0416:8001 "#00ff00"              # Set LED color
+trcc led mode 0416:8001 breathing               # Set LED effect mode
+trcc report                                     # Generate diagnostic report
+trcc doctor                                     # Check system dependencies
+trcc system setup                               # Interactive setup wizard
 ```
 
+> **Command groups:** LCD actions live under `trcc display …`, LED under `trcc led …`, themes under `trcc theme …`; diagnostics (`report`, `detect`, `doctor`, `sensors`) are top-level; OS setup under `trcc system …`. Run `trcc --help` or `trcc display --help` to explore, and see the **[CLI Guide](doc/GUIDE_CLI.md)** for the full walkthrough.
+
 See the **[CLI Reference](doc/REFERENCE_CLI.md)** for the full command list.
 
 ### REST API
@@ -209,7 +211,7 @@ Set the angle to **90°** (or 270°) in the GUI, then open **Cloud Themes** —
 | [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 |
+| [Architecture Guide](doc/GUIDE_ARCHITECTURE.md) | Project layout, hexagonal design, and the unified UI presentation layer |
 | [Technical Reference](doc/REFERENCE_TECHNICAL.md) | SCSI protocol and file formats |
 
 ### Protocol documentation (reverse-engineered from Windows TRCC)
@@ -336,6 +338,15 @@ If a probe goes `BAD`, that's the bug — fix in `src/`, re-run, see `PASS`. Eve
 | LY | pyusb bulk (chunked) | Trofeo Vision 9.16 LCD |
 | LED | pyusb HID | All LED segment display devices (12 styles) |
 
+## Code Contributors
+
+These folks didn't just report a problem — they opened the editor and sent a fix. On a solo project, a merged pull request is about the most generous thing you can do, and every one of these shipped to every user:
+
+- **[@Hythera](https://github.com/Hythera)** — [#209](https://github.com/Lexonight1/thermalright-trcc-linux/pull/209): had the flake read its version straight from `pyproject.toml`, killing an entire place I used to have to bump by hand every release.
+- **[@elsiedotcafe](https://github.com/elsiedotcafe)** — [#123](https://github.com/Lexonight1/thermalright-trcc-linux/pull/123): pinned the PySide6 package to a stable source so the build stops breaking.
+
+Thank you both — genuinely. PRs are always welcome, and you'll land right here.
+
 ## 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.
@@ -386,11 +397,11 @@ Every name here took the time to open an issue and say "hey, this isn't working
 
 ## Stars
 
-Thanks to everyone who took a moment to star this project.
+Every single star is a small vote of confidence that this is worth keeping alive — and on the days the bugs are winning, watching that count tick up genuinely keeps me going. It costs you one click and it means more than you'd think. Thank you to all 120+ of you:
 
 **[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)** · **[audacieuxnumber1](https://github.com/audacieuxnumber1)** · **[azrael1911](https://github.com/azrael1911)** · **[bbrriiaann97](https://github.com/bbrriiaann97)** · **[behold81](https://github.com/behold81)** · **[betolink](https://github.com/betolink)** · **[bfesfbsbfesfbn](https://github.com/bfesfbsbfesfbn)** · **[bive242](https://github.com/bive242)** · **[brook-cheng](https://github.com/brook-cheng)** · **[BrunoLeguizamon05](https://github.com/BrunoLeguizamon05)** · **[cancos1](https://github.com/cancos1)** · **[capiazmi](https://github.com/capiazmi)** · **[cdh407](https://github.com/cdh407)** · **[cesarnr21](https://github.com/cesarnr21)** · **[chirox](https://github.com/chirox)** · **[codeflitting](https://github.com/codeflitting)** · **[CT-Actual](https://github.com/CT-Actual)** · **[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)** · **[Dezinger](https://github.com/Dezinger)** · **[Dezuvo](https://github.com/Dezuvo)** · **[eap5](https://github.com/eap5)** · **[eduu-dudu](https://github.com/eduu-dudu)** · **[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)** · **[guowc](https://github.com/guowc)** · **[gupsterg](https://github.com/gupsterg)** · **[huzky-v](https://github.com/huzky-v)** · **[hydrogen2005](https://github.com/hydrogen2005)** · **[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)** · **[JuanVargas](https://github.com/JuanVargas)** · **[JyeroRayguster404](https://github.com/JyeroRayguster404)** · **[k1w3l](https://github.com/k1w3l)** · **[KawalChlopa](https://github.com/KawalChlopa)** · **[kazhala](https://github.com/kazhala)** · **[knappstar](https://github.com/knappstar)** · **[kyle-tracy](https://github.com/kyle-tracy)** · **[Langustensorbet](https://github.com/Langustensorbet)** · **[Legendarycentaur](https://github.com/Legendarycentaur)** · **[Leonnaki](https://github.com/Leonnaki)** · **[Lfatua](https://github.com/Lfatua)** · **[llauer](https://github.com/llauer)** · **[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)** · **[monkky](https://github.com/monkky)** · **[mrsaraiva](https://github.com/mrsaraiva)** · **[N1sona](https://github.com/N1sona)** · **[narfel](https://github.com/narfel)** · **[nathanielhernandez](https://github.com/nathanielhernandez)** · **[nedimlisica](https://github.com/nedimlisica)** · **[nookpp](https://github.com/nookpp)** · **[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)** · **[reinierjh](https://github.com/reinierjh)** · **[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)** · **[SunnyZorya23](https://github.com/SunnyZorya23)** · **[the-black-eagle](https://github.com/the-black-eagle)** · **[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)** · **[wernerzsolt](https://github.com/wernerzsolt)** · **[Xentrino](https://github.com/Xentrino)** · **[YahusRevus](https://github.com/YahusRevus)** · **[zhanghangt](https://github.com/zhanghangt)** · **[Ziusz](https://github.com/Ziusz)**
 
-## Faulkers
+## Forkers
 
 Thanks for carrying the torch — these folks forked the repo to build on it.
 

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "trcc-linux"
-version = "9.8.3"
+version = "9.8.4"
 description = "Linux implementation of Thermalright LCD Control Center"
 readme = "README.md"
 license = "GPL-3.0-or-later"

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/src/trcc/__version__.py

@@ -1,4 +1,4 @@
 """TRCC Linux version information. History in doc/CHANGELOG.md."""
 
-__version__ = "9.8.3"
+__version__ = "9.8.4"
 __version_info__ = tuple(int(x) for x in __version__.split("."))

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/src/trcc/adapters/sensors/aggregator.py

@@ -52,6 +52,21 @@ from .psutil_sources import ComputedIo, PsutilCpu, PsutilMemory
 log = logging.getLogger(__name__)
 
 
+# Vendor priority when GPUs tie on discreteness.  An NVML-reported NVIDIA is
+# ALWAYS genuinely discrete (NVIDIA ships no consumer iGPUs), so it must win
+# over an AMD/Intel APU that only *looks* discrete via a large UMA framebuffer
+# — otherwise "amd:0" beats "nvidia:0" on the alphabetical tiebreak and the
+# integrated GPU becomes primary over the real card (#157: an RTX 5090 lost to
+# a Raphael iGPU with a big UMA allocation).
+_GPU_VENDOR_RANK = {"nvidia": 0, "amd": 1, "intel": 2}
+
+
+def _gpu_order(gpu: GpuSource) -> tuple[bool, int, str]:
+    """Sort key: discrete first, then nvidia > amd > intel, then key."""
+    vendor = gpu.key.split(":", 1)[0]
+    return (not gpu.is_discrete, _GPU_VENDOR_RANK.get(vendor, 9), gpu.key)
+
+
 # ── Key mapping helpers ──────────────────────────────────────────────
 
 
@@ -159,7 +174,10 @@ class BaselineSensors(SensorEnumerator):
         # Labels whose read has already raised — warn once, then DEBUG, so a
         # persistently-broken sensor doesn't spam a line every poll interval.
         self._read_failures: set[str] = set()
-        self._gpus.sort(key=lambda g: (not g.is_discrete, g.key))
+        self._gpus.sort(key=_gpu_order)
+        if self._gpus:
+            log.info("GPU order: %s (primary auto-pick = first discrete)",
+                     [g.key for g in self._gpus])
 
     def _read(
         self, fn: Callable[[], float | None], label: str,

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/src/trcc/core/commands/_helpers.py

@@ -350,7 +350,7 @@ def _element_to_entry(e: OverlayElement) -> OverlayElementEntry:
     return OverlayElementEntry(
         id=e.id, type=e.type, x=e.x, y=e.y, color=e.color, size=e.size,
         bold=e.bold, italic=e.italic, text=e.text, metric=e.metric,
-        format=e.format, source=e.source,
+        format=e.format, show_unit=e.show_unit, source=e.source,
     )
 
 

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/src/trcc/core/commands/device.py

@@ -1426,6 +1426,7 @@ class AddOverlayElement(Command[OverlayElementResult]):
     text: str = ""
     metric: str = ""
     format: str = "{value}"
+    show_unit: bool = True
     source: str = "time"
     element_id: str = ""
 
@@ -1449,6 +1450,7 @@ class AddOverlayElement(Command[OverlayElementResult]):
             x=self.x, y=self.y, color=self.color, size=self.size,
             bold=self.bold, italic=self.italic, text=self.text,
             metric=self.metric, format=self.format,
+            show_unit=self.show_unit,
             source=self.source,  # type: ignore[arg-type]
         )
         app.settings.add_user_overlay_element(self.key, element)
@@ -1473,6 +1475,7 @@ class UpdateOverlayElement(Command[OverlayElementResult]):
     text: str | None = None
     metric: str | None = None
     format: str | None = None
+    show_unit: bool | None = None
     source: str | None = None
 
     def execute(self, app: App) -> OverlayElementResult:
@@ -1481,7 +1484,8 @@ class UpdateOverlayElement(Command[OverlayElementResult]):
                 self.key, self.element_id,
                 x=self.x, y=self.y, color=self.color, size=self.size,
                 bold=self.bold, italic=self.italic, text=self.text,
-                metric=self.metric, format=self.format, source=self.source,
+                metric=self.metric, format=self.format,
+                show_unit=self.show_unit, source=self.source,
             )
         except KeyError as e:
             return OverlayElementResult(

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/src/trcc/core/models.py

@@ -2,6 +2,7 @@
 from __future__ import annotations
 
 import logging
+import uuid
 from dataclasses import dataclass, field
 from enum import Enum
 from pathlib import Path
@@ -506,6 +507,11 @@ class OverlayElement:
     # type == "metric"
     metric: str = ""
     format: str = "{value}"
+    # type == "metric" — draw the unit glyph (°C/%/MHz/RPM) after the number,
+    # or the bare number when the unit is baked into the theme art.  Mirrors
+    # the Windows unit-switch (myModeSub == 1); the universal per-element unit
+    # toggle flips this in every UI.
+    show_unit: bool = True
     # type == "clock"
     source: ClockSource = "time"
 
@@ -523,6 +529,7 @@ class OverlayElement:
         elif self.type == "metric":
             out["metric"] = self.metric
             out["format"] = self.format
+            out["show_unit"] = self.show_unit
         elif self.type == "clock":
             out["source"] = self.source
             # A date element carries the theme's strftime pattern (e.g.
@@ -533,9 +540,15 @@ class OverlayElement:
 
     @classmethod
     def from_dict(cls, data: dict) -> OverlayElement:
-        """Rebuild from JSON-loaded dict; tolerant of missing fields."""
+        """Rebuild from JSON-loaded dict; tolerant of missing fields.
+
+        Elements from a DC parse / an older config carry no ``id``; mint a
+        stable unique one so Update/Delete/Flash Commands can address the
+        element (a bare positional index never matched the ``el_<uuid>`` /
+        ``el_N`` schemes — #150/#203 click-to-highlight was fully broken).
+        """
         return cls(
-            id=str(data.get("id", "")),
+            id=str(data.get("id") or "") or f"el_{uuid.uuid4().hex[:8]}",
             type=data.get("type", "text"),
             x=int(data.get("x", 0)),
             y=int(data.get("y", 0)),
@@ -546,6 +559,7 @@ class OverlayElement:
             text=str(data.get("text", "")),
             metric=str(data.get("metric", "")),
             format=str(data.get("format", "{value}")),
+            show_unit=bool(data.get("show_unit", True)),
             source=data.get("source", "time"),
         )
 

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/src/trcc/core/results.py

@@ -577,6 +577,7 @@ class OverlayElementEntry:
     text: str = ""
     metric: str = ""
     format: str = "{value}"
+    show_unit: bool = True
     source: str = "time"
 
 

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/src/trcc/services/_dc.py

@@ -44,19 +44,26 @@ _MODE_DATE = 3
 _MODE_CUSTOM = 4
 
 
+# Metric VALUE slots render the BARE INTEGER — never the unit.  The Windows
+# app strips the unit off every sensor value before drawing it on the panel
+# (TRCC.cs: val.Replace("℃"/"℉"/"MHz"/"%"/"RPM","") → Convert.ToInt32 →
+# DrawString) because the unit is part of the theme's background artwork, not
+# the overlay.  Baking "°C"/"%"/"MHz" into the format double-prints the unit
+# on top of the baked-in glyph (#150/#203 diagnosis).  Label slots keep their
+# text; only the value slots are bare.
 _SLOT_MAP: list[tuple[str, str | None, str, str]] = [
     ("custom_text",       None,               "",      ""),
-    ("cpu_temp",          "cpu:temp",         "CPU",   "{value:.0f}°C"),
+    ("cpu_temp",          "cpu:temp",         "CPU",   "{value:.0f}"),
     ("cpu_temp_label",    None,               "CPU",   ""),
-    ("cpu_freq",          "cpu:freq",         "CPU",   "{value:.0f} MHz"),
+    ("cpu_freq",          "cpu:freq",         "CPU",   "{value:.0f}"),
     ("cpu_freq_label",    None,               "CPU",   ""),
-    ("cpu_usage",         "cpu:usage",        "CPU",   "{value:.0f}%"),
+    ("cpu_usage",         "cpu:usage",        "CPU",   "{value:.0f}"),
     ("cpu_usage_label",   None,               "CPU",   ""),
-    ("gpu_temp",          "gpu:primary:temp", "GPU",   "{value:.0f}°C"),
+    ("gpu_temp",          "gpu:primary:temp", "GPU",   "{value:.0f}"),
     ("gpu_temp_label",    None,               "GPU",   ""),
-    ("gpu_clock",         "gpu:primary:clock","GPU",   "{value:.0f} MHz"),
+    ("gpu_clock",         "gpu:primary:clock","GPU",   "{value:.0f}"),
     ("gpu_clock_label",   None,               "GPU",   ""),
-    ("gpu_usage",         "gpu:primary:usage","GPU",   "{value:.0f}%"),
+    ("gpu_usage",         "gpu:primary:usage","GPU",   "{value:.0f}"),
     ("gpu_usage_label",   None,               "GPU",   ""),
 ]
 
@@ -85,6 +92,9 @@ _HW_TO_SENSOR: dict[tuple[int, int], tuple[str, str]] = {
     (5, 2): ("fan:gpu",             "{value:.0f} RPM"),
     (5, 3): ("fan:ssd",             "{value:.0f} RPM"),
     (5, 4): ("fan:sys2",            "{value:.0f} RPM"),
+    # Fan-LCD "FAN" sentinel: the C# maps main_count 10000 to the cooler's own
+    # fan RPM (UCXiTongXianShiSubTimer: label1="FAN", label2=RPM, label3="RPM").
+    (10000, 1): ("fan:cpu",         "{value:.0f} RPM"),
 }
 
 
@@ -639,7 +649,12 @@ def _build_dd_element(
                 )
                 return None
             sensor_id, fmt = entry
-            return {**base, "type": "metric", "metric": sensor_id, "format": fmt}
+            # mode_sub is the C# "unit-switch" (button0): 1 appends the unit
+            # glyph to the number, otherwise the bare number is drawn (the unit
+            # lives in the theme art).  Translate the wire int to the domain
+            # ``show_unit`` here so the model/UI layers never see mode_sub.
+            return {**base, "type": "metric", "metric": sensor_id,
+                    "format": fmt, "show_unit": mode_sub == 1}
         case 4:
             if not custom_text:
                 return None
@@ -657,8 +672,11 @@ def _build_dd_element(
 
 
 def _clamp_font_size(raw: float, default: float = 24.0) -> float:
-    if 0 < raw < 100:
-        return max(8.0, min(72.0, raw))
+    # Theme fonts span ~8 px labels up to the panel's hero number (the 001-series
+    # temperature is authored at 128).  Only reject values a misaligned/garbage
+    # read produces (NaN, negative, or absurdly large); everything else is real.
+    if 8.0 <= raw <= 512.0:
+        return raw
     return default
 
 

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/src/trcc/services/led_effects.py

@@ -141,7 +141,7 @@ class ColorEngine:
 
 
 _TEST_COLORS: tuple[tuple[int, int, int], ...] = (
-    (1, 1, 1), (1, 0, 0), (0, 1, 0), (0, 0, 1),
+    (255, 255, 255), (255, 0, 0), (0, 255, 0), (0, 0, 255),
 )
 _TEST_PERIOD = 10                 # ticks per test color
 _BREATHING_PERIOD = 66            # full pulse cycle
@@ -234,6 +234,13 @@ class LEDEffectEngine:
         multi-callback timer behaviour (animation runs proportionally
         faster on a multi-zone device, not per-zone phase-isolated).
         """
+        # Test mode overrides the whole frame, page AND zone styles alike —
+        # the C# ``SendHidVal`` cycles the reference colours across all LEDs
+        # regardless of device style, so a zone device must honour it too.
+        if settings.test_mode:
+            log.debug("tick_multi_zone: test_mode → cycling reference colours")
+            return self._tick_test(runtime, led_count)
+
         colors: list[tuple[int, int, int]] = [(0, 0, 0)] * led_count
         zones = settings.zones
         log.debug("tick_multi_zone: %d zones, led_count=%d grouped=%s",
@@ -414,7 +421,7 @@ class LEDEffectEngine:
         runtime: LedRuntimeState,
         led_count: int,
     ) -> list[tuple[int, int, int]]:
-        """Cycle 4 dim reference colors every ``_TEST_PERIOD`` ticks."""
+        """Cycle 4 bright reference colours every ``_TEST_PERIOD`` ticks."""
         runtime.test_timer += 1
         if runtime.test_timer >= _TEST_PERIOD:
             runtime.test_timer = 0

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/src/trcc/services/overlay.py

@@ -25,6 +25,19 @@ log = logging.getLogger(__name__)
 
 _DC_CONFIG_FILE = "config1.dc"
 
+# Unit suffixes stripped off a metric value before drawing — the Windows app
+# (TRCC.cs) removes ℃/℉/MHz/%/RPM from every sensor value and draws the bare
+# integer, because the unit glyph is baked into the theme artwork, not the
+# overlay.  Longest-first so " MHz" is removed before a bare "MHz" fragment.
+_METRIC_UNITS = ("°C", "°F", "℃", "℉", " MHz", "MHz", " RPM", "RPM", "%")
+
+
+def _strip_metric_unit(text: str) -> str:
+    """Return ``text`` with any trailing metric unit removed (bare number)."""
+    for unit in _METRIC_UNITS:
+        text = text.replace(unit, "")
+    return text.strip()
+
 
 def resolve_overlay_elements(
     theme_config: dict[str, Any],
@@ -298,16 +311,19 @@ class OverlayService:
             return
         fmt = str(element.get("format", "{value}"))
         text = fmt.format(value=value)
-        # Presentation-layer suffix swap only — the numeric value is
-        # ALREADY converted by ``personalize_readings`` at the
-        # broadcast / one-shot boundary (MetricsLoop / RenderAndSend /
-        # LoadTheme / ReadSensors all route through it).  Renderer
-        # just adjusts the unit symbol in the formatted text so the
-        # theme's hardcoded ``"33°C"`` reads ``"33°F"`` when the
-        # user picked °F.  No celsius_to_fahrenheit call here — that
-        # would double-convert.
-        if temp_unit == "F" and "°C" in text:
-            text = text.replace("°C", "°F")
+        # ``show_unit`` mirrors the Windows unit-switch (myModeSub == 1): when
+        # set, the unit glyph (°C / % / MHz / RPM) is drawn after the number;
+        # otherwise the bare number is drawn because the unit is baked into the
+        # theme art and drawing it here would double-print it (#150/#203).  89%
+        # of shipped masks show the unit; the 001-series (baked glyph) do not.
+        if bool(element.get("show_unit", True)):
+            # The value is already unit-converted upstream by
+            # ``personalize_readings`` (°F picked → value is Fahrenheit); swap
+            # the hard-coded °C glyph so the label matches the global unit.
+            if temp_unit.upper() == "F":
+                text = text.replace("°C", "°F").replace("℃", "℉")
+        else:
+            text = _strip_metric_unit(text)
         x = int(element.get("x", 0))
         y = int(element.get("y", 0))
         log.debug("draw_metric %s: %s=%s at (%d, %d)",

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/src/trcc/services/settings.py

@@ -816,6 +816,13 @@ def _led_settings_from_dict(data: dict[str, Any]) -> LedDeviceSettings:
     for k, v in data.items():
         if k in valid:
             kwargs[k] = v
+    # ``test_mode`` is a momentary diagnostic (cycles reference colours on the
+    # LEDs), never a saved preference.  A True flag left on disk by a past CLI /
+    # smoke run (``EnableLedTestMode``) would otherwise be restored on every
+    # summon and paint the PAGE-style panels near-black on load — the ZONE styles
+    # escape only because ``tick_multi_zone`` ignores the flag.  Always start a
+    # session with test mode off; a live in-session toggle still works.
+    kwargs.pop("test_mode", None)
     # Mode enum from its int value
     if "mode" in kwargs and isinstance(kwargs["mode"], int):
         try:

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/src/trcc/ui/api/_shared.py

@@ -523,7 +523,7 @@ def _element_entry_to_schema(
     return OverlayElementSchema(
         id=e.id, type=e.type, x=e.x, y=e.y, color=e.color, size=e.size,
         bold=e.bold, italic=e.italic, text=e.text, metric=e.metric,
-        format=e.format, source=e.source,
+        format=e.format, show_unit=e.show_unit, source=e.source,
     )
 
 

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/src/trcc/ui/api/display.py

@@ -940,7 +940,7 @@ def overlay_update(key: str, element_id: str,
         x=body.x, y=body.y, color=body.color, size=body.size,
         bold=body.bold, italic=body.italic,
         text=body.text, metric=body.metric, format=body.format,
-        source=body.source,
+        show_unit=body.show_unit, source=body.source,
     ))
     http_error_if_failed(result)
     return to_overlay_element_response(result)

{trcc_linux-9.8.3 → trcc_linux-9.8.4}/src/trcc/ui/api/schemas.py

@@ -504,6 +504,7 @@ class OverlayElementSchema(BaseModel):
     text: str = ""
     metric: str = ""
     format: str = "{value}"
+    show_unit: bool = True
     source: str = "time"
 
 
@@ -518,6 +519,7 @@ class OverlayElementAddRequest(BaseModel):
     text: str = ""
     metric: str = ""
     format: str = "{value}"
+    show_unit: bool = True
     source: str = "time"
     element_id: str = ""
 
@@ -532,6 +534,7 @@ class OverlayElementUpdateRequest(BaseModel):
     text: str | None = None
     metric: str | None = None
     format: str | None = None
+    show_unit: bool | None = None
     source: str | None = None