PyPI - trcc-linux - Versions diffs - 8.3.0__tar.gz → 8.3.2__tar.gz - Mend

trcc-linux 8.3.0tar.gz → 8.3.2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1070) hide show

{trcc_linux-8.3.0 → trcc_linux-8.3.2}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trcc-linux
-Version: 8.3.0
+Version: 8.3.2
 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
@@ -41,17 +41,22 @@ Requires-Dist: pygobject>=3.42.0; extra == 'all'
 Requires-Dist: pytest-cov>=4.0.0; extra == 'all'
 Requires-Dist: pytest>=7.0.0; extra == 'all'
 Requires-Dist: python-multipart>=0.0.6; extra == 'all'
+Requires-Dist: qrcode>=7.0; extra == 'all'
 Requires-Dist: ruff>=0.4.0; extra == 'all'
+Requires-Dist: types-qrcode>=7.0; extra == 'all'
 Provides-Extra: dev
 Requires-Dist: httpx>=0.24.0; extra == 'dev'
 Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
 Requires-Dist: python-multipart>=0.0.6; extra == 'dev'
 Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Requires-Dist: types-qrcode>=7.0; extra == 'dev'
 Provides-Extra: hid
 Requires-Dist: hidapi>=0.14.0; extra == 'hid'
 Provides-Extra: nvidia
 Requires-Dist: nvidia-ml-py>=11.0.0; extra == 'nvidia'
+Provides-Extra: remote
+Requires-Dist: qrcode>=7.0; extra == 'remote'
 Provides-Extra: wayland
 Requires-Dist: dbus-python>=1.3.0; extra == 'wayland'
 Requires-Dist: pygobject>=3.42.0; extra == 'wayland'
@@ -69,7 +74,7 @@ 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-4734_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
+[![Tests](https://img.shields.io/badge/tests-4784_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/)
@@ -169,7 +174,7 @@ Run `lsusb` to find your USB ID (`xxxx:xxxx` after `ID`), then match it below.
 |--------|---------|
 | `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) |
-> See the [full device list with protocol details](doc/SUPPORTED_DEVICES.md) and the [Device Testing Guide](doc/DEVICE_TESTING.md) if you have an untested device.
+> 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.
 ## Install
@@ -181,13 +186,13 @@ 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.3.0-1.fc43.noarch.rpm
+sudo dnf install https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux-8.3.1-1.fc43.noarch.rpm
 ```
 **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.3.0-1_all.deb
-sudo dpkg -i trcc-linux_8.3.0-1_all.deb
+curl -LO https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux_8.3.1-1_all.deb
+sudo dpkg -i trcc-linux_8.3.1-1_all.deb
 sudo apt-get install -f    # pulls in any missing dependencies
 ```
@@ -195,8 +200,8 @@ sudo apt-get install -f    # pulls in any missing dependencies
 **Arch / CachyOS / Manjaro / EndeavourOS / Garuda:**
 ```bash
-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
+curl -LO https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux-8.3.1-1-any.pkg.tar.zst
+sudo pacman -U trcc-linux-8.3.1-1-any.pkg.tar.zst
 ```
 **NixOS** — add to your `flake.nix` inputs:
@@ -246,7 +251,7 @@ trcc setup        # interactive wizard — udev rules, desktop entry
 Then **unplug and replug the USB cable** and run `trcc gui`.
-> `pipx` not installed? `sudo apt install pipx` (Debian/Ubuntu), `sudo dnf install pipx` (Fedora), `sudo pacman -S python-pipx` (Arch). See the **[Install Guide](doc/INSTALL_GUIDE.md)** for your distro.
+> `pipx` not installed? `sudo apt install pipx` (Debian/Ubuntu), `sudo dnf install pipx` (Fedora), `sudo pacman -S python-pipx` (Arch). See the **[Install Guide](doc/GUIDE_INSTALL.md)** for your distro.
 ### Automatic (git clone)
@@ -264,7 +269,7 @@ Fedora, Nobara, Ubuntu, Debian, Mint, Pop!_OS, Zorin, elementary OS, Arch, Manja
 > **`trcc: command not found`?** Open a new terminal — pip installs to `~/.local/bin` which needs a new shell session to appear on PATH.
-> See the **[Install Guide](doc/INSTALL_GUIDE.md)** for distro-specific instructions and troubleshooting.
+> See the **[Install Guide](doc/GUIDE_INSTALL.md)** for distro-specific instructions and troubleshooting.
 ## Usage
@@ -297,7 +302,7 @@ trcc setup                # Interactive setup wizard
 trcc uninstall            # Remove TRCC completely
 ```
-50 commands total — see the **[CLI Reference](doc/CLI_REFERENCE.md)** for the full list.
+50 commands total — see the **[CLI Reference](doc/REFERENCE_CLI.md)** for the full list.
 ### REST API
@@ -326,25 +331,25 @@ curl -X POST http://localhost:9876/led/color \
 | Document | Description |
 |----------|-------------|
-| [Install Guide](doc/INSTALL_GUIDE.md) | Installation for all major distros |
-| [CLI Reference](doc/CLI_REFERENCE.md) | All CLI commands with options and examples |
-| [API Reference](doc/API_REFERENCE.md) | All 43 REST API endpoints with request/response models |
-| [Troubleshooting](doc/TROUBLESHOOTING.md) | Common issues and fixes |
-| [New to Linux](doc/NEW_TO_LINUX.md) | Guide for Linux beginners |
+| [Install Guide](doc/GUIDE_INSTALL.md) | Installation for all major distros |
+| [CLI Reference](doc/REFERENCE_CLI.md) | All CLI commands with options and examples |
+| [API Reference](doc/REFERENCE_API.md) | All 43 REST API endpoints with request/response models |
+| [Troubleshooting](doc/GUIDE_TROUBLESHOOTING.md) | Common issues and fixes |
+| [New to Linux](doc/GUIDE_NEW_TO_LINUX.md) | Guide for Linux beginners |
 | [Changelog](doc/CHANGELOG.md) | Version history |
-| [Supported Devices](doc/SUPPORTED_DEVICES.md) | Full device list with USB IDs and protocols |
+| [Supported Devices](doc/REFERENCE_DEVICES.md) | Full device list with USB IDs and protocols |
 | [Testers Wanted](doc/TESTERS_WANTED.md) | Devices that need hardware validation |
-| [Device Testing Guide](doc/DEVICE_TESTING.md) | How to test and report device compatibility |
-| [Architecture](doc/ARCHITECTURE.md) | Project layout and design |
-| [Technical Reference](doc/TECHNICAL_REFERENCE.md) | SCSI protocol and file formats |
+| [Device Testing Guide](doc/GUIDE_DEVICE_TESTING.md) | How to test and report device compatibility |
+| [Architecture](doc/GUIDE_ARCHITECTURE.md) | Project layout and design |
+| [Technical Reference](doc/REFERENCE_TECHNICAL.md) | SCSI protocol and file formats |
 ### Protocol documentation (reverse-engineered from Windows TRCC)
 | Document | Description |
 |----------|-------------|
 | [USBLCD Protocol](doc/audit/USBLCD_PROTOCOL.md) | SCSI frame transfer protocol |
-| [USBLCDNEW Protocol](doc/audit/USBLCDNEW_PROTOCOL.md) | USB bulk/LY frame transfer protocol |
-| [USBLED Protocol](doc/audit/USBLED_PROTOCOL.md) | HID LED segment display protocol |
+| [USBLCDNEW Protocol](doc/PROTOCOL_USBLCDNEW.md) | USB bulk/LY frame transfer protocol |
+| [USBLED Protocol](doc/PROTOCOL_USBLED.md) | HID LED segment display protocol |
 ## Architecture

{trcc_linux-8.3.0 → trcc_linux-8.3.2}/README.md RENAMED Viewed

@@ -10,7 +10,7 @@
 [![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-4734_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
+[![Tests](https://img.shields.io/badge/tests-4784_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/)
@@ -110,7 +110,7 @@ Run `lsusb` to find your USB ID (`xxxx:xxxx` after `ID`), then match it below.
 |--------|---------|
 | `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) |
-> See the [full device list with protocol details](doc/SUPPORTED_DEVICES.md) and the [Device Testing Guide](doc/DEVICE_TESTING.md) if you have an untested device.
+> 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.
 ## Install
@@ -122,13 +122,13 @@ 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.3.0-1.fc43.noarch.rpm
+sudo dnf install https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux-8.3.1-1.fc43.noarch.rpm
 ```
 **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.3.0-1_all.deb
-sudo dpkg -i trcc-linux_8.3.0-1_all.deb
+curl -LO https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux_8.3.1-1_all.deb
+sudo dpkg -i trcc-linux_8.3.1-1_all.deb
 sudo apt-get install -f    # pulls in any missing dependencies
 ```
@@ -136,8 +136,8 @@ sudo apt-get install -f    # pulls in any missing dependencies
 **Arch / CachyOS / Manjaro / EndeavourOS / Garuda:**
 ```bash
-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
+curl -LO https://github.com/Lexonight1/thermalright-trcc-linux/releases/latest/download/trcc-linux-8.3.1-1-any.pkg.tar.zst
+sudo pacman -U trcc-linux-8.3.1-1-any.pkg.tar.zst
 ```
 **NixOS** — add to your `flake.nix` inputs:
@@ -187,7 +187,7 @@ trcc setup        # interactive wizard — udev rules, desktop entry
 Then **unplug and replug the USB cable** and run `trcc gui`.
-> `pipx` not installed? `sudo apt install pipx` (Debian/Ubuntu), `sudo dnf install pipx` (Fedora), `sudo pacman -S python-pipx` (Arch). See the **[Install Guide](doc/INSTALL_GUIDE.md)** for your distro.
+> `pipx` not installed? `sudo apt install pipx` (Debian/Ubuntu), `sudo dnf install pipx` (Fedora), `sudo pacman -S python-pipx` (Arch). See the **[Install Guide](doc/GUIDE_INSTALL.md)** for your distro.
 ### Automatic (git clone)
@@ -205,7 +205,7 @@ Fedora, Nobara, Ubuntu, Debian, Mint, Pop!_OS, Zorin, elementary OS, Arch, Manja
 > **`trcc: command not found`?** Open a new terminal — pip installs to `~/.local/bin` which needs a new shell session to appear on PATH.
-> See the **[Install Guide](doc/INSTALL_GUIDE.md)** for distro-specific instructions and troubleshooting.
+> See the **[Install Guide](doc/GUIDE_INSTALL.md)** for distro-specific instructions and troubleshooting.
 ## Usage
@@ -238,7 +238,7 @@ trcc setup                # Interactive setup wizard
 trcc uninstall            # Remove TRCC completely
 ```
-50 commands total — see the **[CLI Reference](doc/CLI_REFERENCE.md)** for the full list.
+50 commands total — see the **[CLI Reference](doc/REFERENCE_CLI.md)** for the full list.
 ### REST API
@@ -267,25 +267,25 @@ curl -X POST http://localhost:9876/led/color \
 | Document | Description |
 |----------|-------------|
-| [Install Guide](doc/INSTALL_GUIDE.md) | Installation for all major distros |
-| [CLI Reference](doc/CLI_REFERENCE.md) | All CLI commands with options and examples |
-| [API Reference](doc/API_REFERENCE.md) | All 43 REST API endpoints with request/response models |
-| [Troubleshooting](doc/TROUBLESHOOTING.md) | Common issues and fixes |
-| [New to Linux](doc/NEW_TO_LINUX.md) | Guide for Linux beginners |
+| [Install Guide](doc/GUIDE_INSTALL.md) | Installation for all major distros |
+| [CLI Reference](doc/REFERENCE_CLI.md) | All CLI commands with options and examples |
+| [API Reference](doc/REFERENCE_API.md) | All 43 REST API endpoints with request/response models |
+| [Troubleshooting](doc/GUIDE_TROUBLESHOOTING.md) | Common issues and fixes |
+| [New to Linux](doc/GUIDE_NEW_TO_LINUX.md) | Guide for Linux beginners |
 | [Changelog](doc/CHANGELOG.md) | Version history |
-| [Supported Devices](doc/SUPPORTED_DEVICES.md) | Full device list with USB IDs and protocols |
+| [Supported Devices](doc/REFERENCE_DEVICES.md) | Full device list with USB IDs and protocols |
 | [Testers Wanted](doc/TESTERS_WANTED.md) | Devices that need hardware validation |
-| [Device Testing Guide](doc/DEVICE_TESTING.md) | How to test and report device compatibility |
-| [Architecture](doc/ARCHITECTURE.md) | Project layout and design |
-| [Technical Reference](doc/TECHNICAL_REFERENCE.md) | SCSI protocol and file formats |
+| [Device Testing Guide](doc/GUIDE_DEVICE_TESTING.md) | How to test and report device compatibility |
+| [Architecture](doc/GUIDE_ARCHITECTURE.md) | Project layout and design |
+| [Technical Reference](doc/REFERENCE_TECHNICAL.md) | SCSI protocol and file formats |
 ### Protocol documentation (reverse-engineered from Windows TRCC)
 | Document | Description |
 |----------|-------------|
 | [USBLCD Protocol](doc/audit/USBLCD_PROTOCOL.md) | SCSI frame transfer protocol |
-| [USBLCDNEW Protocol](doc/audit/USBLCDNEW_PROTOCOL.md) | USB bulk/LY frame transfer protocol |
-| [USBLED Protocol](doc/audit/USBLED_PROTOCOL.md) | HID LED segment display protocol |
+| [USBLCDNEW Protocol](doc/PROTOCOL_USBLCDNEW.md) | USB bulk/LY frame transfer protocol |
+| [USBLED Protocol](doc/PROTOCOL_USBLED.md) | HID LED segment display protocol |
 ## Architecture

{trcc_linux-8.3.0 → trcc_linux-8.3.2}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 [project]
 name = "trcc-linux"
-version = "8.3.0"
+version = "8.3.2"
 description = "Linux implementation of Thermalright LCD Control Center"
 readme = "README.md"
 license = "GPL-3.0-or-later"
@@ -51,15 +51,19 @@ wayland = [
 hid = [
     "hidapi>=0.14.0",
 ]
+remote = [
+    "qrcode>=7.0",
+]
 dev = [
     "pytest>=7.0.0",
     "pytest-cov>=4.0.0",
     "ruff>=0.4.0",
     "httpx>=0.24.0",
     "python-multipart>=0.0.6",
+    "types-qrcode>=7.0",
 ]
 all = [
-    "trcc-linux[nvidia,wayland,hid,dev]",
+    "trcc-linux[nvidia,wayland,hid,remote,dev]",
 ]
 [project.urls]

{trcc_linux-8.3.0 → trcc_linux-8.3.2}/src/trcc/__version__.py RENAMED Viewed

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

trcc_linux-8.3.2/src/trcc/adapters/infra/network.py ADDED Viewed

@@ -0,0 +1,17 @@
+"""Network infrastructure — LAN IP detection for API server."""
+import socket
+def get_lan_ip() -> str:
+    """Auto-detect LAN IP by probing default route interface.
+    Opens a UDP socket to a public DNS (no data sent) to determine
+    which local interface the OS would route through.
+    """
+    try:
+        with socket.socket(socket.AF_INET, socket.SOCK_DGRAM) as s:
+            s.connect(("8.8.8.8", 80))
+            return s.getsockname()[0]
+    except OSError:
+        return "127.0.0.1"

{trcc_linux-8.3.0 → trcc_linux-8.3.2}/src/trcc/api/devices.py RENAMED Viewed

@@ -83,22 +83,22 @@ def select_device(device_id: int) -> dict:
     api.stop_video_playback()
     api.stop_overlay_loop()
-    # Check if GUI daemon is running — if so, route through IPC
-    from trcc.ipc import IPCClient
+    # Check if another instance (GUI) already owns the device
+    from trcc.core.instance import find_active
+    from trcc.ipc import create_lcd_proxy, create_led_proxy
-    if IPCClient.available():
-        from trcc.ipc import IPCDisplayProxy, IPCLEDProxy
+    active = find_active()
-        api._display_dispatcher = IPCDisplayProxy()
-        api._led_dispatcher = IPCLEDProxy()
+    if active is not None:
+        api._display_dispatcher = create_lcd_proxy(active)
+        api._led_dispatcher = create_led_proxy(active)
-        # Daemon already discovered resolution — sync it to DeviceInfo
-        # so static dirs mount correctly and response has real resolution
+        # Active instance already discovered resolution — sync to DeviceInfo
         proxy_res = api._display_dispatcher.resolution
         if proxy_res != (0, 0):
             dev.resolution = proxy_res
-        log.info("Using GUI daemon for device %s", dev.name)
+        log.info("Using %s instance for device %s", active.value, dev.name)
     else:
         # Standalone mode — API manages device directly
         _device_svc.on_frame_sent = api.set_current_image

{trcc_linux-8.3.0 → trcc_linux-8.3.2}/src/trcc/api/themes.py RENAMED Viewed

@@ -33,22 +33,6 @@ def _parse_resolution(resolution: str) -> tuple[int, int]:
     return w, h
-def _find_video_file(theme_path):
-    """Find first video/animation file in a theme directory."""
-    from pathlib import Path
-    p = Path(theme_path)
-    # Check Theme.zt first (Thermalright animation format)
-    zt = p / 'Theme.zt'
-    if zt.exists():
-        return zt
-    # Then check for video files
-    for ext in ('.mp4', '.avi', '.mkv', '.webm', '.gif'):
-        matches = list(p.glob(f'*{ext}'))
-        if matches:
-            return matches[0]
-    return None
 def _preview_url(theme_name: str, theme_dir: str) -> str:
     """Resolve preview URL for a local theme — Theme.png or 00.png fallback."""
@@ -202,77 +186,73 @@ def list_masks(resolution: str = "320x320") -> list[MaskResponse]:
 @router.post("/load")
 def load_theme(body: ThemeLoadRequest) -> dict:
-    """Load a theme by name and send to device."""
-    from trcc.api import _display_dispatcher
+    """Load a theme by name and send to device.
-    if not _display_dispatcher or not _display_dispatcher.connected:
-        raise HTTPException(status_code=409, detail="No LCD device selected. POST /devices/{id}/select first.")
+    Full pipeline matching GUI/CLI behavior:
+    1. Stop any running video/overlay
+    2. load_theme_by_name() → select + send + persist
+    3. Start video playback for animated themes
+    4. Start overlay loop for themes with config1.dc
+    5. Update preview image for WebSocket stream
-    from pathlib import Path
+    Works in both standalone and IPC (GUI daemon) modes.
+    In IPC mode, the GUI daemon handles the full pipeline.
+    """
+    import trcc.api as api
+    from trcc.api.models import dispatch_result
-    from trcc.adapters.infra.data_repository import ThemeDir
-    from trcc.services import ImageService
+    if not api._display_dispatcher or not api._display_dispatcher.connected:
+        raise HTTPException(status_code=409, detail="No LCD device selected. POST /devices/{id}/select first.")
-    lcd = _display_dispatcher
-    w, h = lcd.resolution  # type: ignore[union-attr]
+    api.stop_video_playback()
+    api.stop_overlay_loop()
-    # Resolve resolution from request or device
+    w, h = 0, 0
     if body.resolution:
         w, h = _parse_resolution(body.resolution)
-    theme_dir = Path(str(ThemeDir.for_resolution(w, h)))
-    themes = ThemeService.discover_local(theme_dir, (w, h))
-    match = next((t for t in themes if t.name == body.name), None)
-    if not match:
-        raise HTTPException(status_code=404, detail=f"Theme '{body.name}' not found")
-    from trcc.api import (
-        _device_svc,
-        start_overlay_loop,
-        start_video_playback,
-        stop_overlay_loop,
-        stop_video_playback,
-    )
+    result = api._display_dispatcher.load_theme_by_name(body.name, w, h)
+    if not result.get("success"):
+        return dispatch_result(result)
-    # Stop any running video/overlay before loading a new theme
-    stop_video_playback()
-    stop_overlay_loop()
+    # Update preview image for WebSocket stream
+    image = result.get("image")
+    if image:
+        api.set_current_image(image)
-    theme_path = theme_dir / match.name
+    # Standalone mode — start video/overlay loops (GUI handles its own)
+    is_animated = result.get("is_animated", False)
+    theme_path = result.get("theme_path")
+    config_path = result.get("config_path")
-    # Check for animated theme (video files)
-    video_file = _find_video_file(theme_path)
-    if match.is_animated and video_file:
-        ok = start_video_playback(str(video_file), w, h, loop=True)
-        if not ok:
-            raise HTTPException(status_code=500, detail="Failed to start video playback")
-        return {"success": True, "theme": body.name, "resolution": (w, h), "animated": True}
-    # Static theme — load first image and send
-    img_file = theme_path / "01.png"
-    if not img_file.exists():
-        img_file = next(theme_path.glob("*.png"), None)
-        if not img_file:
-            img_file = next(theme_path.glob("*.jpg"), None)
-    if not img_file:
-        raise HTTPException(status_code=404, detail=f"No image file in theme '{body.name}'")
-    img = ImageService.open_and_resize(img_file, w, h)
-    ok = _device_svc.send_pil(img, w, h)
-    if not ok:
-        raise HTTPException(status_code=500, detail="Send failed (device busy or error)")
-    # Start overlay metrics loop if theme has overlay config
-    from trcc.core.models import ThemeDir
-    td = ThemeDir(theme_path)
-    dc_path = td.dc if td.dc.exists() else None
-    if dc_path is None and td.json.exists():
-        dc_path = td.json  # config.json also triggers overlay
-    if dc_path:
-        start_overlay_loop(img, str(dc_path), w, h)
-    return {"success": True, "theme": body.name, "resolution": (w, h)}
+    if not w or not h:
+        res = getattr(api._display_dispatcher, 'resolution', None)
+        if res:
+            w, h = res
+        else:
+            w, h = getattr(api._display_dispatcher, 'lcd_size', (320, 320))
+    if is_animated and theme_path:
+        # Find video file (Theme.zt or .mp4)
+        from pathlib import Path
+        theme_dir = Path(str(theme_path))
+        video_path = None
+        for ext in ('.zt', '.mp4'):
+            for name in ('Theme', 'theme'):
+                candidate = theme_dir / f"{name}{ext}"
+                if candidate.exists():
+                    video_path = str(candidate)
+                    break
+            if video_path:
+                break
+        if video_path:
+            api.start_video_playback(video_path, w, h, loop=True)
+    elif config_path and os.path.isfile(config_path) and image:
+        # Static theme with overlay config — start metrics loop
+        api.start_overlay_loop(image, str(config_path), w, h)
+    return dispatch_result(result)
 @router.post("/save")

{trcc_linux-8.3.0 → trcc_linux-8.3.2}/src/trcc/cli/__init__.py RENAMED Viewed

@@ -728,10 +728,10 @@ def _cmd_perf(
     _ensure_renderer()
     if device:
-        from trcc.ipc import IPCClient
+        from trcc.core.instance import InstanceKind, find_active
         from trcc.services.perf import run_device_benchmarks
-        gui_running = IPCClient.available()
+        gui_running = find_active() == InstanceKind.GUI
         if gui_running:
             print("GUI daemon detected — pausing display refresh...")
         print("Running device I/O benchmarks (this takes ~10s)...")
@@ -857,10 +857,35 @@ def _cmd_serve(
     scheme = "https" if ssl_kwargs else "http"
     print(f"Serving on {scheme}://{host}:{port}")
+    _print_serve_qr(host, port, token, bool(ssl_kwargs))
     uvicorn.run(api_app, host=host, port=port, **ssl_kwargs)
     return 0
+def _print_serve_qr(host: str, port: int, token: Optional[str], tls: bool) -> None:
+    """Print a terminal QR code with connection details for remote apps.
+    Presentation-only — delegates to ServerInfo (DTO) for payload and
+    adapters.infra.network for LAN IP detection.
+    """
+    try:
+        import qrcode  # pyright: ignore[reportMissingImports]
+    except ImportError:
+        return
+    from trcc.adapters.infra.network import get_lan_ip
+    from trcc.core.models import ServerInfo
+    display_host = get_lan_ip() if host in ("0.0.0.0", "::") else host
+    info = ServerInfo(host=display_host, port=port, token=token or "", tls=tls)
+    qr = qrcode.QRCode(error_correction=qrcode.ERROR_CORRECT_L, border=1)
+    qr.add_data(info.to_json())
+    qr.make(fit=True)
+    qr.print_ascii(invert=True)
+    print(f"Scan to connect: {display_host}:{port}")
 def _ensure_self_signed_cert() -> Optional[tuple[str, str]]:
     """Auto-generate a self-signed TLS cert in ~/.trcc/tls/ if missing."""
     import shutil

{trcc_linux-8.3.0 → trcc_linux-8.3.2}/src/trcc/cli/_display.py RENAMED Viewed

@@ -21,18 +21,22 @@ from trcc.core.models import parse_hex_color as _parse_hex
 def _connect_or_fail(device: str | None = None) -> tuple[LCDDevice, int]:
     """Create device, connect. Returns (device, exit_code).
-    When the GUI daemon is running and no explicit device path is given,
-    returns an IPC proxy that routes all commands through the daemon.
+    Composition root: injects instance detection (find_active) and proxy
+    factory so core routes through GUI/API if one is already running.
     """
-    if device is None:
-        from trcc.ipc import IPCClient, IPCDisplayProxy
-        if IPCClient.available():
-            return IPCDisplayProxy(), 0  # type: ignore[return-value]
-    lcd = LCDDevice()
+    from trcc.core.instance import find_active
+    from trcc.ipc import create_lcd_proxy
+    lcd = LCDDevice(
+        find_active_fn=find_active,
+        proxy_factory_fn=create_lcd_proxy,
+    )
     result = lcd.connect(device)
     if not result["success"]:
         print(result["error"])
         return lcd, 1
+    if result.get("proxy"):
+        print(f"Routing through {result['proxy'].value} instance")
     return lcd, 0

{trcc_linux-8.3.0 → trcc_linux-8.3.2}/src/trcc/cli/_led.py RENAMED Viewed

@@ -16,18 +16,23 @@ from trcc.core.models import parse_hex_color as _parse_hex
 def _connect_or_fail() -> tuple[LEDDevice, int]:
     """Create device, connect. Returns (device, exit_code).
-    When the GUI daemon is running, returns an IPC proxy that routes
-    all commands through the daemon.
+    Composition root: injects instance detection (find_active) and proxy
+    factory so core routes through GUI/API if one is already running.
     """
-    from trcc.ipc import IPCClient, IPCLEDProxy
-    if IPCClient.available():
-        return IPCLEDProxy(), 0  # type: ignore[return-value]
-    led = LEDDevice()
+    from trcc.core.instance import find_active
+    from trcc.ipc import create_led_proxy
+    led = LEDDevice(
+        find_active_fn=find_active,
+        proxy_factory_fn=create_led_proxy,
+    )
     result = led.connect()
     if not result["success"]:
         print("No LED device found.")
         return led, 1
-    if result.get("status"):
+    if result.get("proxy"):
+        print(f"Routing through {result['proxy'].value} instance")
+    elif result.get("status"):
         print(result["status"])
     return led, 0

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

trcc-linux 8.3.0tar.gz → 8.3.2tar.gz