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

{trcc_linux-9.8.2 → 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.2 → trcc_linux-9.8.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trcc-linux
-Version: 9.8.2
+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
@@ -28,6 +28,7 @@ Requires-Dist: click>=7.0
 Requires-Dist: fastapi>=0.100
 Requires-Dist: libusb-package>=1.0.26.3; sys_platform == 'win32' and python_version < '3.14'
 Requires-Dist: numpy>=1.24.0
+Requires-Dist: nvidia-ml-py>=11.0.0
 Requires-Dist: prompt-toolkit>=3.0.0
 Requires-Dist: psutil>=5.9.0
 Requires-Dist: pyside6>=6.5.0
@@ -43,7 +44,6 @@ Provides-Extra: all
 Requires-Dist: dbus-python>=1.3.0; extra == 'all'
 Requires-Dist: hidapi>=0.14.0; extra == 'all'
 Requires-Dist: httpx>=0.24.0; extra == 'all'
-Requires-Dist: nvidia-ml-py>=11.0.0; extra == 'all'
 Requires-Dist: pygobject>=3.42.0; extra == 'all'
 Requires-Dist: pytest-cov>=4.0.0; extra == 'all'
 Requires-Dist: pytest-qt>=4.0.0; extra == 'all'
@@ -61,7 +61,6 @@ Requires-Dist: types-qrcode>=7.0; extra == 'dev'
 Provides-Extra: hid
 Requires-Dist: hidapi>=0.14.0; extra == 'hid'
 Provides-Extra: nvidia
-Requires-Dist: nvidia-ml-py>=11.0.0; extra == 'nvidia'
 Provides-Extra: remote
 Requires-Dist: qrcode>=7.0; extra == 'remote'
 Provides-Extra: wayland
@@ -121,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.
 
@@ -220,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
@@ -283,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)
@@ -410,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.
@@ -460,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.2 → 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.2 → trcc_linux-9.8.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "trcc-linux"
-version = "9.8.2"
+version = "9.8.4"
 description = "Linux implementation of Thermalright LCD Control Center"
 readme = "README.md"
 license = "GPL-3.0-or-later"
@@ -57,12 +57,18 @@ dependencies = [
     # Core feature, not optional; the graceful-None fallback only covers exotic
     # environments that strip libudev (#139).
     "pyudev>=0.24.1; sys_platform == 'linux'",
+    # NVIDIA GPU temp/usage/clock via NVML.  Pure-Python (~53 KB), imports on
+    # any OS/hardware — nvmlInit() just no-ops without a card.  Core, not an
+    # extra, so `pip install trcc-linux` gets it out of the box: #161 was a
+    # pip-channel install where the card was present but the reader was never
+    # importable because the [nvidia] extra wasn't pulled.
+    "nvidia-ml-py>=11.0.0",
 ]
 
 [project.optional-dependencies]
-nvidia = [
-    "nvidia-ml-py>=11.0.0",
-]
+# Promoted to a core dependency (see [project].dependencies).  Kept as an empty
+# alias so existing `pip install trcc-linux[nvidia]` invocations still resolve.
+nvidia = []
 wayland = [
     "dbus-python>=1.3.0",
     "PyGObject>=3.42.0",

{trcc_linux-9.8.2 → 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.2"
+__version__ = "9.8.4"
 __version_info__ = tuple(int(x) for x in __version__.split("."))

{trcc_linux-9.8.2 → 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.2 → trcc_linux-9.8.4}/src/trcc/adapters/sensors/gpu_detect.py

@@ -86,7 +86,7 @@ def install_matching_gpu_extras(vendors: set[str],
     # are not visible in this virtualenv") and aborts setup — exactly what the
     # bundled-venv .deb hits (#161).  Install into the venv directly; only a
     # non-venv system Python needs --user (writes to the user's site-packages,
-    # no root).  Same detection as InstallGpuReader.
+    # no root).
     in_venv = sys.prefix != sys.base_prefix
     user_flag = [] if in_venv else ["--user"]
     cmd = [sys.executable, "-m", "pip", "install", *user_flag, *needed]

{trcc_linux-9.8.2 → trcc_linux-9.8.4}/src/trcc/adapters/sensors/nvml.py

@@ -20,15 +20,20 @@ log = logging.getLogger(__name__)
 try:
     import pynvml  # pyright: ignore[reportMissingImports]
     _AVAILABLE = True
-except ImportError:
+    _import_error: str | None = None
+except ImportError as e:
     pynvml = None  # type: ignore[assignment]
     _AVAILABLE = False
+    # Recorded, not logged here — logging isn't configured at module-import
+    # time.  Surfaced lazily (once) the first time init is attempted.
+    _import_error = str(e)
 
 
 _init_lock = threading.Lock()
 _initialized = False
 _init_error: str | None = None
 _warned_init_failure = False
+_warned_unavailable = False
 
 # Canonical fix for an NVML version mismatch (driver updated without reboot) —
 # referenced by both the runtime warning and the doctor's GPU check.
@@ -58,10 +63,20 @@ def _nvml_fix_hint(e: Exception) -> str:
 
 def _ensure_init() -> bool:
     """Lazy NVML init — retries until driver is loaded."""
-    global _initialized, _init_error, _warned_init_failure
+    global _initialized, _init_error, _warned_init_failure, _warned_unavailable
     if _initialized:
         return True
     if not _AVAILABLE or pynvml is None:
+        # pynvml itself couldn't be imported in this interpreter — the #161
+        # case (card present, reader missing).  Warn ONCE with the fix so it's
+        # visible at the default log level instead of a silent gpu:[].
+        if not _warned_unavailable:
+            _warned_unavailable = True
+            log.warning(
+                "pynvml not importable in this interpreter (%s) — NVIDIA GPU "
+                "sensors unavailable; install nvidia-ml-py into trcc's "
+                "environment", _import_error or "ImportError",
+            )
         return False
     with _init_lock:
         if _initialized:
@@ -99,6 +114,8 @@ def nvml_init_state() -> tuple[bool, bool, str | None]:
     late-loaded driver is reflected.
     """
     _ensure_init()
+    log.debug("nvml_init_state: available=%s initialized=%s error=%s",
+              _AVAILABLE, _initialized, _init_error)
     return _AVAILABLE, _initialized, _init_error
 
 

trcc_linux-9.8.4/src/trcc/assets/trcc-quirk-fix.service

@@ -0,0 +1,18 @@
+[Unit]
+Description=TRCC LCD USB Storage Quirk Fix
+Before=multi-user.target
+DefaultDependencies=no
+
+[Service]
+Type=oneshot
+# Force usb-storage Bulk-Only on every SCSI display so /dev/sgN is created.
+# The quirks sysfs param is a single comma-list and `echo` OVERWRITES it, so we
+# MUST write the FULL list — echoing one device here silently clobbered the
+# others set by /etc/modprobe.d/trcc-lcd.conf (#212: 0416:5406 lost its quirk).
+# MUST stay in sync with packaging/modprobe/trcc-lcd.conf AND
+# adapters/system/_udev.py build_modprobe_conf() — same list, three sources.
+ExecStart=/bin/sh -c 'modprobe sg && echo "0402:3922:u,0416:5406:u,87cd:70db:u" > /sys/module/usb_storage/parameters/quirks'
+RemainAfterExit=yes
+
+[Install]
+WantedBy=sysinit.target

{trcc_linux-9.8.2 → trcc_linux-9.8.4}/src/trcc/core/commands/__init__.py

@@ -86,9 +86,7 @@ from .system import (
     GenerateDebugReport,
     GetAutostartStatus,
     GetFirstRunStatus,
-    GetGpuReaderStatus,
     GetPlatformInfo,
-    InstallGpuReader,
     KeepAliveLoop,
     ListDisks,
     ListFonts,
@@ -158,12 +156,10 @@ __all__ = [
     "GenerateDebugReport",
     "GetAutostartStatus",
     "GetFirstRunStatus",
-    "GetGpuReaderStatus",
     "GetPlatformInfo",
     "ImportConfig",
     "ImportTheme",
     "InitializeLed",
-    "InstallGpuReader",
     "KeepAliveLoop",
     "LcdSnapshot",
     "LedSnapshot",

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

@@ -188,20 +188,6 @@ _UPGRADE_COMMANDS: dict[str, tuple[str, ...]] = {
 }
 
 
-# Install the NVIDIA NVML python reader (pynvml) when an NVIDIA GPU is
-# detected.  ``pkexec`` (graphical polkit prompt) rather than ``sudo`` —
-# this is dispatched from the GUI, which has no TTY for a sudo password.
-# Argv is a fixed list per package manager (never interpolate input).
-# Only distros whose package name is verified are auto-installable; an
-# unmapped PM falls back to detect-and-guide (the doctor prints the
-# manual command) rather than guessing a wrong package name.
-_GPU_READER_INSTALL_COMMANDS: dict[str, tuple[str, ...]] = {
-    "dnf":    ("pkexec", "dnf", "install", "-y", "python3-pynvml"),
-    "apt":    ("pkexec", "apt-get", "install", "-y", "python3-pynvml"),
-    "pacman": ("pkexec", "pacman", "-S", "--noconfirm", "python-nvidia-ml-py"),
-}
-
-
 def _json_default_tuple(obj: Any) -> Any:
     """tuple → list for JSON serialisation (no other coercions)."""
     log.debug("_json_default_tuple: type=%s", type(obj).__name__)
@@ -364,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.2 → 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(