trcc-linux 8.2.9__tar.gz → 8.3.0__tar.gz

{trcc_linux-8.2.9 → trcc_linux-8.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trcc-linux
-Version: 8.2.9
+Version: 8.3.0
 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
@@ -69,8 +69,8 @@ Description-Content-Type: text/markdown
 [![Platform](https://img.shields.io/badge/platform-Linux-FCC624?logo=linux&logoColor=black)](https://github.com/Lexonight1/thermalright-trcc-linux)
 
 [![CI](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml/badge.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
-[![Tests](https://img.shields.io/badge/tests-4658_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
-[![Coverage](https://img.shields.io/badge/coverage-74%25-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
+[![Tests](https://img.shields.io/badge/tests-4734_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
+[![Coverage](https://img.shields.io/badge/coverage-73%25-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
 [![Python](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://python.org)
 [![Code Style](https://img.shields.io/badge/code_style-ruff-D7FF64?logo=ruff&logoColor=black)](https://docs.astral.sh/ruff/)
 [![Type Check](https://img.shields.io/badge/type_check-pyright-blue?logo=python&logoColor=white)](https://microsoft.github.io/pyright/)
@@ -133,7 +133,7 @@ Run `trcc report` and [paste the output in an issue](https://github.com/Lexonigh
 | **Multi-device** | Per-device config, auto-detect, multi-device with device selection |
 | **Security** | udev rules, polkit policy, SELinux support, no root required after setup |
 
-**Under the hood**: 106 source files, ~38K lines of Python, 4112 tests across 57 test files in 9 directories. Hexagonal architecture with strict dependency injection — GUI, CLI, and API all talk to the same core services. 6 USB protocols reverse-engineered from the Windows C# app.
+**Under the hood**: 106 source files, ~38K lines of Python, 4741 tests across 57 test files in 9 directories. Hexagonal architecture with strict dependency injection — GUI, CLI, and API all talk to the same core services. 6 USB protocols reverse-engineered from the Windows C# app.
 
 ## Supported Devices
 
@@ -181,19 +181,22 @@ Pre-built packages are available for every major distro. No pip, no venv, no PEP
 
 **Fedora / openSUSE / Nobara:**
 ```bash
-sudo dnf install https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux-8.2.9-1.fc43.noarch.rpm
+sudo dnf install https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux-8.3.0-1.fc43.noarch.rpm
 ```
 
-**Ubuntu / Debian / Mint / Pop!_OS / Zorin:**
+**Ubuntu 24.04+ / Debian 13+ / Mint 22+ / Pop!_OS 24.04+ / Zorin 17+:**
 ```bash
-curl -LO https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux_8.2.9-1_all.deb
-sudo dpkg -i trcc-linux_8.2.9-1_all.deb
+curl -LO https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux_8.3.0-1_all.deb
+sudo dpkg -i trcc-linux_8.3.0-1_all.deb
 sudo apt-get install -f    # pulls in any missing dependencies
 ```
 
+> **Older versions** (Ubuntu 22.04, Mint 21.x, etc.) don't have `python3-pyside6` and other deps in their repos. Use `pipx` instead — see [PyPI install](#pypi) below.
+
 **Arch / CachyOS / Manjaro / EndeavourOS / Garuda:**
 ```bash
-sudo pacman -U https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux-8.2.9-1-any.pkg.tar.zst
+curl -LO https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux-8.3.0-1-any.pkg.tar.zst
+sudo pacman -U trcc-linux-8.3.0-1-any.pkg.tar.zst
 ```
 
 **NixOS** — add to your `flake.nix` inputs:
@@ -229,9 +232,16 @@ 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.
+
 ```bash
+# Install system dependencies first
+sudo apt install pipx libusb-1.0-0 sg3-utils p7zip-full libxcb-cursor0  # Debian/Ubuntu/Mint
+sudo dnf install pipx libusb-1.0.0 sg3_utils p7zip                      # Fedora
+
+# Install trcc-linux
 pipx install trcc-linux
-trcc setup        # interactive wizard — deps, udev, desktop entry
+trcc setup        # interactive wizard — udev rules, desktop entry
 ```
 
 Then **unplug and replug the USB cable** and run `trcc gui`.

{trcc_linux-8.2.9 → trcc_linux-8.3.0}/README.md

@@ -10,8 +10,8 @@
 [![Platform](https://img.shields.io/badge/platform-Linux-FCC624?logo=linux&logoColor=black)](https://github.com/Lexonight1/thermalright-trcc-linux)
 
 [![CI](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml/badge.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
-[![Tests](https://img.shields.io/badge/tests-4658_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
-[![Coverage](https://img.shields.io/badge/coverage-74%25-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
+[![Tests](https://img.shields.io/badge/tests-4734_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
+[![Coverage](https://img.shields.io/badge/coverage-73%25-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
 [![Python](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://python.org)
 [![Code Style](https://img.shields.io/badge/code_style-ruff-D7FF64?logo=ruff&logoColor=black)](https://docs.astral.sh/ruff/)
 [![Type Check](https://img.shields.io/badge/type_check-pyright-blue?logo=python&logoColor=white)](https://microsoft.github.io/pyright/)
@@ -74,7 +74,7 @@ Run `trcc report` and [paste the output in an issue](https://github.com/Lexonigh
 | **Multi-device** | Per-device config, auto-detect, multi-device with device selection |
 | **Security** | udev rules, polkit policy, SELinux support, no root required after setup |
 
-**Under the hood**: 106 source files, ~38K lines of Python, 4112 tests across 57 test files in 9 directories. Hexagonal architecture with strict dependency injection — GUI, CLI, and API all talk to the same core services. 6 USB protocols reverse-engineered from the Windows C# app.
+**Under the hood**: 106 source files, ~38K lines of Python, 4741 tests across 57 test files in 9 directories. Hexagonal architecture with strict dependency injection — GUI, CLI, and API all talk to the same core services. 6 USB protocols reverse-engineered from the Windows C# app.
 
 ## Supported Devices
 
@@ -122,19 +122,22 @@ Pre-built packages are available for every major distro. No pip, no venv, no PEP
 
 **Fedora / openSUSE / Nobara:**
 ```bash
-sudo dnf install https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux-8.2.9-1.fc43.noarch.rpm
+sudo dnf install https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux-8.3.0-1.fc43.noarch.rpm
 ```
 
-**Ubuntu / Debian / Mint / Pop!_OS / Zorin:**
+**Ubuntu 24.04+ / Debian 13+ / Mint 22+ / Pop!_OS 24.04+ / Zorin 17+:**
 ```bash
-curl -LO https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux_8.2.9-1_all.deb
-sudo dpkg -i trcc-linux_8.2.9-1_all.deb
+curl -LO https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux_8.3.0-1_all.deb
+sudo dpkg -i trcc-linux_8.3.0-1_all.deb
 sudo apt-get install -f    # pulls in any missing dependencies
 ```
 
+> **Older versions** (Ubuntu 22.04, Mint 21.x, etc.) don't have `python3-pyside6` and other deps in their repos. Use `pipx` instead — see [PyPI install](#pypi) below.
+
 **Arch / CachyOS / Manjaro / EndeavourOS / Garuda:**
 ```bash
-sudo pacman -U https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux-8.2.9-1-any.pkg.tar.zst
+curl -LO https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux-8.3.0-1-any.pkg.tar.zst
+sudo pacman -U trcc-linux-8.3.0-1-any.pkg.tar.zst
 ```
 
 **NixOS** — add to your `flake.nix` inputs:
@@ -170,9 +173,16 @@ 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.
+
 ```bash
+# Install system dependencies first
+sudo apt install pipx libusb-1.0-0 sg3-utils p7zip-full libxcb-cursor0  # Debian/Ubuntu/Mint
+sudo dnf install pipx libusb-1.0.0 sg3_utils p7zip                      # Fedora
+
+# Install trcc-linux
 pipx install trcc-linux
-trcc setup        # interactive wizard — deps, udev, desktop entry
+trcc setup        # interactive wizard — udev rules, desktop entry
 ```
 
 Then **unplug and replug the USB cable** and run `trcc gui`.

{trcc_linux-8.2.9 → trcc_linux-8.3.0}/pyproject.toml

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

{trcc_linux-8.2.9 → trcc_linux-8.3.0}/src/trcc/__version__.py

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

{trcc_linux-8.2.9 → trcc_linux-8.3.0}/src/trcc/api/system.py

@@ -63,3 +63,21 @@ def get_report() -> dict:
     rpt = DebugReport()
     rpt.collect()
     return {"report": str(rpt)}
+
+
+@router.get("/perf")
+def get_perf() -> dict:
+    """Run CPU + memory performance benchmarks."""
+    from trcc.services.perf import run_benchmarks
+
+    report = run_benchmarks()
+    return report.to_dict()
+
+
+@router.get("/perf/device")
+def get_perf_device() -> dict:
+    """Benchmark connected hardware (USB handshake, frame latency, FPS)."""
+    from trcc.services.perf import run_device_benchmarks
+
+    report = run_device_benchmarks()
+    return report.to_dict()

{trcc_linux-8.2.9 → trcc_linux-8.3.0}/src/trcc/cli/__init__.py

@@ -26,9 +26,18 @@ import typer
 # =========================================================================
 
 def _ensure_renderer() -> None:
-    """Initialize ImageService renderer for CLI (once)."""
+    """Initialize ImageService renderer for CLI (once).
+
+    QtRenderer requires a QApplication/QCoreApplication to exist
+    (for QFontDatabase, QImage, etc.). Create one if needed.
+    """
     from trcc.services.image import ImageService
     if ImageService._renderer is None:
+        import os
+        os.environ.setdefault('QT_QPA_PLATFORM', 'offscreen')
+        from PySide6.QtWidgets import QApplication
+        if QApplication.instance() is None:
+            QApplication([])
         from trcc.adapters.render.qt import QtRenderer
         ImageService.set_renderer(QtRenderer())
 
@@ -709,6 +718,40 @@ def _cmd_doctor() -> int:
     return run_doctor()
 
 
+@app.command("perf")
+def _cmd_perf(
+    device: Annotated[bool, typer.Option(
+        "--device", "-d", help="Benchmark connected hardware (USB I/O latency, FPS)",
+    )] = False,
+) -> int:
+    """Run CPU + memory performance benchmarks."""
+    _ensure_renderer()
+
+    if device:
+        from trcc.ipc import IPCClient
+        from trcc.services.perf import run_device_benchmarks
+
+        gui_running = IPCClient.available()
+        if gui_running:
+            print("GUI daemon detected — pausing display refresh...")
+        print("Running device I/O benchmarks (this takes ~10s)...")
+        report = run_device_benchmarks()
+        if gui_running:
+            print("GUI display refresh resumed.")
+        if not report.has_data:
+            print("No devices found. Connect a device and try again.")
+            return 1
+    else:
+        from trcc.services.perf import run_benchmarks
+
+        print("Running performance benchmarks...")
+        report = run_benchmarks()
+
+    for line in report.format_report():
+        print(line)
+    return 0 if report.all_passed else 1
+
+
 @app.command("setup")
 def _cmd_setup(
     yes: Annotated[bool, typer.Option(

trcc_linux-8.3.0/src/trcc/core/perf.py

@@ -0,0 +1,196 @@
+"""Performance report domain object — pure data + formatting, zero deps."""
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+
+@dataclass
+class PerfEntry:
+    """Single performance measurement."""
+    label: str
+    actual: float
+    limit: float
+
+    @property
+    def headroom_pct(self) -> float:
+        return (1 - self.actual / self.limit) * 100 if self.limit > 0 else 0
+
+    @property
+    def passed(self) -> bool:
+        return self.actual < self.limit
+
+
+@dataclass
+class PerfReport:
+    """Collects performance measurements and formats a Valgrind-style report."""
+
+    cpu: list[PerfEntry] = field(default_factory=list)
+    mem: list[PerfEntry] = field(default_factory=list)
+    scale: list[PerfEntry] = field(default_factory=list)
+    device: list[PerfEntry] = field(default_factory=list)
+    failed: int = 0
+    total: int = 0
+
+    def record_cpu(self, label: str, actual_s: float, limit_s: float) -> None:
+        self.cpu.append(PerfEntry(label, actual_s, limit_s))
+
+    def record_mem(self, label: str, actual_bytes: float, limit_bytes: float) -> None:
+        self.mem.append(PerfEntry(label, actual_bytes, limit_bytes))
+
+    def record_scale(self, label: str, ratio: float, limit: float) -> None:
+        self.scale.append(PerfEntry(label, ratio, limit))
+
+    def record_device(self, label: str, actual: float, limit: float) -> None:
+        self.device.append(PerfEntry(label, actual, limit))
+
+    @property
+    def has_data(self) -> bool:
+        return bool(self.cpu or self.mem or self.scale or self.device)
+
+    @property
+    def all_passed(self) -> bool:
+        entries = self.cpu + self.mem + self.scale + self.device
+        return all(e.passed for e in entries)
+
+    def to_dict(self) -> dict:
+        """Serialize for API JSON response."""
+        def _entry(e: PerfEntry) -> dict:
+            return {
+                "label": e.label,
+                "actual": e.actual,
+                "limit": e.limit,
+                "headroom_pct": round(e.headroom_pct, 1),
+                "passed": e.passed,
+            }
+        return {
+            "cpu": [_entry(e) for e in sorted(self.cpu, key=lambda x: -x.actual)],
+            "memory": [_entry(e) for e in sorted(self.mem, key=lambda x: -x.actual)],
+            "scaling": [_entry(e) for e in sorted(self.scale, key=lambda x: -x.actual)],
+            "device": [_entry(e) for e in sorted(self.device, key=lambda x: -x.actual)],
+            "summary": {
+                "total": len(self.cpu) + len(self.mem) + len(self.scale) + len(self.device),
+                "cpu_count": len(self.cpu),
+                "memory_count": len(self.mem),
+                "scaling_count": len(self.scale),
+                "device_count": len(self.device),
+                "all_passed": self.all_passed,
+            },
+        }
+
+    def format_report(self) -> list[str]:
+        """Format as Valgrind-style terminal report."""
+        lines: list[str] = []
+        w = 78
+
+        lines.append("=" * w)
+        lines.append("TRCC PERFORMANCE REPORT")
+        lines.append("=" * w)
+
+        if self.cpu:
+            lines.append("")
+            lines.append("-" * w)
+            lines.append(f"{'CPU TIME':^{w}}")
+            lines.append("-" * w)
+            lines.append(
+                f"  {'Test':<44} {'Actual':>10} {'Limit':>10} {'Headroom':>10}")
+            lines.append(
+                f"  {'----':<44} {'------':>10} {'-----':>10} {'-------':>10}")
+            for e in sorted(self.cpu, key=lambda x: -x.actual):
+                a_ms = e.actual * 1000
+                l_ms = e.limit * 1000
+                a_str = (f"{a_ms:.2f} ms" if a_ms >= 0.1
+                         else f"{a_ms * 1000:.0f} us")
+                l_str = (f"{l_ms:.2f} ms" if l_ms >= 0.1
+                         else f"{l_ms * 1000:.0f} us")
+                bar = _bar(e.actual, e.limit)
+                lines.append(
+                    f"  {e.label:<44} {a_str:>10} {l_str:>10}"
+                    f" {e.headroom_pct:>7.0f}%  {bar}")
+
+        if self.mem:
+            lines.append("")
+            lines.append("-" * w)
+            lines.append(f"{'MEMORY':^{w}}")
+            lines.append("-" * w)
+            lines.append(
+                f"  {'Test':<44} {'Growth':>10} {'Limit':>10} {'Headroom':>10}")
+            lines.append(
+                f"  {'----':<44} {'------':>10} {'-----':>10} {'-------':>10}")
+            for e in sorted(self.mem, key=lambda x: -x.actual):
+                a_str = _fmt_bytes(int(e.actual))
+                l_str = _fmt_bytes(int(e.limit))
+                bar = _bar(e.actual, e.limit)
+                lines.append(
+                    f"  {e.label:<44} {a_str:>10} {l_str:>10}"
+                    f" {e.headroom_pct:>7.0f}%  {bar}")
+
+        if self.scale:
+            lines.append("")
+            lines.append("-" * w)
+            lines.append(f"{'SCALING (lower ratio = more linear)':^{w}}")
+            lines.append("-" * w)
+            lines.append(
+                f"  {'Test':<44} {'Ratio':>10} {'Limit':>10} {'Headroom':>10}")
+            lines.append(
+                f"  {'----':<44} {'------':>10} {'-----':>10} {'-------':>10}")
+            for e in sorted(self.scale, key=lambda x: -x.actual):
+                bar = _bar(e.actual, e.limit)
+                lines.append(
+                    f"  {e.label:<44} {e.actual:>9.1f}x {e.limit:>9.1f}x"
+                    f" {e.headroom_pct:>7.0f}%  {bar}")
+
+        if self.device:
+            lines.append("")
+            lines.append("-" * w)
+            lines.append(f"{'DEVICE I/O':^{w}}")
+            lines.append("-" * w)
+            lines.append(
+                f"  {'Test':<44} {'Actual':>10} {'Limit':>10} {'Headroom':>10}")
+            lines.append(
+                f"  {'----':<44} {'------':>10} {'-----':>10} {'-------':>10}")
+            for e in sorted(self.device, key=lambda x: -x.actual):
+                a_ms = e.actual * 1000
+                l_ms = e.limit * 1000
+                a_str = (f"{a_ms:.1f} ms" if a_ms >= 1.0
+                         else f"{a_ms * 1000:.0f} us")
+                l_str = (f"{l_ms:.1f} ms" if l_ms >= 1.0
+                         else f"{l_ms * 1000:.0f} us")
+                bar = _bar(e.actual, e.limit)
+                lines.append(
+                    f"  {e.label:<44} {a_str:>10} {l_str:>10}"
+                    f" {e.headroom_pct:>7.0f}%  {bar}")
+
+        lines.append("")
+        lines.append("=" * w)
+        total = len(self.cpu) + len(self.mem) + len(self.scale) + len(self.device)
+        parts = []
+        if self.cpu:
+            parts.append(f"{len(self.cpu)} cpu")
+        if self.mem:
+            parts.append(f"{len(self.mem)} memory")
+        if self.scale:
+            parts.append(f"{len(self.scale)} scaling")
+        if self.device:
+            parts.append(f"{len(self.device)} device")
+        status = "ALL PASSED" if self.all_passed else "FAILURES DETECTED"
+        lines.append(
+            f"  {total} measurements: {', '.join(parts)} — {status}")
+        lines.append("=" * w)
+        return lines
+
+
+def _bar(actual: float, limit: float, width: int = 10) -> str:
+    """Render a usage bar: [####------]."""
+    if limit <= 0:
+        return ""
+    fill = min(int(actual / limit * width), width)
+    return "[" + "#" * fill + "-" * (width - fill) + "]"
+
+
+def _fmt_bytes(n: int) -> str:
+    """Format bytes as human-readable."""
+    if abs(n) < 1024:
+        return f"{n} B"
+    if abs(n) < 1024 * 1024:
+        return f"{n / 1024:.1f} KB"
+    return f"{n / (1024 * 1024):.2f} MB"

{trcc_linux-8.2.9 → trcc_linux-8.3.0}/src/trcc/ipc.py

@@ -178,6 +178,10 @@ class IPCServer:
         if domain == "display":
             if method == "get_frame":
                 return self._get_frame()
+            if method == "pause":
+                return self._pause_display()
+            if method == "resume":
+                return self._resume_display()
             route = _DISPLAY_ROUTES.get(method)
             if not route:
                 return {"success": False, "error": f"Unknown command: {cmd}"}
@@ -196,6 +200,22 @@ class IPCServer:
 
         return {"success": False, "error": f"Unknown domain: {domain}"}
 
+    def _pause_display(self) -> dict:
+        """Pause LCD frame sending (for exclusive device access)."""
+        if not self._display or not self._display.connected:
+            return {"success": True, "message": "No LCD connected"}
+        self._display.auto_send = False
+        log.info("IPC: display paused (auto_send=False)")
+        return {"success": True, "message": "Display paused"}
+
+    def _resume_display(self) -> dict:
+        """Resume LCD frame sending after pause."""
+        if not self._display or not self._display.connected:
+            return {"success": True, "message": "No LCD connected"}
+        self._display.auto_send = True
+        log.info("IPC: display resumed (auto_send=True)")
+        return {"success": True, "message": "Display resumed"}
+
     def _get_frame(self) -> dict:
         """Return the current LCD frame as base64 JPEG."""
         import base64

{trcc_linux-8.2.9 → trcc_linux-8.3.0}/src/trcc/qt_components/lcd_handler.py

@@ -92,7 +92,9 @@ class LCDHandler:
             self._w['image_cut'].set_resolution(w, h)
             self._w['video_cut'].set_resolution(w, h)
             self._w['theme_setting'].set_resolution(w, h)
-            self._update_theme_directories()
+
+        # Always refresh — first run downloads themes after widget init
+        self._update_theme_directories()
 
         # Restore per-device settings
         cfg = Settings.get_device_config(self._device_key)