trcc-linux 9.8.7__tar.gz → 9.8.8__tar.gz

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trcc-linux
-Version: 9.8.7
+Version: 9.8.8
 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
@@ -126,7 +126,7 @@ Description-Content-Type: text/markdown
 
 Native Linux port of the Thermalright LCD Control Center (Windows TRCC 2.1.2). Control and customize the LCD displays and LED segment displays on Thermalright CPU coolers, AIO pump heads, and fan hubs — entirely from Linux.
 
-> **This project wouldn't exist without our testers.** I only own one device. Every supported device in this list works because someone plugged it in, ran `trcc report`, and told me what broke. 32 testers helped us go from "SCSI only" to full C# feature parity with 6 USB protocols, 16 FBL resolutions, and 12 LED styles. Open source at its best — see [Contributors](#contributors) below.
+> **This project wouldn't exist without our testers.** I only own one device. Every supported device in this list works because someone plugged it in, ran `trcc report`, and told me what broke. 32 testers helped us go from "SCSI only" to full C# feature parity with 6 USB protocols, 16 FBL resolutions, and 13 LED styles. Open source at its best — see [Contributors](#contributors) below.
 
 > Unofficial community project, not affiliated with Thermalright. Built with [Claude](https://claude.ai) (AI) for protocol reverse engineering and code generation, guided by human architecture decisions and logical assessment.
 
@@ -306,7 +306,7 @@ Set the angle to **90°** (or 270°) in the GUI, then open **Cloud Themes** —
 | **Media** | Video/GIF playback on LCD, video trimmer, image cropper, screen cast (X11 + Wayland), mic audio visualization |
 | **Overlay Editor** | Text, sensors, date/time overlays — font picker, dynamic scaling, color picker |
 | **Hardware Sensors** | 77+ sensors — CPU/GPU temp, fan speed, power, usage — customizable dashboard |
-| **LED Control** | 12 LED styles, zone carousel, breathing/rainbow/static/wave modes, per-zone color |
+| **LED Control** | 13 LED styles, zone carousel, breathing/rainbow/static/wave modes, per-zone color |
 | **Display** | 16 resolutions (240x240 to 1920x462), 0/90/180/270 rotation, 3 brightness levels |
 | **Multi-device** | Per-device config, auto-detect, multi-device with device selection |
 | **Security** | udev rules, polkit policy, SELinux support, no root required after setup |
@@ -364,7 +364,7 @@ Run `lsusb` to find your USB ID (`xxxx:xxxx` after `ID`), then match it below.
 **HID LED devices** — RGB LED control:
 | USB ID | Devices |
 |--------|---------|
-| `0416:8001` | AX120 DIGITAL, PA120 DIGITAL, Peerless Assassin 120 DIGITAL ARGB White, Assassin X 120R Digital ARGB, Phantom Spirit 120 Digital EVO, HR10 2280 PRO Digital, and others (model auto-detected via handshake) |
+| `0416:8001` | AX120 DIGITAL, PA120 DIGITAL, Peerless Assassin 120 DIGITAL ARGB White, Assassin X 120R Digital ARGB, Phantom Spirit 120 Digital EVO, HR10 2280 PRO Digital, Magic Qube, and others (model auto-detected via handshake) |
 
 > See the [full device list with protocol details](doc/REFERENCE_DEVICES.md) and the [Device Testing Guide](doc/GUIDE_DEVICE_TESTING.md) if you have an untested device.
 
@@ -409,20 +409,21 @@ If a probe goes `BAD`, that's the bug — fix in `src/`, re-run, see `PASS`. Eve
 | HID Type 3 | pyusb interrupt | TARAN ARMS |
 | Bulk | pyusb bulk | GrandVision 360, Mjolnir Vision 360, Wonder Vision Pro 360, Frozen Warframe Pro |
 | LY | pyusb bulk (chunked) | Trofeo Vision 9.16 LCD |
-| LED | pyusb HID | All LED segment display devices (12 styles) |
+| LED | pyusb HID | All LED segment display devices (13 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:
 
+- **[@jphilipb](https://github.com/jphilipb)** — [#215](https://github.com/Lexonight1/thermalright-trcc-linux/pull/215): reverse-engineered and hardware-validated the Thermalright Magic Qube (65-LED segment display) — a device that doesn't even exist in the Windows app — and wired up full support from scratch.
 - **[@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.
+Thank you all — 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.
+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 13 LED styles from a single developer with one device. Every bug report, every test on hardware I don't own, every "hey this is broken" — that's open source at its best. You're not wasting your time. You're building something together.
 
 Special thanks to everyone who has contributed invaluable reports to this project:
 

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/README.md

@@ -53,7 +53,7 @@
 
 Native Linux port of the Thermalright LCD Control Center (Windows TRCC 2.1.2). Control and customize the LCD displays and LED segment displays on Thermalright CPU coolers, AIO pump heads, and fan hubs — entirely from Linux.
 
-> **This project wouldn't exist without our testers.** I only own one device. Every supported device in this list works because someone plugged it in, ran `trcc report`, and told me what broke. 32 testers helped us go from "SCSI only" to full C# feature parity with 6 USB protocols, 16 FBL resolutions, and 12 LED styles. Open source at its best — see [Contributors](#contributors) below.
+> **This project wouldn't exist without our testers.** I only own one device. Every supported device in this list works because someone plugged it in, ran `trcc report`, and told me what broke. 32 testers helped us go from "SCSI only" to full C# feature parity with 6 USB protocols, 16 FBL resolutions, and 13 LED styles. Open source at its best — see [Contributors](#contributors) below.
 
 > Unofficial community project, not affiliated with Thermalright. Built with [Claude](https://claude.ai) (AI) for protocol reverse engineering and code generation, guided by human architecture decisions and logical assessment.
 
@@ -233,7 +233,7 @@ Set the angle to **90°** (or 270°) in the GUI, then open **Cloud Themes** —
 | **Media** | Video/GIF playback on LCD, video trimmer, image cropper, screen cast (X11 + Wayland), mic audio visualization |
 | **Overlay Editor** | Text, sensors, date/time overlays — font picker, dynamic scaling, color picker |
 | **Hardware Sensors** | 77+ sensors — CPU/GPU temp, fan speed, power, usage — customizable dashboard |
-| **LED Control** | 12 LED styles, zone carousel, breathing/rainbow/static/wave modes, per-zone color |
+| **LED Control** | 13 LED styles, zone carousel, breathing/rainbow/static/wave modes, per-zone color |
 | **Display** | 16 resolutions (240x240 to 1920x462), 0/90/180/270 rotation, 3 brightness levels |
 | **Multi-device** | Per-device config, auto-detect, multi-device with device selection |
 | **Security** | udev rules, polkit policy, SELinux support, no root required after setup |
@@ -291,7 +291,7 @@ Run `lsusb` to find your USB ID (`xxxx:xxxx` after `ID`), then match it below.
 **HID LED devices** — RGB LED control:
 | USB ID | Devices |
 |--------|---------|
-| `0416:8001` | AX120 DIGITAL, PA120 DIGITAL, Peerless Assassin 120 DIGITAL ARGB White, Assassin X 120R Digital ARGB, Phantom Spirit 120 Digital EVO, HR10 2280 PRO Digital, and others (model auto-detected via handshake) |
+| `0416:8001` | AX120 DIGITAL, PA120 DIGITAL, Peerless Assassin 120 DIGITAL ARGB White, Assassin X 120R Digital ARGB, Phantom Spirit 120 Digital EVO, HR10 2280 PRO Digital, Magic Qube, and others (model auto-detected via handshake) |
 
 > See the [full device list with protocol details](doc/REFERENCE_DEVICES.md) and the [Device Testing Guide](doc/GUIDE_DEVICE_TESTING.md) if you have an untested device.
 
@@ -336,20 +336,21 @@ If a probe goes `BAD`, that's the bug — fix in `src/`, re-run, see `PASS`. Eve
 | HID Type 3 | pyusb interrupt | TARAN ARMS |
 | Bulk | pyusb bulk | GrandVision 360, Mjolnir Vision 360, Wonder Vision Pro 360, Frozen Warframe Pro |
 | LY | pyusb bulk (chunked) | Trofeo Vision 9.16 LCD |
-| LED | pyusb HID | All LED segment display devices (12 styles) |
+| LED | pyusb HID | All LED segment display devices (13 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:
 
+- **[@jphilipb](https://github.com/jphilipb)** — [#215](https://github.com/Lexonight1/thermalright-trcc-linux/pull/215): reverse-engineered and hardware-validated the Thermalright Magic Qube (65-LED segment display) — a device that doesn't even exist in the Windows app — and wired up full support from scratch.
 - **[@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.
+Thank you all — 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.
+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 13 LED styles from a single developer with one device. Every bug report, every test on hardware I don't own, every "hey this is broken" — that's open source at its best. You're not wasting your time. You're building something together.
 
 Special thanks to everyone who has contributed invaluable reports to this project:
 

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/pyproject.toml

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

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/src/trcc/__version__.py

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

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/src/trcc/adapters/device/led.py

@@ -26,7 +26,13 @@ from ...core.errors import (
     UnsupportedOperationError,
 )
 from ...core.led_models import LedPayload
-from ...core.led_protocol import remap_led_colors, resolve_pm
+from ...core.led_protocol import (
+    is_fingerprint_header,
+    remap_led_colors,
+    resolve_handshake,
+    resolve_model_name,
+    resolve_pm,
+)
 from ...core.models import HandshakeResult, LedHandshakeResult, ProductInfo, Wire
 from ...core.ports import BulkTransport, Device
 from . import DeviceFactory
@@ -206,11 +212,15 @@ class Led(Device[BulkTransport]):
                     time.sleep(_HANDSHAKE_RETRY_DELAY_S)
                     continue
 
-                # Windows DeviceDataReceived1 doesn't validate magic/cmd —
-                # we warn on mismatch but accept.
-                if resp[0:4] != _MAGIC:
-                    log.warning("Led handshake: unexpected magic %s", resp[0:4].hex())
-                if len(resp) > 12 and resp[12] != 1:
+                # Windows DeviceDataReceived1 doesn't validate magic/cmd — we
+                # accept regardless.  A recognised fingerprint header (e.g. the
+                # Magic Qube's DC DD AA 01) is expected, so only warn on a truly
+                # unknown magic / cmd byte.
+                header = bytes(resp[0:4])
+                recognised = is_fingerprint_header(header)
+                if header != _MAGIC and not recognised:
+                    log.warning("Led handshake: unexpected magic %s", header.hex())
+                if len(resp) > 12 and resp[12] != 1 and not recognised:
                     log.warning("Led handshake: unexpected cmd byte %d", resp[12])
 
                 # PM and SUB extraction — matches Windows UCDevice.cs offsets:
@@ -218,10 +228,13 @@ class Led(Device[BulkTransport]):
                 self._pm = resp[5]
                 self._sub = resp[4]
 
-                # PM byte → device style + readable model name. Falls back to
-                # the registry's ``led_style`` / ``product`` when the firmware
-                # reports a PM not in PmRegistry (e.g. a new SKU).
-                entry = resolve_pm(self._pm, self._sub)
+                # Handshake → device style + readable model name.  The header
+                # fingerprint wins first (some SKUs reuse a PM byte but ship a
+                # distinct handshake header — e.g. the Magic Qube shares PM=208
+                # with CZ1 but answers with DC DD AA 01), then the PM registry.
+                # Falls back to the registry's ``led_style`` / ``product`` when
+                # the firmware reports a PM not in PmRegistry (e.g. a new SKU).
+                entry = resolve_handshake(header, self._pm, self._sub)
                 if entry is not None:
                     style = entry.style
                     model_name = entry.model_name
@@ -278,7 +291,10 @@ class Led(Device[BulkTransport]):
         cached = _probe_cache_load(self.info.vid, self.info.pid)
         if cached is not None:
             cpm, csub, cname = cached
-            entry = resolve_pm(cpm, csub)
+            # A fingerprint device (e.g. Magic Qube) shares its PM byte with
+            # another product, so recover it by cached model name first — the
+            # cache doesn't persist the handshake header — then by PM byte.
+            entry = resolve_model_name(cname) or resolve_pm(cpm, csub)
             log.warning(
                 "Led handshake: live failed after %d retries — using "
                 "disk cache (PM=%d SUB=%d model=%s, last_err=%s)",

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/src/trcc/core/commands/device.py

@@ -191,18 +191,29 @@ class ConnectDevice(Command[ConnectResult]):
                     override.button_image or "(cutout-only)",
                 )
 
-        # LED style: enrich ``led_style`` from the same handshake fingerprint.
-        # The registry leaves it None ("resolved at runtime from PM byte"), so
-        # without this the LED handler reads None and falls back to a default
-        # style.  resolve_pm lives in core, so this stays inside the hexagon.
+        # LED style: enrich ``led_style`` from the handshake.  The registry
+        # leaves it None ("resolved at runtime"), so without this the LED
+        # handler reads None and falls back to a default style.  Prefer the
+        # LED adapter's already-resolved style — it honours the header
+        # fingerprint, so a Magic Qube (shares PM=208 with CZ1) isn't
+        # mis-tagged as CZ1 — and fall back to the header/PM registry from the
+        # raw handshake bytes.  resolve_* live in core, so this stays inside
+        # the hexagon.
         if device.info.wire is Wire.LED and device.info.led_style is None:
-            from ..led_protocol import resolve_pm
-            led_entry = resolve_pm(handshake.pm_byte, handshake.sub_byte)
-            if led_entry is not None and led_entry.style is not None:
-                device.info = _dc_replace(device.info, led_style=led_entry.style)
+            led_hs = getattr(device, "led_handshake", None)
+            led_style = getattr(led_hs, "style", None)
+            if led_style is None:
+                from ..led_protocol import resolve_handshake
+                led_entry = resolve_handshake(
+                    handshake.raw_response[:4],
+                    handshake.pm_byte, handshake.sub_byte,
+                )
+                led_style = led_entry.style if led_entry is not None else None
+            if led_style is not None:
+                device.info = _dc_replace(device.info, led_style=led_style)
                 log.info(
-                    "ConnectDevice %s: LED style PM=%d → %s",
-                    self.key, handshake.pm_byte, led_entry.style.value,
+                    "ConnectDevice %s: LED style → %s",
+                    self.key, led_style.value,
                 )
 
         # Install theme/cloud/mask data for the HANDSHAKE-resolved resolution.

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/src/trcc/core/geometry.py

@@ -116,20 +116,24 @@ def plan_orientation(
     rotate_panel = profile.rotate and w != h and orientation in (90, 270)
     if rotate_panel and not content_is_portrait and not profile.widescreen:
         return OrientationPlan((w, h), False, orientation)
+    if rotate_panel and profile.widescreen:
+        # Widescreen JPEG panels (1600×720 etc.): compose on the transposed
+        # portrait canvas (720×1600), preview upright — but post_rotate=0.  The
+        # WIRE rotation is owned entirely by resolve_encode_angle (via wire_angle),
+        # which the C# ``ImageToJpg`` applies to the whole composite to reach the
+        # device's fixed landscape dims: 0→180, 90→90, 180→0, 270→270.  A
+        # post_rotate here would double-rotate on top of it (the pre-fix code
+        # returned 180 at 270 AND relied on portrait_content=True to suppress the
+        # wire rotate — which silently sent an unrotated 720×1600 portrait frame,
+        # #169).  On-glass handedness still wants a reporter photo (#203/#169).
+        return OrientationPlan((h, w), True, 0)
     if rotate_panel:
-        # Portrait content is composed on the transposed canvas with the
-        # orientation baked into the pixels — but the asset is authored for 90.
-        # 270 is 90 + a 180° flip, and 180° is dimension-preserving, so rotate
-        # the WHOLE composite (bg + mask + text) as one unit and everything
-        # stays true to the physical rotation instead of frozen at 90.
-        # Widescreen JPEG panels keep post_rotate=0: their 90/270 send-unrotated
-        # behaviour is hardware-verified (#169) and must not change.
-        # 270 is 90 + a dimension-preserving 180° flip — applies to EVERY rotate
-        # panel including widescreen (the C# decompile shows widescreen 854×480
-        # rotates 90→270° / 270→90°, a 180° difference, not frozen).  The flip
-        # keeps the portrait-buffer dimensions (#169) and only re-orients the
-        # content, so it's dimension-safe (no clip).  On-glass handedness for
-        # widescreen still wants a reporter photo (#203) to confirm.
+        # Non-widescreen portrait content: composed on the transposed canvas with
+        # the orientation baked into the pixels — but the asset is authored for
+        # 90.  270 is 90 + a dimension-preserving 180° flip, so rotate the WHOLE
+        # composite (bg + mask + text) as one unit and everything stays true to
+        # the physical rotation instead of frozen at 90.  These panels take no
+        # wire rotation (portrait_content=True opts them out of wire_angle).
         post_rotate = 180 if orientation == 270 else 0
         return OrientationPlan((h, w), True, post_rotate)
     return OrientationPlan(oriented_resolution((w, h), orientation), False, 0)

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/src/trcc/core/led_models.py

@@ -200,6 +200,10 @@ LEGACY_STYLE_ID: dict[LedStyle, int] = {
     LedStyle.LF11:  10,
     LedStyle.LF15:  11,
     LedStyle.LF13:  12,
+    # Synthetic id for the Linux-added Magic Qube (no legacy C# style_id);
+    # continues the sequence so every LED_STYLES entry has an id.  It shows
+    # plain sensor gauges (led_panel_for treats any non-LC1/LF11/LC2 id so).
+    LedStyle.MAGIC_QUBE: 13,
 }
 
 # Inverse lookup — legacy int → :class:`LedStyle` enum.  Used by GUI
@@ -268,6 +272,13 @@ LED_STYLES: dict[LedStyle, LedStyleSpec] = {
                                  zone_assets=_ZONE_BTN_MODE56),
     LedStyle.LF13:  LedStyleSpec(62,  62, 0, "LF13",
                                  "led_preview_lf13",  "led_bg_lf13"),
+    # Magic Qube — 65 LEDs: two 7-seg digits (3 LEDs/segment, LED 0-41) + 4
+    # corner metric indicators (42-49) + a 15-LED contour border (50-64).
+    # Same 2-digit / 4-phase design as CZ1.  Reuses the generic segment assets
+    # until dedicated art is added.
+    LedStyle.MAGIC_QUBE: LedStyleSpec(65, 14, 4, "MAGIC_QUBE",
+                                      "led_preview_cz1", "led_bg_segment",
+                                      zone_assets=_ZONE_BTN_N),
 }
 
 
@@ -302,6 +313,7 @@ ZONE_STYLE_ASSETS: dict[LedStyle, tuple[tuple[str, str], ...]] = {
     LedStyle.LF10:  _ZONE_ASSETS_BTNN,
     LedStyle.CZ1:   _ZONE_ASSETS_BTNN,
     LedStyle.LF11:  _ZONE_ASSETS_BTNN,
+    LedStyle.MAGIC_QUBE: _ZONE_ASSETS_BTNN,
 }
 
 

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/src/trcc/core/led_protocol.py

@@ -114,6 +114,65 @@ def resolve_pm(pm: int, sub_type: int = 0) -> PmEntry | None:
     return _PM_REGISTRY.get(pm)
 
 
+# =========================================================================
+# Handshake fingerprint overrides
+# =========================================================================
+#
+# A product can reuse another device's PM byte yet ship a distinct firmware
+# handshake header, leaving the PM byte alone ambiguous.  The Thermalright
+# Magic Qube reports PM=208 (same as CZ1) but answers the HID handshake with
+# the header ``DC DD AA 01`` instead of the standard ``DA DB DC DD`` — the
+# only wire-level signal that tells it apart from a genuine CZ1.  Header
+# overrides are checked before the PM registry.
+
+_HEADER_OVERRIDES: dict[bytes, PmEntry] = {
+    bytes([0xDC, 0xDD, 0xAA, 0x01]): PmEntry(LedStyle.MAGIC_QUBE, "MAGIC_QUBE"),
+}
+
+_OVERRIDES_BY_MODEL: dict[str, PmEntry] = {
+    entry.model_name: entry for entry in _HEADER_OVERRIDES.values()
+}
+
+
+def resolve_handshake(
+    header: bytes, pm: int, sub_type: int = 0,
+) -> PmEntry | None:
+    """Resolve a device from its handshake — header fingerprint first.
+
+    A handful of products reuse another device's PM byte but ship a distinct
+    handshake header (firmware fingerprint).  When the leading four header
+    bytes match a known override that entry wins; otherwise we fall back to
+    the PM-byte registry (:func:`resolve_pm`).
+    """
+    entry = _HEADER_OVERRIDES.get(bytes(header[:4]))
+    if entry is not None:
+        log.info("resolve_handshake: header %s → %s (overrides pm=%d)",
+                 bytes(header[:4]).hex(), entry.model_name, pm)
+        return entry
+    return resolve_pm(pm, sub_type)
+
+
+def resolve_model_name(model_name: str) -> PmEntry | None:
+    """Resolve a fingerprint-override entry by its model name.
+
+    Used by the probe-cache fallback: the cache persists the model name, not
+    the handshake header, so a cached fingerprint device is recovered by
+    name.  Returns ``None`` for names not carried by an override — the caller
+    then falls back to the PM registry.
+    """
+    return _OVERRIDES_BY_MODEL.get(model_name)
+
+
+def is_fingerprint_header(header: bytes) -> bool:
+    """Whether the handshake header matches a known device fingerprint.
+
+    Lets the LED adapter treat a recognised non-standard header (e.g. the
+    Magic Qube's ``DC DD AA 01``) as expected instead of logging it as an
+    anomaly next to the standard ``DA DB DC DD`` magic.
+    """
+    return bytes(header[:4]) in _HEADER_OVERRIDES
+
+
 # ═══════════════════════════════════════════════════════════════════════
 # Wire-order remap tables
 # ═══════════════════════════════════════════════════════════════════════
@@ -322,6 +381,9 @@ __all__ = [
     "LED_REMAP_SUB_TABLES",
     "LED_REMAP_TABLES",
     "PmEntry",
+    "is_fingerprint_header",
     "remap_led_colors",
+    "resolve_handshake",
+    "resolve_model_name",
     "resolve_pm",
 ]

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/src/trcc/core/models.py

@@ -189,6 +189,7 @@ class LedStyle(str, Enum):
     LF11 = "lf11"       # legacy style_id 10
     LF15 = "lf15"       # legacy style_id 11
     LF13 = "lf13"       # legacy style_id 12
+    MAGIC_QUBE = "magic_qube"  # Linux-added: Thermalright Magic Qube (no legacy style_id)
 
 
 # =========================================================================

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/src/trcc/core/protocol.py

@@ -347,15 +347,21 @@ def wire_angle(
         C#-source-verified per-resolution encode base, #203/#169)
       * squares / non-rotate panels → user orientation only (``360 − orient``)
 
-    A portrait-content theme on a rotate panel is pre-rotated at compose time
-    (``post_rotate``) and opts out by passing ``portrait_content=True``.
+    A *non-widescreen* portrait-content theme on a rotate panel is pre-rotated at
+    compose time (``post_rotate``) and opts out via ``portrait_content=True``.
+    **Widescreen JPEG panels do NOT opt out**: their 90/270 compose buffer is an
+    upright 720×1600 portrait canvas that MUST be rotated by
+    :func:`resolve_encode_angle` to reach the device's fixed landscape wire
+    dimensions (1600×720).  The C# ``ImageToJpg`` applies exactly this rotation to
+    every widescreen frame regardless of the compose orientation (#169) — gating
+    it on ``not portrait_content`` left the live path (which passes
+    ``portrait_content=True`` for widescreen) sending an unrotated portrait frame.
     """
     wire_rotate_panel = (
         profile.rotate and not portrait_content and not profile.widescreen
     )
     fold_into_encode = (
-        profile.rotate and not portrait_content
-        and profile.widescreen and profile.jpeg
+        profile.rotate and profile.widescreen and profile.jpeg
     )
     if wire_rotate_panel:
         return wire_rotation(profile, orientation)

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/src/trcc/services/led_segment.py

@@ -701,6 +701,92 @@ class CZ1Display(SegmentDisplay):
         return mask
 
 
+# ═══════════════════════════════════════════════════════════════════════
+# Magic Qube (50 LEDs, two 7-seg digits × 3-LED segments, 4-phase rotation)
+# ═══════════════════════════════════════════════════════════════════════
+
+
+# Physical wire order of the 7 segments within one Magic Qube digit, 3 LEDs
+# each (empirically mapped on hardware): c, d, e, g, b, a, f.
+_QUBE_WIRE: tuple[str, ...] = ("c", "d", "e", "g", "b", "a", "f")
+
+
+def _qube_digit_segmap(base: int) -> dict[str, tuple[int, int, int]]:
+    """Map each 7-seg label → its 3 LED indices for a digit starting at ``base``."""
+    pos = {seg: i for i, seg in enumerate(_QUBE_WIRE)}
+    return {
+        seg: (base + pos[seg] * 3, base + pos[seg] * 3 + 1, base + pos[seg] * 3 + 2)
+        for seg in "abcdefg"
+    }
+
+
+class MagicQubeDisplay(SegmentDisplay):
+    """Thermalright Magic Qube — 50 LEDs: two 7-seg digits + 4 indicators.
+
+    Both digits render ONE 2-digit value (left = tens, right = units); a
+    single corner indicator lights to name the metric, rotating through the
+    four phases like CZ1.  Each segment is 3 physical LEDs in wire order
+    c, d, e, g, b, a, f; the right digit is LED 0-20, the left 21-41; the
+    four indicator pairs are 42-49 (clockwise from top-left).  Mapped
+    empirically on hardware (no reference implementation exists).
+    """
+
+    mask_size = 65
+    phase_count = 4
+
+    LEFT = _qube_digit_segmap(21)   # tens digit (physically left)
+    RIGHT = _qube_digit_segmap(0)   # units digit (physically right)
+
+    # Indicator LED pairs, clockwise from top-left.
+    IND_CPU_TEMP = (42, 43)
+    IND_GPU_TEMP = (44, 45)
+    IND_GPU_LOAD = (46, 47)
+    IND_CPU_LOAD = (48, 49)
+
+    # Contour/border LEDs — always lit; they take the effect colour (the
+    # segments/indicators are gated by the value mask, the border is not).
+    BORDER = tuple(range(50, 65))
+
+    PHASES: tuple[tuple[str, tuple[int, int]], ...] = (
+        ("cpu_temp",    IND_CPU_TEMP),
+        ("gpu_temp",    IND_GPU_TEMP),
+        ("gpu_usage",   IND_GPU_LOAD),
+        ("cpu_percent", IND_CPU_LOAD),
+    )
+
+    # Each digit is one cohesive colour group (right 0-20, left 21-41); the
+    # indicators ride along in the swept "rest" group (#193).
+    color_groups = _digit_color_groups(
+        mask_size, (tuple(range(21)), tuple(range(21, 42))),
+    )
+
+    def _encode_qube_digit(
+        self, ch: str, segmap: dict[str, tuple[int, int, int]], mask: list[bool],
+    ) -> None:
+        """Light the 3 LEDs of every segment the character ``ch`` needs."""
+        for seg in self.CHAR_7SEG.get(ch, set()):
+            for led in segmap[seg]:
+                mask[led] = True
+
+    def compute_mask(
+        self, metrics: HardwareMetrics, phase: int = 0, temp_unit: str = "C", **kw: Any,
+    ) -> list[bool]:
+        mask = [False] * self.mask_size
+        metric_key, indicator = self.PHASES[phase % self.phase_count]
+        for idx in indicator:
+            mask[idx] = True
+        value = int(getattr(metrics, metric_key, 0))
+        if "temp" in metric_key:
+            value = self._to_display_temp(value, temp_unit)
+        value = max(0, min(99, value))
+        tens, units = divmod(value, 10)
+        self._encode_qube_digit(str(tens) if tens else " ", self.LEFT, mask)
+        self._encode_qube_digit(str(units), self.RIGHT, mask)
+        for idx in self.BORDER:
+            mask[idx] = True
+        return mask
+
+
 # ═══════════════════════════════════════════════════════════════════════
 # Style 9 — LC2 (61 LEDs, clock display, 7 decoration)
 # ═══════════════════════════════════════════════════════════════════════
@@ -828,6 +914,7 @@ DISPLAYS: dict[LedStyle, SegmentDisplay] = {
     LedStyle.LC2:   LC2Display(),
     LedStyle.LF11:  LF11Display(),
     LedStyle.LF15:  LF8Display(),   # LF15 = same layout as LF8
+    LedStyle.MAGIC_QUBE: MagicQubeDisplay(),
     # LedStyle.LF13 — pure RGB, no digit display
 }
 

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/src/trcc/ui/gui/lcd_handler.py

@@ -43,7 +43,10 @@ from ...core.commands import (
 )
 from ..presentation.lcd_presentation_model import LcdPresentationModel
 from ..presentation.overlay_serialization import dc_as_legacy_overlay_config
-from ..presentation.theme_directories import resolve_theme_directories
+from ..presentation.theme_directories import (
+    oriented_theme_reload_target,
+    resolve_theme_directories,
+)
 from .base_handler import BaseHandler
 
 if TYPE_CHECKING:
@@ -1016,7 +1019,51 @@ class LCDHandler(BaseHandler):
             degrees, ow, oh, self._pm.state.is_rotated,
         )
         self._sync_preview_size()   # composed orientation, portrait-theme aware (#136)
-        self._update_theme_directories()
+        # _update_theme_directories switches the browser catalog to the new
+        # orientation dims + re-lists it, and auto-loads the first theme ONLY on
+        # first install (nothing active yet).  When a theme IS already active it
+        # returns False and leaves the OLD-orientation theme rendering — so reload
+        # the active theme's oriented variant here, or the device keeps a
+        # landscape bg letterboxed into the portrait buffer (#169 "not filling").
+        if not self._update_theme_directories():
+            self._reload_theme_for_orientation()
+
+    def _reload_theme_for_orientation(self) -> None:
+        """Reload the ACTIVE theme from the just-switched orientation catalog.
+
+        A rotation swaps the browser catalog (``theme1600720`` ↔ ``theme7201600``)
+        but not the rendered theme; the C# re-authors the theme per orientation,
+        so the portrait catalog ships a genuine portrait ``00.png`` that fills the
+        720×1600 buffer.  Reloading the same-name variant from the new catalog
+        gives the same result — a filled, upright frame (#169).
+
+        Falls back to keeping the current theme when the new catalog has no
+        same-name variant (a user's custom theme, or the #136 portrait-fallback
+        where the local dir resolves back to landscape); there the render pipeline
+        pixel-rotates the landscape art so it is at least correctly oriented.
+        """
+        active = self._pm.state.current_theme_path
+        if active is None:
+            return
+        dirs = resolve_theme_directories(
+            self._app.platform.paths(),
+            canvas_size=self._pm.state.canvas_size,
+            lcd_size=self._pm.state.lcd_size,
+            is_rotated=self._pm.state.is_rotated,
+        )
+        target = oriented_theme_reload_target(active, dirs)
+        if target is None:
+            self.log.info(
+                "_reload_theme_for_orientation: no oriented variant of '%s' in the "
+                "%dx%d catalog — keeping current theme (pixel-rotate fallback)",
+                active.name, *dirs.catalog_size,
+            )
+            return
+        self.log.info(
+            "_reload_theme_for_orientation: reloading '%s' from the %dx%d catalog "
+            "→ %s", active.name, *dirs.catalog_size, target,
+        )
+        self._select_theme_from_path(target, persist=True, overlay_config=True)
 
     def set_split_mode(self, mode: int) -> None:
         self.log.info("set_split_mode: %d -> %d device=%s",

{trcc_linux-9.8.7 → trcc_linux-9.8.8}/src/trcc/ui/gui/uc_led_control.py

@@ -161,7 +161,9 @@ _STYLE_CHECKABLE_BTN = (
 # overlays (full i18n): AX120(1)+PA120(2) [led_zone_mode_1-4], AK120(3)+LF8(5)+
 # LF12(6)+LF15(11) [led_zone_mode_5-6], LC1(4)+LF11(10) [panel bg].  CZ1(8) keeps
 # its baked bg labels (not cleared); LF10(7) is colour-zones (no metric text).
-_OVERLAY_BUTTON_STYLES = frozenset({1, 2, 3, 4, 5, 6, 10, 11})
+# Magic Qube(13) has no baked-label art (generic segment bg) → overlay the
+# tr() page labels on the plain button frame, like the LC1/LF11 group.
+_OVERLAY_BUTTON_STYLES = frozenset({1, 2, 3, 4, 5, 6, 10, 11, 13})
 
 # Button labels for styles whose model carries none (PA120 is ZONE → page_labels
 # must stay () per the model invariant, but its zones *are* the 4 metrics).