trcc-linux 9.0.2__tar.gz → 9.0.4__tar.gz

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trcc-linux
-Version: 9.0.2
+Version: 9.0.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
@@ -67,6 +67,11 @@ Description-Content-Type: text/markdown
 
 # TRCC Linux
 
+<p align="center">
+  <img src="doc/workplace.jpeg" width="600" alt="Our state-of-the-art development facility"><br>
+  <em>At our state-of-the-art development facility. We're working on professionalism. lol</em>
+</p>
+
 > **Looking for testers!** We need **Linux**, **Windows**, **macOS**, and **BSD** testers. If you have a Thermalright LCD or LED device on any platform, grab the latest [release](https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest) and [let us know how it goes](https://github.com/Lexonight1/thermalright-trcc-linux/issues) — run `trcc report` and paste the output in an issue. Every test report helps, even if nothing works yet!
 
 > **Solo hobbyist project** — built in my spare time, one device, no corporate backing. Just a Linux user who got tired of waiting for Thermalright to support us. If something breaks, please be patient — I do this for free because I like helping people. If this project helps you, consider [buying me a beer](https://buymeacoffee.com/Lexonight1) 🍺 or [Ko-fi](https://ko-fi.com/lexonight1) ☕
@@ -130,7 +135,7 @@ Pre-built packages are available for every major distro. No pip, no venv, no PEP
 | Fedora / Nobara / openSUSE | [Fedora](doc/GUIDE_INSTALL.md#fedora--nobara) |
 | Bazzite / Bluefin / Aurora / Universal Blue | [Immutable Fedora](doc/GUIDE_INSTALL.md#bazzite--aurora--bluefin--fedora-atomic) |
 | Ubuntu 24.04+ / Debian 13+ / Mint 22+ / Pop!_OS / Zorin | [Ubuntu / Debian](doc/GUIDE_INSTALL.md#ubuntu--debian--mint--pop_os--zorin) |
-| Ubuntu 22.04 / Mint 21.x / Debian 12 (older) | [PyPI install](doc/GUIDE_INSTALL.md#ubuntu--debian--mint--pop_os--zorin-pip) |
+| Ubuntu 22.04 / Mint 21.x / Debian 12 (older) | [Legacy DEB](doc/GUIDE_INSTALL.md#ubuntu-2204--mint-21x--debian-12-legacy-deb) |
 | Arch / CachyOS / Manjaro / EndeavourOS / Garuda | [Arch](doc/GUIDE_INSTALL.md#arch--cachyos--manjaro--endeavouros--garuda) |
 | NixOS | [NixOS](doc/GUIDE_INSTALL.md#nixos) |
 | Gentoo | [Gentoo](doc/GUIDE_INSTALL.md#gentoo) |
@@ -154,7 +159,7 @@ If you see `OK` next to your package — it's clean. Source code is GPL-3.0, ful
 
 ### PyPI
 
-Best option for older distros (Ubuntu 22.04, Mint 21.x, Debian 11/12) or if you prefer Python packaging.
+Best option for very old distros (Ubuntu 20.04, Debian 11) or if you prefer Python packaging. For Ubuntu 22.04 / Mint 21.x / Debian 12, the [Legacy DEB](doc/GUIDE_INSTALL.md#ubuntu-2204--mint-21x--debian-12-legacy-deb) is easier.
 
 ```bash
 # Install system dependencies first
@@ -424,7 +429,7 @@ A big thanks to everyone who has contributed invaluable reports to this project:
 
 Thanks to everyone who took a moment to star this project — it means the world.
 
-**[alessa-lara](https://github.com/alessa-lara)** · **[ArcaneCoder404](https://github.com/ArcaneCoder404)** · **[betolink](https://github.com/betolink)** · **[bive242](https://github.com/bive242)** · **[BrunoLeguizamon05](https://github.com/BrunoLeguizamon05)** · **[cancos1](https://github.com/cancos1)** · **[cesarnr21](https://github.com/cesarnr21)** · **[codeflitting](https://github.com/codeflitting)** · **[dabombUSA](https://github.com/dabombUSA)** · **[damachine](https://github.com/damachine)** · **[DasFlogetier](https://github.com/DasFlogetier)** · **[eap5](https://github.com/eap5)** · **[emaspa](https://github.com/emaspa)** · **[Gdetrane](https://github.com/Gdetrane)** · **[gupsterg](https://github.com/gupsterg)** · **[jezzaw007](https://github.com/jezzaw007)** · **[jhlasnik](https://github.com/jhlasnik)** · **[jmo808](https://github.com/jmo808)** · **[knappstar](https://github.com/knappstar)** · **[mgaruccio](https://github.com/mgaruccio)** · **[michael-spinelli](https://github.com/michael-spinelli)** · **[michelle0812](https://github.com/michelle0812)** · **[mkogut](https://github.com/mkogut)** · **[nathanielhernandez](https://github.com/nathanielhernandez)** · **[oddajpierscien](https://github.com/oddajpierscien)** · **[Pewful2021](https://github.com/Pewful2021)** · **[Pikarz](https://github.com/Pikarz)** · **[qussaif10](https://github.com/qussaif10)** · **[Rehaell](https://github.com/Rehaell)** · **[riodevelop](https://github.com/riodevelop)** · **[rslater](https://github.com/rslater)** · **[shadowepaxeor-glitch](https://github.com/shadowepaxeor-glitch)** · **[ShaunnyBwoy](https://github.com/ShaunnyBwoy)** · **[Smokemic](https://github.com/Smokemic)** · **[Spebelgenenst](https://github.com/Spebelgenenst)** · **[spiritofjon](https://github.com/spiritofjon)** · **[stephenvalente](https://github.com/stephenvalente)** · **[Thymur](https://github.com/Thymur)** · **[Vydon](https://github.com/Vydon)** · **[Xentrino](https://github.com/Xentrino)** · **[Ziusz](https://github.com/Ziusz)**
+**[alessa-lara](https://github.com/alessa-lara)** · **[ArcaneCoder404](https://github.com/ArcaneCoder404)** · **[betolink](https://github.com/betolink)** · **[bive242](https://github.com/bive242)** · **[BrunoLeguizamon05](https://github.com/BrunoLeguizamon05)** · **[cancos1](https://github.com/cancos1)** · **[cesarnr21](https://github.com/cesarnr21)** · **[codeflitting](https://github.com/codeflitting)** · **[dabombUSA](https://github.com/dabombUSA)** · **[damachine](https://github.com/damachine)** · **[DasFlogetier](https://github.com/DasFlogetier)** · **[eap5](https://github.com/eap5)** · **[emaspa](https://github.com/emaspa)** · **[Gdetrane](https://github.com/Gdetrane)** · **[gupsterg](https://github.com/gupsterg)** · **[jezzaw007](https://github.com/jezzaw007)** · **[jhlasnik](https://github.com/jhlasnik)** · **[jmo808](https://github.com/jmo808)** · **[knappstar](https://github.com/knappstar)** · **[mgaruccio](https://github.com/mgaruccio)** · **[michelle0812](https://github.com/michelle0812)** · **[mkogut](https://github.com/mkogut)** · **[nathanielhernandez](https://github.com/nathanielhernandez)** · **[oddajpierscien](https://github.com/oddajpierscien)** · **[Pewful2021](https://github.com/Pewful2021)** · **[Pikarz](https://github.com/Pikarz)** · **[qussaif10](https://github.com/qussaif10)** · **[Rehaell](https://github.com/Rehaell)** · **[riodevelop](https://github.com/riodevelop)** · **[rslater](https://github.com/rslater)** · **[shadowepaxeor-glitch](https://github.com/shadowepaxeor-glitch)** · **[ShaunnyBwoy](https://github.com/ShaunnyBwoy)** · **[Smokemic](https://github.com/Smokemic)** · **[Spebelgenenst](https://github.com/Spebelgenenst)** · **[spiritofjon](https://github.com/spiritofjon)** · **[stephenvalente](https://github.com/stephenvalente)** · **[Thymur](https://github.com/Thymur)** · **[Vydon](https://github.com/Vydon)** · **[Xentrino](https://github.com/Xentrino)** · **[Ziusz](https://github.com/Ziusz)**
 
 ## Faulkers
 

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/README.md

@@ -1,5 +1,10 @@
 # TRCC Linux
 
+<p align="center">
+  <img src="doc/workplace.jpeg" width="600" alt="Our state-of-the-art development facility"><br>
+  <em>At our state-of-the-art development facility. We're working on professionalism. lol</em>
+</p>
+
 > **Looking for testers!** We need **Linux**, **Windows**, **macOS**, and **BSD** testers. If you have a Thermalright LCD or LED device on any platform, grab the latest [release](https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest) and [let us know how it goes](https://github.com/Lexonight1/thermalright-trcc-linux/issues) — run `trcc report` and paste the output in an issue. Every test report helps, even if nothing works yet!
 
 > **Solo hobbyist project** — built in my spare time, one device, no corporate backing. Just a Linux user who got tired of waiting for Thermalright to support us. If something breaks, please be patient — I do this for free because I like helping people. If this project helps you, consider [buying me a beer](https://buymeacoffee.com/Lexonight1) 🍺 or [Ko-fi](https://ko-fi.com/lexonight1) ☕
@@ -63,7 +68,7 @@ Pre-built packages are available for every major distro. No pip, no venv, no PEP
 | Fedora / Nobara / openSUSE | [Fedora](doc/GUIDE_INSTALL.md#fedora--nobara) |
 | Bazzite / Bluefin / Aurora / Universal Blue | [Immutable Fedora](doc/GUIDE_INSTALL.md#bazzite--aurora--bluefin--fedora-atomic) |
 | Ubuntu 24.04+ / Debian 13+ / Mint 22+ / Pop!_OS / Zorin | [Ubuntu / Debian](doc/GUIDE_INSTALL.md#ubuntu--debian--mint--pop_os--zorin) |
-| Ubuntu 22.04 / Mint 21.x / Debian 12 (older) | [PyPI install](doc/GUIDE_INSTALL.md#ubuntu--debian--mint--pop_os--zorin-pip) |
+| Ubuntu 22.04 / Mint 21.x / Debian 12 (older) | [Legacy DEB](doc/GUIDE_INSTALL.md#ubuntu-2204--mint-21x--debian-12-legacy-deb) |
 | Arch / CachyOS / Manjaro / EndeavourOS / Garuda | [Arch](doc/GUIDE_INSTALL.md#arch--cachyos--manjaro--endeavouros--garuda) |
 | NixOS | [NixOS](doc/GUIDE_INSTALL.md#nixos) |
 | Gentoo | [Gentoo](doc/GUIDE_INSTALL.md#gentoo) |
@@ -87,7 +92,7 @@ If you see `OK` next to your package — it's clean. Source code is GPL-3.0, ful
 
 ### PyPI
 
-Best option for older distros (Ubuntu 22.04, Mint 21.x, Debian 11/12) or if you prefer Python packaging.
+Best option for very old distros (Ubuntu 20.04, Debian 11) or if you prefer Python packaging. For Ubuntu 22.04 / Mint 21.x / Debian 12, the [Legacy DEB](doc/GUIDE_INSTALL.md#ubuntu-2204--mint-21x--debian-12-legacy-deb) is easier.
 
 ```bash
 # Install system dependencies first
@@ -357,7 +362,7 @@ A big thanks to everyone who has contributed invaluable reports to this project:
 
 Thanks to everyone who took a moment to star this project — it means the world.
 
-**[alessa-lara](https://github.com/alessa-lara)** · **[ArcaneCoder404](https://github.com/ArcaneCoder404)** · **[betolink](https://github.com/betolink)** · **[bive242](https://github.com/bive242)** · **[BrunoLeguizamon05](https://github.com/BrunoLeguizamon05)** · **[cancos1](https://github.com/cancos1)** · **[cesarnr21](https://github.com/cesarnr21)** · **[codeflitting](https://github.com/codeflitting)** · **[dabombUSA](https://github.com/dabombUSA)** · **[damachine](https://github.com/damachine)** · **[DasFlogetier](https://github.com/DasFlogetier)** · **[eap5](https://github.com/eap5)** · **[emaspa](https://github.com/emaspa)** · **[Gdetrane](https://github.com/Gdetrane)** · **[gupsterg](https://github.com/gupsterg)** · **[jezzaw007](https://github.com/jezzaw007)** · **[jhlasnik](https://github.com/jhlasnik)** · **[jmo808](https://github.com/jmo808)** · **[knappstar](https://github.com/knappstar)** · **[mgaruccio](https://github.com/mgaruccio)** · **[michael-spinelli](https://github.com/michael-spinelli)** · **[michelle0812](https://github.com/michelle0812)** · **[mkogut](https://github.com/mkogut)** · **[nathanielhernandez](https://github.com/nathanielhernandez)** · **[oddajpierscien](https://github.com/oddajpierscien)** · **[Pewful2021](https://github.com/Pewful2021)** · **[Pikarz](https://github.com/Pikarz)** · **[qussaif10](https://github.com/qussaif10)** · **[Rehaell](https://github.com/Rehaell)** · **[riodevelop](https://github.com/riodevelop)** · **[rslater](https://github.com/rslater)** · **[shadowepaxeor-glitch](https://github.com/shadowepaxeor-glitch)** · **[ShaunnyBwoy](https://github.com/ShaunnyBwoy)** · **[Smokemic](https://github.com/Smokemic)** · **[Spebelgenenst](https://github.com/Spebelgenenst)** · **[spiritofjon](https://github.com/spiritofjon)** · **[stephenvalente](https://github.com/stephenvalente)** · **[Thymur](https://github.com/Thymur)** · **[Vydon](https://github.com/Vydon)** · **[Xentrino](https://github.com/Xentrino)** · **[Ziusz](https://github.com/Ziusz)**
+**[alessa-lara](https://github.com/alessa-lara)** · **[ArcaneCoder404](https://github.com/ArcaneCoder404)** · **[betolink](https://github.com/betolink)** · **[bive242](https://github.com/bive242)** · **[BrunoLeguizamon05](https://github.com/BrunoLeguizamon05)** · **[cancos1](https://github.com/cancos1)** · **[cesarnr21](https://github.com/cesarnr21)** · **[codeflitting](https://github.com/codeflitting)** · **[dabombUSA](https://github.com/dabombUSA)** · **[damachine](https://github.com/damachine)** · **[DasFlogetier](https://github.com/DasFlogetier)** · **[eap5](https://github.com/eap5)** · **[emaspa](https://github.com/emaspa)** · **[Gdetrane](https://github.com/Gdetrane)** · **[gupsterg](https://github.com/gupsterg)** · **[jezzaw007](https://github.com/jezzaw007)** · **[jhlasnik](https://github.com/jhlasnik)** · **[jmo808](https://github.com/jmo808)** · **[knappstar](https://github.com/knappstar)** · **[mgaruccio](https://github.com/mgaruccio)** · **[michelle0812](https://github.com/michelle0812)** · **[mkogut](https://github.com/mkogut)** · **[nathanielhernandez](https://github.com/nathanielhernandez)** · **[oddajpierscien](https://github.com/oddajpierscien)** · **[Pewful2021](https://github.com/Pewful2021)** · **[Pikarz](https://github.com/Pikarz)** · **[qussaif10](https://github.com/qussaif10)** · **[Rehaell](https://github.com/Rehaell)** · **[riodevelop](https://github.com/riodevelop)** · **[rslater](https://github.com/rslater)** · **[shadowepaxeor-glitch](https://github.com/shadowepaxeor-glitch)** · **[ShaunnyBwoy](https://github.com/ShaunnyBwoy)** · **[Smokemic](https://github.com/Smokemic)** · **[Spebelgenenst](https://github.com/Spebelgenenst)** · **[spiritofjon](https://github.com/spiritofjon)** · **[stephenvalente](https://github.com/stephenvalente)** · **[Thymur](https://github.com/Thymur)** · **[Vydon](https://github.com/Vydon)** · **[Xentrino](https://github.com/Xentrino)** · **[Ziusz](https://github.com/Ziusz)**
 
 ## Faulkers
 

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/pyproject.toml

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

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/__init__.py

@@ -23,20 +23,17 @@ Usage:
     trcc-test         # Test display with color cycle
 """
 
-__version__ = "7.0.5"
-__author__ = "TRCC Linux Contributors"
-
-# Core exports
+from trcc.__version__ import __version__
 from trcc.adapters.device.detector import detect_devices, get_device_path
 from trcc.adapters.device.lcd import LCDDriver
 from trcc.adapters.infra.dc_config import DcConfig
 from trcc.adapters.infra.dc_parser import dc_to_overlay_config, parse_dc_file
-
-# Animation
 from trcc.adapters.infra.media_player import VideoDecoder
 from trcc.core.models import format_metric
 from trcc.services.system import get_all_metrics
 
+__author__ = "TRCC Linux Contributors"
+
 __all__ = [
     # Version
     "__version__",

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/__version__.py

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

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/adapters/device/bulk.py

@@ -163,10 +163,14 @@ class BulkDevice(BulkFrameDevice, FrameDevice):
         struct.pack_into("<I", header, 60, data_size)    # payload length
 
         try:
-            # C# USBLCDNEW ThreadSendDeviceData: single SubmitAsyncTransfer
-            # of header + payload as one contiguous buffer.
             frame = bytes(header) + image_data
-            self._ep_out.write(frame, timeout=_WRITE_TIMEOUT_MS)  # type: ignore[union-attr]
+            # Send in chunks — a single large transfer can reset the device
+            # on KVM USB passthrough and slower USB hubs.
+            for offset in range(0, len(frame), _WRITE_CHUNK_SIZE):
+                self._ep_out.write(  # type: ignore[union-attr]
+                    frame[offset:offset + _WRITE_CHUNK_SIZE],
+                    timeout=_WRITE_TIMEOUT_MS,
+                )
 
             # C#: ZLP when total is 512-aligned (num2 % 512 == 0)
             if len(frame) % 512 == 0:

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/adapters/system/linux/sensors.py

@@ -315,7 +315,8 @@ class SensorEnumerator(SensorEnumeratorABC):
 
         try:
             count = pynvml.nvmlDeviceGetCount()
-        except Exception:
+        except Exception as e:
+            log.warning("nvmlDeviceGetCount failed — NVIDIA GPU sensors unavailable: %s", e)
             return
 
         for i in range(count):
@@ -325,7 +326,8 @@ class SensorEnumerator(SensorEnumeratorABC):
                 gpu_name = pynvml.nvmlDeviceGetName(handle)
                 if isinstance(gpu_name, bytes):
                     gpu_name = gpu_name.decode()
-            except Exception:
+            except Exception as e:
+                log.warning("NVIDIA GPU %d handle/name failed — skipping: %s", i, e)
                 continue
 
             prefix = f"nvidia:{i}"
@@ -461,38 +463,38 @@ class SensorEnumerator(SensorEnumeratorABC):
             try:
                 readings[f"{prefix}:temp"] = float(
                     pynvml.nvmlDeviceGetTemperature(handle, pynvml.NVML_TEMPERATURE_GPU))
-            except Exception:
-                pass
+            except Exception as e:
+                log.debug("nvidia:%d temp read failed: %s", i, e)
             try:
                 util = pynvml.nvmlDeviceGetUtilizationRates(handle)
                 readings[f"{prefix}:gpu_util"] = float(util.gpu)
                 readings[f"{prefix}:mem_util"] = float(util.memory)
-            except Exception:
-                pass
+            except Exception as e:
+                log.debug("nvidia:%d util read failed: %s", i, e)
             try:
                 readings[f"{prefix}:clock"] = float(
                     pynvml.nvmlDeviceGetClockInfo(handle, pynvml.NVML_CLOCK_GRAPHICS))
-            except Exception:
-                pass
+            except Exception as e:
+                log.debug("nvidia:%d clock read failed: %s", i, e)
             try:
                 readings[f"{prefix}:mem_clock"] = float(
                     pynvml.nvmlDeviceGetClockInfo(handle, pynvml.NVML_CLOCK_MEM))
-            except Exception:
-                pass
+            except Exception as e:
+                log.debug("nvidia:%d mem_clock read failed: %s", i, e)
             try:
                 readings[f"{prefix}:power"] = pynvml.nvmlDeviceGetPowerUsage(handle) / 1000.0
-            except Exception:
-                pass
+            except Exception as e:
+                log.debug("nvidia:%d power read failed: %s", i, e)
             try:
                 mem = pynvml.nvmlDeviceGetMemoryInfo(handle)
                 readings[f"{prefix}:vram_used"] = int(mem.used) / (1024 * 1024)
                 readings[f"{prefix}:vram_total"] = int(mem.total) / (1024 * 1024)
-            except Exception:
-                pass
+            except Exception as e:
+                log.debug("nvidia:%d vram read failed: %s", i, e)
             try:
                 readings[f"{prefix}:fan"] = float(pynvml.nvmlDeviceGetFanSpeed(handle))
-            except Exception:
-                pass
+            except Exception as e:
+                log.debug("nvidia:%d fan read failed: %s", i, e)
 
     def _read_drm(self, readings: dict[str, float]):
         """Read DRM sysfs sensors (AMD gpu_busy, Intel freq)."""

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/api/display.py

@@ -6,8 +6,9 @@ import hmac
 import io
 import json
 import logging
+from pathlib import Path
 
-from fastapi import APIRouter, HTTPException, UploadFile, WebSocket, WebSocketDisconnect
+from fastapi import APIRouter, HTTPException, Query, UploadFile, WebSocket, WebSocketDisconnect
 from fastapi.responses import Response
 
 from trcc.api.models import (
@@ -234,6 +235,129 @@ def test_display() -> dict:
     return {"success": True, "message": f"Test complete — cycled {len(colors)} colors on {w}x{h}"}
 
 
+# ── Create-theme endpoint ─────────────────────────────────────────────
+
+_VIDEO_SUFFIXES = frozenset({'.mp4', '.zt', '.webm', '.avi', '.mkv'})
+
+
+def _is_animated(path: Path) -> bool:
+    """Return True if path is a video or an animated GIF (n_frames > 1)."""
+    suffix = path.suffix.lower()
+    if suffix in _VIDEO_SUFFIXES:
+        return True
+    if suffix == '.gif':
+        try:
+            from PIL import Image
+            with Image.open(path) as img:
+                return getattr(img, 'n_frames', 1) > 1
+        except Exception:
+            return False
+    return False
+
+
+@router.post("/create-theme")
+def create_theme(
+    background: str,
+    mask: str | None = None,
+    metric: list[str] = Query(default=[]),
+    loop: bool = True,
+    font_size: int = 14,
+    color: str = "ffffff",
+    font: str = "Microsoft YaHei",
+    font_style: str = "regular",
+    temp_unit: int = 0,
+    time_format: int = 0,
+    date_format: int = 0,
+) -> dict:
+    """Send a custom theme to the LCD device.
+
+    Auto-detects animated backgrounds (video, animated GIF) and loops them
+    by default. Add ``&loop=false`` to play once.
+
+    ``metric`` is repeatable: ``&metric=cpu_temp:10,20&metric=time:150,10:ffffff:24``
+
+    Metric spec format: ``key:x,y[:color[:size[:font[:style]]]]``
+    """
+    import trcc.api as api
+    from trcc.core.models import build_overlay_config
+    from trcc.services import ImageService
+
+    lcd = _get_display()
+    api.stop_video_playback()
+    api.stop_overlay_loop()
+
+    bg_path = Path(background)
+    if '\0' in background or not bg_path.exists():
+        raise HTTPException(status_code=400, detail=f"Background file not found: {background}")
+
+    if mask is not None and ('\0' in mask or not Path(mask).exists()):
+        raise HTTPException(status_code=400, detail=f"Mask file not found: {mask}")
+
+    w, h = lcd.resolution  # type: ignore[union-attr]
+    animated = _is_animated(bg_path)
+
+    overlay_config = None
+    if metric:
+        try:
+            overlay_config = build_overlay_config(
+                metric,
+                default_color=color,
+                default_font_size=font_size,
+                default_font=font,
+                default_style=font_style,
+                temp_unit=temp_unit,
+                time_format=time_format,
+                date_format=date_format,
+            )
+        except ValueError as e:
+            raise HTTPException(status_code=400, detail=str(e))
+
+    if animated:
+        ok = api.start_video_playback(str(bg_path), w, h, loop=loop)
+        if not ok:
+            raise HTTPException(status_code=500, detail="Failed to start video playback")
+        return {"success": True, "animated": True, "loop": loop, "resolution": f"{w}x{h}"}
+
+    # Static image
+    from trcc.cli import _ensure_renderer
+    _ensure_renderer()
+    img = ImageService.open_and_resize(bg_path, w, h)
+    if img is None:
+        raise HTTPException(status_code=400, detail="Failed to open background image")
+
+    if mask:
+        result = lcd.load_mask_standalone(mask)
+        if not result.get("success"):
+            raise HTTPException(status_code=400, detail=result.get("error", "Mask load failed"))
+        img = result.get("image", img)
+
+    if overlay_config:
+        from trcc.adapters.infra.dc_config import DcConfig
+        from trcc.adapters.infra.dc_parser import load_config_json
+        from trcc.cli import _ensure_system
+        from trcc.services.overlay import OverlayService
+        _ensure_system()
+        overlay = OverlayService(
+            w, h, renderer=api._renderer,
+            load_config_json_fn=load_config_json,
+            dc_config_cls=DcConfig,
+        )
+        overlay.set_background(img)
+        overlay.set_config(overlay_config)
+        overlay.enabled = True
+        api._overlay_svc = overlay
+        # render one frame immediately and send
+        from trcc.services.system import get_all_metrics
+        frame = overlay.render(get_all_metrics())
+        lcd.frame.send_pil(frame)
+        api.set_current_image(frame)
+    else:
+        lcd.frame.send_pil(img)
+        api.set_current_image(img)
+
+    return {"success": True, "animated": False, "resolution": f"{w}x{h}"}
+
+
 # ── Preview helpers ───────────────────────────────────────────────────
 
 

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/cli/__init__.py

@@ -127,10 +127,6 @@ def _main_callback(
         "--verbose", "-v", count=True,
         help="Increase verbosity (-v, -vv, -vvv)",
     )] = 0,
-    last_one: Annotated[bool, typer.Option(
-        "--last-one",
-        help="Start minimized to system tray with last-used theme (autostart)",
-    )] = False,
     testing_hid: Annotated[bool, typer.Option(
         "--testing-hid", hidden=True,
         help="No-op (HID devices are now auto-detected)",
@@ -142,9 +138,6 @@ def _main_callback(
 ) -> None:
     global _verbose
     _verbose = verbose
-    if last_one:
-        result = gui(verbose=verbose, start_hidden=True)
-        raise typer.Exit(result or 0)
     if ctx.invoked_subcommand is None:
         typer.echo(ctx.get_help())
 
@@ -225,9 +218,13 @@ def _cmd_gui(
         "--decorated", "-d",
         help="Use decorated window (normal window with titlebar, can minimize)",
     )] = False,
+    resume: Annotated[bool, typer.Option(
+        "--resume",
+        help="Start hidden in system tray and restore last-used theme (autostart)",
+    )] = False,
 ) -> int:
     """Launch graphical interface."""
-    return gui(verbose=_verbose, decorated=decorated)
+    return gui(verbose=_verbose, decorated=decorated, start_hidden=resume)
 
 
 @app.command("detect")

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/cli/_system.py

@@ -9,9 +9,6 @@ from pathlib import Path
 
 from trcc.core.platform import LINUX, detect_install_method, is_root
 
-# Backward compat — internal callers use _is_root()
-_is_root = is_root
-
 
 def _require_linux(command: str) -> int | None:
     """Return error code if not on Linux, None if OK to proceed."""
@@ -192,7 +189,7 @@ def uninstall(*, yes: bool = False):
 
     # Handle root files — auto-elevate with sudo if needed
     root_exists = [p for p in root_files if os.path.exists(p)]
-    if root_exists and not _is_root():
+    if root_exists and not is_root():
         print("Root files found — requesting sudo to remove...")
         result = _sudo_run(["rm", "-f"] + root_exists)
         if result.returncode == 0:
@@ -221,7 +218,7 @@ def uninstall(*, yes: bool = False):
         print("Nothing to remove — TRCC is already clean.")
 
     # Reload udev if we removed rules (and we're root — non-root already did it above)
-    if _is_root() and any("udev" in r for r in removed):
+    if is_root() and any("udev" in r for r in removed):
         subprocess.run(["udevadm", "control", "--reload-rules"], check=False)
         subprocess.run(["udevadm", "trigger"], check=False)
 

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/qt_components/__init__.py

@@ -9,15 +9,9 @@ from .uc_theme_mask import UCThemeMask
 from .uc_theme_setting import UCThemeSetting
 from .uc_theme_web import UCThemeWeb
 
-# Backward compat aliases (to be removed after migration)
-TRCCMainWindowMVC = TRCCApp
-run_mvc_app = run_app
-
 __all__ = [
     'TRCCApp',
     'run_app',
-    'TRCCMainWindowMVC',
-    'run_mvc_app',
     'BasePanel',
     'ImageLabel',
     'pil_to_pixmap',

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/qt_components/display_mode_panels.py

@@ -279,7 +279,9 @@ class DisplayModePanel(QFrame):
             btn.setEnabled(enabled)
 
     def set_enabled(self, enabled):
+        self.toggle_btn.blockSignals(True)
         self.toggle_btn.setChecked(enabled)
+        self.toggle_btn.blockSignals(False)
         self._set_actions_enabled(enabled)
 
     def set_title(self, text: str) -> None:

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/qt_components/lcd_handler.py

@@ -450,6 +450,9 @@ class LCDHandler:
             if preview is not None:
                 self._w['preview'].set_image(preview, fast=True)
 
+        if not self._lcd.connected:
+            return
+
         # Pre-encoded path
         encoded = result.get('encoded')
         if encoded is not None:
@@ -613,6 +616,8 @@ class LCDHandler:
             return
         if self._is_visible():
             self._w['preview'].set_image(image)
+        if not self._lcd.connected:
+            return
         if skip_if_video and self._lcd.video.playing:
             return
         self._lcd.frame.send(image)
@@ -686,4 +691,11 @@ class LCDHandler:
         self._slideshow_timer.stop()
         self._flash_timer.stop()
         self._lcd.video.stop()
+        # Stop async send worker and wait for any in-progress send to finish,
+        # then send a black frame to clear the display before disconnecting.
+        try:
+            self._lcd.device_service.stop_send_worker()
+            self._lcd.frame.send_color(0, 0, 0)
+        except Exception:
+            pass
         self._lcd.cleanup()

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/qt_components/screen_capture.py

@@ -11,6 +11,7 @@ Works on both X11 and Wayland via fallback chain.
 """
 from __future__ import annotations
 
+import logging
 import os
 import subprocess
 import tempfile
@@ -20,6 +21,8 @@ from PySide6.QtCore import QPoint, QRect, Qt, Signal
 from PySide6.QtGui import QColor, QFont, QPainter, QPen, QPixmap
 from PySide6.QtWidgets import QApplication, QWidget
 
+log = logging.getLogger(__name__)
+
 
 @lru_cache(maxsize=1)
 def is_wayland() -> bool:
@@ -300,5 +303,6 @@ class ScreenCaptureOverlay(BaseScreenOverlay):
             pil_img = pixmap_to_pil(cropped)
             self.captured.emit(pil_img)
         except Exception:
+            log.debug("Screen capture region crop/convert failed", exc_info=True)
             self.captured.emit(None)
         self.deleteLater()

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/qt_components/trcc_app.py

@@ -297,7 +297,6 @@ class LEDHandler:
             if self._save_counter >= self._SAVE_INTERVAL:
                 self._save_counter = 0
                 self._led.save_config()
-                log.debug("LED: periodic config save")
         except Exception:
             log.exception("LED tick error")
 
@@ -327,6 +326,7 @@ class ScreencastHandler:
         self._lcd_w = 320
         self._lcd_h = 320
 
+        self._capture_warn_logged = False
         self._timer = QTimer(parent)
         self._timer.timeout.connect(self._tick)
 
@@ -403,7 +403,11 @@ class ScreencastHandler:
             from .screen_capture import grab_screen_region
             pixmap = grab_screen_region(self._x, self._y, self._w, self._h)
             if pixmap.isNull():
+                if not self._capture_warn_logged:
+                    log.warning("Screencast: all capture methods failed — no frame available")
+                    self._capture_warn_logged = True
                 return
+            self._capture_warn_logged = False
             pil_img = pixmap_to_pil(pixmap)
 
         pil_img = pil_img.resize(
@@ -1395,7 +1399,7 @@ class TRCCApp(QMainWindow):
         elif cmd == UCThemeSetting.CMD_MASK_CLOUD:
             self._show_panel(3)  # C# buttonYDMB_Click — cloud masks
         elif cmd == UCThemeSetting.CMD_VIDEO_LOAD:
-            self._on_load_video_clicked()
+            self._on_media_player_load_clicked()
         elif cmd == 51:  # C# buttonYDZT_Click — switch to cloud theme panel
             self._show_panel(1)
         elif cmd == UCThemeSetting.CMD_VIDEO_TOGGLE:
@@ -1449,13 +1453,19 @@ class TRCCApp(QMainWindow):
         if not self._lcd_handler:
             return
         if enabled:
-            # C# case 3: myBjxs=false, myTpxs=false
-            self._screencast.toggle(False)
-            self._lcd_handler.is_background_active = False
-            if self._lcd_handler.display.video_has_frames():
-                self._lcd_handler.play_pause()
+            # Toggle ON: UI gate only — enable Load button, don't touch display
+            pass
         else:
-            self._lcd_handler.stop_video()
+            # Toggle OFF: stop media player video and resume the background theme
+            if self._lcd_handler.display.video_has_frames():
+                self._lcd_handler._animation_timer.stop()
+                self._lcd_handler.display.stop_video()
+                self.uc_preview.set_playing(False)
+                self.uc_preview.show_video_controls(False)
+            # Always reload last theme on toggle OFF
+            last_path = self._lcd_handler.display.current_theme_path
+            if last_path:
+                self._lcd_handler.select_theme_from_path(Path(last_path))
 
     def _on_screencast_frame(self, pil_img):
         if self._lcd_handler:
@@ -1474,6 +1484,33 @@ class TRCCApp(QMainWindow):
             self.uc_video_cut.load_video(path)
             self._show_cutter('video')
 
+    def _on_media_player_load_clicked(self):
+        """Load and play a video directly on the LCD — no cutter, no Theme.zt encoding."""
+        web_dir = str(_conf.settings.web_dir) if _conf.settings.web_dir else ""
+        path, _ = QFileDialog.getOpenFileName(
+            self, "Open Video", web_dir,
+            "Video Files (*.mp4 *.avi *.mkv *.mov *.gif);;All Files (*)")
+        if not path or not self._lcd_handler:
+            return
+
+        # Stop all competing sources before loading: background, screencast, overlay
+        self._screencast.toggle(False)
+        self._lcd_handler.is_background_active = False
+        self._lcd_handler._animation_timer.stop()
+        self._lcd_handler.display.stop_video()
+        self._lcd_handler.display.enable(False)  # overlay off — don't overwrite video frames
+
+        result = self._lcd_handler.display.load_video(path)
+        if not result.get("success"):
+            self.uc_preview.set_status(f"Error: {result.get('error', 'Failed to load video')}")
+            return
+        self._lcd_handler.display.play_video()
+        interval = self._lcd_handler.display.interval
+        self._lcd_handler._animation_timer.start(interval)
+        self.uc_preview.set_playing(True)
+        self.uc_preview.show_video_controls(True)
+        self.uc_preview.set_status(f"Playing: {Path(path).name}")
+
     def _on_load_image_clicked(self):
         self._cut_mode = 'background'
         path, _ = QFileDialog.getOpenFileName(

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/qt_components/uc_about.py

@@ -65,7 +65,7 @@ def _make_desktop_entry() -> str:
 Type=Application
 Name=TRCC Linux
 Comment=Thermalright LCD Control Center
-Exec={exec_path} --last-one
+Exec={exec_path} gui --resume
 Icon=trcc
 Terminal=false
 Categories=Utility;System;

{trcc_linux-9.0.2 → trcc_linux-9.0.4}/src/trcc/services/device.py

@@ -289,6 +289,22 @@ class DeviceService:
                 data, w, h = self._send_queue.popleft()
                 self.send_rgb565(data, w, h)
 
+    def stop_send_worker(self, timeout: float = 2.0) -> None:
+        """Stop the async send worker and wait for any in-progress send to finish.
+
+        Must be called before send_rgb565() on shutdown so _send_busy is clear.
+        """
+        self._send_shutdown = True
+        self._send_queue.clear()
+        self._send_event.set()
+        if self._send_worker and self._send_worker.is_alive():
+            self._send_worker.join(timeout=timeout)
+        # Spin-wait for any in-progress send_rgb565 to release _send_busy
+        import time
+        deadline = time.monotonic() + timeout
+        while self._send_busy and time.monotonic() < deadline:
+            time.sleep(0.01)
+
     @property
     def is_busy(self) -> bool:
         """Check if a send is in progress."""