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

{trcc_linux-9.8.3 → trcc_linux-9.8.5}/.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.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trcc-linux
-Version: 9.8.3
+Version: 9.8.5
 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.5}/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.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "trcc-linux"
-version = "9.8.3"
+version = "9.8.5"
 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.5}/src/trcc/__version__.py

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

{trcc_linux-9.8.3 → trcc_linux-9.8.5}/src/trcc/adapters/infra/sysinfo_config.py

@@ -291,12 +291,24 @@ class SysInfoConfig:
                 (i, b) for i, b in enumerate(fan_panel.sensors)
                 if not b.sensor_id
             ]
-            leftover_fan_ids = sorted(
-                r.sensor_id for r in readings
-                if r.sensor_id.startswith("fan:")
-                and r.sensor_id.endswith(":rpm")
-                and r.sensor_id not in bound_fan_ids
-            )
+            # Spinning fans first, dead headers last.  A super-I/O chip
+            # exposes every fan header (fan1..fan6) whether or not a fan is
+            # plugged in, and label-less boards (nct6xxx etc.) give no way to
+            # tell which is the CPU/pump.  Binding in raw id order lands the
+            # CPU/GPU slots on disconnected headers reading 0 RPM while the
+            # real fans (a water pump + radiator fans sit on arbitrary
+            # headers, always spinning) fall off the end — the "fans not
+            # reporting" bug (#145).  Order by (is-idle, id) so live readings
+            # claim the visible slots; idle headers only backfill leftovers.
+            leftover_fan_ids = [
+                r.sensor_id for r in sorted(
+                    (r for r in readings
+                     if r.sensor_id.startswith("fan:")
+                     and r.sensor_id.endswith(":rpm")
+                     and r.sensor_id not in bound_fan_ids),
+                    key=lambda r: ((r.value or 0.0) <= 0.0, r.sensor_id),
+                )
+            ]
             for (slot_idx, binding), fan_id in zip(
                 unbound_slots, leftover_fan_ids, strict=False,
             ):

{trcc_linux-9.8.3 → trcc_linux-9.8.5}/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.5}/src/trcc/app.py

@@ -54,7 +54,7 @@ from .services.led_effects import LEDEffectEngine
 from .services.media import MediaService
 from .services.metrics_loop import MetricsLoop
 from .services.migration import LibraryMigration
-from .services.overlay import OverlayService
+from .services.overlay import OverlayService, resolve_overlay_elements
 from .services.quickstart import QuickstartService
 from .services.settings import Settings
 from .services.slideshow import SlideshowService
@@ -413,6 +413,34 @@ class App:
             )
         return self._renderer
 
+    def effective_overlay_elements(self, key: str) -> list[dict]:
+        """The ONE overlay layout actually on screen for ``key``.
+
+        The single source every per-element operation (flash, select, edit)
+        must address — resolved by the same precedence the renderer uses
+        (user > mask > theme, each REPLACES; see
+        ``resolve_overlay_elements``).  Addressing only the user layer was
+        the ``FlashOverlayElement 'N' not found`` bug: when a mask or theme
+        supplies the live layout the user layer is empty, so an id/index
+        resolved against it matched nothing on screen.
+        """
+        s = self.settings.for_device(key)
+        theme = self.active_themes.get(key)
+        theme_config = theme.config if theme is not None else {}
+        elements = resolve_overlay_elements(
+            theme_config, s.mask_overlay_elements, s.user_overlay_elements,
+        )
+        log.debug(
+            "effective_overlay_elements: key=%s → %d element(s) "
+            "[theme=%d mask=%s user=%d]",
+            key, len(elements),
+            len(theme_config.get("elements") or []),
+            None if s.mask_overlay_elements is None
+            else len(s.mask_overlay_elements),
+            len(s.user_overlay_elements),
+        )
+        return elements
+
     # ── Device lifecycle ──────────────────────────────────────────────
 
     def attach(self, vid: int, pid: int) -> Device:
@@ -498,6 +526,16 @@ class App:
         self.metrics_loop.stop()
         self.led_animation_loop.stop()
         self.stop_hotplug()
+        # Blank every panel before releasing it so it goes dark on shutdown
+        # instead of holding its last frame lit (#143).  Best-effort: the
+        # Command swallows a mid-unplug send, and any unexpected error here
+        # must not block device release below.
+        from .core.commands import SleepDevice
+        for key in list(self.devices):
+            try:
+                self.dispatch(SleepDevice(key=key))
+            except Exception:
+                log.exception("close: SleepDevice raised for %s", key)
         for key in list(self.devices):
             self.detach(key)
         self._send_scheduler.shutdown()

{trcc_linux-9.8.3 → trcc_linux-9.8.5}/src/trcc/core/commands/__init__.py

@@ -19,6 +19,7 @@ from .device import (
     DisconnectDevice,
     DiscoverDevices,
     EnableOverlay,
+    EnsureConnected,
     FlashOverlayElement,
     LcdSnapshot,
     LoopVideo,
@@ -42,6 +43,7 @@ from .device import (
     SetOverlayBackground,
     SetOverlayConfig,
     SetSplitMode,
+    SleepDevice,
     StartScreencast,
     StopScreencast,
     StopVideo,
@@ -147,6 +149,7 @@ __all__ = [
     "EnableAutostart",
     "EnableLedTestMode",
     "EnableOverlay",
+    "EnsureConnected",
     "EnsureDataDownload",
     "ExportConfig",
     "ExportDcTheme",
@@ -234,6 +237,7 @@ __all__ = [
     "SetTempUnit",
     "SetTimeFormat",
     "SetWeekStart",
+    "SleepDevice",
     "StartScreencast",
     "StopScreencast",
     "StopVideo",

{trcc_linux-9.8.3 → trcc_linux-9.8.5}/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.5}/src/trcc/core/commands/device.py

@@ -236,6 +236,34 @@ class ConnectDevice(Command[ConnectResult]):
         )
 
 
+@dataclass(frozen=True, slots=True)
+class EnsureConnected(Command[ConnectResult]):
+    """Bring *key* up for a wire command only if it isn't already connected.
+
+    The idempotent counterpart to :class:`ConnectDevice`.  A stateless CLI
+    process holds no attached devices, so a wire command (``color``, ``play``,
+    ``load-theme`` …) dispatched from a fresh process would fail with "not
+    connected".  This attaches + handshakes once; when a daemon/GUI already
+    holds the device it is a pure no-op — unlike ``ConnectDevice`` it never
+    rebuilds the transport or re-handshakes a live device, so it is safe to
+    call before every wire command and once before a render/play loop without
+    disrupting an active stream.  (``ConnectDevice`` keeps its always-handshake
+    contract for the reconnect / dev-console inject-reply paths.)
+    """
+    key: str
+
+    def execute(self, app: App) -> ConnectResult:
+        existing = app.devices.get(self.key)
+        if existing is not None and existing.is_connected:
+            log.debug("EnsureConnected %s: already connected — no-op", self.key)
+            return ConnectResult(
+                ok=True, key=self.key,
+                message=f"{self.key} already connected",
+            )
+        log.info("EnsureConnected %s: not connected — attaching", self.key)
+        return app.dispatch(ConnectDevice(key=self.key))
+
+
 @dataclass(frozen=True, slots=True)
 class DeviceConnectionIssues(Command[ConnectionIssuesResult]):
     """Query devices that were found but failed to connect (with per-OS hints).
@@ -357,6 +385,44 @@ class SendColor(Command[SendResult]):
                      if ok else "Send returned False"),
         )
 
+@dataclass(frozen=True, slots=True)
+class SleepDevice(Command[SendResult]):
+    """Blank a connected panel so it goes dark on shutdown / quit (#143).
+
+    The unified "turn the screen off" action every surface dispatches — the
+    GUI/daemon shutdown hook (``App.close``), ``trcc display sleep`` (CLI),
+    and the ``/sleep`` API route all send this one Command.  Mirrors the C#
+    exit path (stop streaming + close the device) but adds an explicit dark
+    frame first, so the panel visibly clears instead of holding its last
+    image until the firmware idle-sleeps.
+
+    Composes the existing wire paths rather than duplicating them: LCD →
+    :class:`SendColor` (a solid-black frame via
+    ``DisplayService.build_solid_color_frame``); LED → :class:`SetLedColors`
+    with ``global_on=False`` (an all-off payload).  Best-effort by design —
+    a device mid-unplug returns ``ok=False`` instead of raising, so it can
+    never abort ``App.close`` mid-shutdown.
+    """
+    key: str
+
+    def execute(self, app: App) -> SendResult:
+        log.info("SleepDevice: key=%s", self.key)
+        device = app.devices.get(self.key)
+        if device is None or not device.is_connected:
+            log.info("SleepDevice %s: not connected — nothing to blank",
+                     self.key)
+            return SendResult(ok=False, key=self.key, bytes_sent=0,
+                              message=f"{self.key} not connected")
+        if device.is_led:
+            from .led import SetLedColors
+            result = SetLedColors(
+                key=self.key, colors=[(0, 0, 0)], global_on=False,
+            ).execute(app)
+            return SendResult(ok=result.ok, key=self.key, bytes_sent=0,
+                              message=result.message)
+        return SendColor(key=self.key, r=0, g=0, b=0).execute(app)
+
+
 @dataclass(frozen=True, slots=True)
 class SendImage(Command[SendResult]):
     """Push an image file to the LCD without staging it as a theme.
@@ -1426,6 +1492,7 @@ class AddOverlayElement(Command[OverlayElementResult]):
     text: str = ""
     metric: str = ""
     format: str = "{value}"
+    show_unit: bool = True
     source: str = "time"
     element_id: str = ""
 
@@ -1449,6 +1516,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 +1541,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 +1550,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(
@@ -1531,16 +1601,20 @@ class FlashOverlayElement(Command[OverlayElementResult]):
     duration_ms: int = 1500
 
     def execute(self, app: App) -> OverlayElementResult:
-        elements = app.settings.for_device(self.key).user_overlay_elements
-        for e in elements:
-            if e.id == self.element_id:
+        # Resolve against the EFFECTIVE layout on screen (user > mask >
+        # theme), not just the user layer — a mask/theme supplies the live
+        # elements while the user layer is empty, so a user-only lookup
+        # never matched them (the "element 'N' not found" flash bug).
+        for e in app.effective_overlay_elements(self.key):
+            if e.get("id") == self.element_id:
                 app.events.publish(OverlayChanged(
                     key=self.key, enabled=True,
                     flash_element_id=self.element_id,
                     flash_duration_ms=self.duration_ms,
                 ))
                 return OverlayElementResult(
-                    ok=True, key=self.key, element=_element_to_entry(e),
+                    ok=True, key=self.key,
+                    element=_element_to_entry(OverlayElement.from_dict(e)),
                     message=f"Flashing overlay element {self.element_id} "
                             f"for {self.duration_ms}ms",
                 )

{trcc_linux-9.8.3 → trcc_linux-9.8.5}/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"),
         )