TRCC Linux

If this project helped you, consider

Native Linux port of the Thermalright LCD Control Center (Windows TRCC 2.0.3). Control and customize the LCD displays on Thermalright CPU coolers, AIO pump heads, and fan hubs — entirely from Linux.

Unofficial community project, not affiliated with Thermalright. I develop and test on Fedora — if something doesn't work on your distro, please open an issue.

Testers Wanted

I don't own every Thermalright device — ~31 models need real hardware validation. Testing takes 30 seconds: run trcc report and paste the output in an issue. See the full list of devices that need testers.

Features

• Themes — Local, cloud, masks, carousel mode, export/import as .tr files
• Media — Video/GIF playback, video trimmer, image cropper, screen cast (X11 + Wayland)
• Editor — Overlay text/sensors/date/time, font picker, dynamic scaling, color picker
• Hardware — 77+ sensors, customizable dashboard, multi-device with per-device config, RGB LED control
• Display — 15 resolutions (240x240 to 1920x462), 0/90/180/270 rotation, 3 brightness levels
• Extras — 5 starter themes + 120 masks per resolution, on-demand download, system tray, auto-start

Supported Devices

Run lsusb to find your USB ID (xxxx:xxxx after ID), then match it below.

SCSI devices — fully supported:

USB ID	Devices
87CD:70DB	FROZEN HORIZON PRO, FROZEN MAGIC PRO, FROZEN VISION V2, CORE VISION, ELITE VISION, AK120, AX120, PA120 DIGITAL, Wonder Vision
0416:5406	LC1, LC2, LC3, LC5 (AIO pump heads)
0402:3922	FROZEN WARFRAME, FROZEN WARFRAME SE

HID LCD devices — auto-detected, needs hardware testers:

USB ID	Devices
0416:5302	AS120 VISION, BA120 VISION, FROZEN WARFRAME, FROZEN WARFRAME SE, FROZEN WARFRAME PRO, ELITE VISION, LC5
0418:5303	TARAN ARMS
0418:5304	TARAN ARMS

HID LED devices — RGB LED control:

USB ID	Devices
0416:8001	AX120 DIGITAL, PA120 DIGITAL, Peerless Assassin 120 DIGITAL, HR10 2280 PRO DIGITAL, and others (model auto-detected via handshake)

HID devices are auto-detected. See the Device Testing Guide if you have one — I need testers.

Install

Quick install (PyPI)

pip install trcc-linux
sudo trcc setup-udev

Then unplug and replug the USB cable and run trcc gui.

Automatic (recommended for full setup)

git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git
cd thermalright-trcc-linux
sudo ./install.sh

Detects your distro, installs system packages, Python deps, udev rules, and desktop shortcut. On PEP 668 distros (Ubuntu 24.04+, Fedora 41+) it auto-falls back to a virtual environment if pip refuses direct install.

After it finishes: unplug and replug the USB cable, then run trcc gui.

Manual one-liners

Find your distro, copy the block, paste in terminal. After it finishes: unplug and replug the USB cable, then open a new terminal and run trcc gui.

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 for troubleshooting, optional deps, and 25+ distros step by step.

Fedora / Nobara

sudo dnf install sg3_utils python3-pyqt6 ffmpeg && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop

Ubuntu / Debian / Mint / Pop!_OS / Zorin / elementary OS

sudo apt install sg3-utils python3-pyqt6 ffmpeg python3-pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop

Arch / Manjaro / EndeavourOS / CachyOS / Garuda

sudo pacman -S sg3_utils python-pyqt6 ffmpeg python-pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop

openSUSE

sudo zypper install sg3_utils python3-qt6 ffmpeg python3-pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop

Void Linux

sudo xbps-install sg3_utils python3-PyQt6 ffmpeg python3-pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop

Gentoo

sudo emerge --ask sg3_utils dev-python/PyQt6 media-video/ffmpeg dev-python/pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop

Alpine

sudo apk add sg3_utils py3-pyqt6 ffmpeg py3-pip python3 && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop

Bazzite / Fedora Atomic / Aurora / Bluefin

rpm-ostree install sg3_utils && echo "Reboot now, then run the next block" && systemctl reboot

After reboot:

python3 -m venv ~/trcc-env && source ~/trcc-env/bin/activate && pip install trcc-linux && sudo trcc setup-udev && trcc install-desktop

Launch: source ~/trcc-env/bin/activate && trcc gui

SteamOS (Steam Deck)

Switch to Desktop Mode, open Konsole:

sudo steamos-readonly disable && sudo pacman -S --needed sg3_utils python-pip python-pyqt6 ffmpeg && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop && sudo steamos-readonly enable

NixOS

Add to /etc/nixos/configuration.nix, then sudo nixos-rebuild switch:

environment.systemPackages = with pkgs; [
  python3 python3Packages.pip python3Packages.pyqt6 python3Packages.pillow
  python3Packages.psutil sg3_utils ffmpeg p7zip
];
services.udev.extraRules = ''
  SUBSYSTEM=="scsi_generic", ATTRS{idVendor}=="87cd", ATTRS{idProduct}=="70db", MODE="0660"
  SUBSYSTEM=="scsi_generic", ATTRS{idVendor}=="0416", ATTRS{idProduct}=="5406", MODE="0660"
  SUBSYSTEM=="scsi_generic", ATTRS{idVendor}=="0402", ATTRS{idProduct}=="3922", MODE="0660"
'';

Then:

pip install --break-system-packages trcc-linux && trcc install-desktop

Usage

trcc gui                  # Launch GUI
trcc detect               # Show connected devices
trcc send image.png       # Send image to LCD
trcc report               # Generate diagnostic report for bug reports
trcc setup-udev           # Install udev rules
trcc install-desktop      # Install app menu entry and icon

See the CLI Reference for all 15 commands, options, and troubleshooting.

Documentation

Document	Description
Install Guide	Installation for all major distros
CLI Reference	All commands, options, and troubleshooting
Changelog	Version history
Architecture	Project layout and design
Technical Reference	SCSI protocol and file formats
USBLCD Protocol	SCSI protocol reverse-engineered from USBLCD.exe
USBLCDNEW Protocol	USB bulk protocol reverse-engineered from USBLCDNEW.exe
USBLED Protocol	HID LED protocol reverse-engineered from FormLED.cs
Testers Wanted	Devices that need hardware validation
Device Testing Guide	Device support and troubleshooting
Supported Devices	Full device list with USB IDs

Contributors

A big thanks to everyone who has contributed to this project:

• Lcstyle — HR10 2280 PRO Digital support (7-segment display, color wheel, NVMe temperature daemon)
• PantherX12max — Trofeo Vision LCD hardware testing
• shadowepaxeor-glitch — AX120 Digital hardware testing & USB descriptor dumps
• Xentrino — Peerless Assassin 120 Digital ARGB White hardware testing

License

GPL-3.0