TRCC Linux

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.

Note: This project is under active development. Documentation and features may change. Use at your own risk — this is an unofficial community project, not affiliated with Thermalright.

Distro support: I develop and test on Fedora. The one-liners below cover many distros, but if something doesn't work on yours, please open an issue with your distro name and the error.

Supported Devices

Plug in your device and run lsusb in a terminal. Find the line with your device — the USB ID is the xxxx:xxxx after ID:

Bus 001 Device 008: ID 0416:5302 Winbond Electronics Corp. USBDISPLAY
                        ^^^^^^^^^
                        this is your USB ID

Match it to the tables 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 — experimental (563 tests, 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 (LED mode)

HID device? HID devices are auto-detected — just run trcc gui. See the HID Testing Guide for details. I don't have one of these devices, so I need testers.

Install

New to Linux? See the Install Guide — it explains every command and covers 25+ distros step by step.

Find your distro, copy the block, paste in terminal. After it finishes: unplug and replug the USB cable (or reboot if it's not easily accessible), 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. Or run directly: PYTHONPATH=src python3 -m trcc.cli gui

If your distro doesn't package PyQt6, just drop it from the system install line — pip install -e . will pull it from PyPI automatically.

See the Install Guide for troubleshooting, optional deps, immutable distros, and more.

Fedora / Nobara

sudo dnf install sg3_utils python3-pyqt6 ffmpeg && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop

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

sudo apt install sg3-utils python3-pyqt6 ffmpeg python3-pip && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop

Arch / Manjaro / EndeavourOS / CachyOS / Garuda

sudo pacman -S sg3_utils python-pyqt6 ffmpeg python-pip && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop

openSUSE

sudo zypper install sg3_utils python3-qt6 ffmpeg python3-pip && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop

Void Linux

sudo xbps-install sg3_utils python3-PyQt6 ffmpeg python3-pip && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop

Gentoo

sudo emerge --ask sg3_utils dev-python/PyQt6 media-video/ffmpeg dev-python/pip && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop

Alpine

sudo apk add sg3_utils py3-pyqt6 ffmpeg py3-pip python3 && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && 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:

([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && python3 -m venv ~/trcc-env && source ~/trcc-env/bin/activate && pip install -e . && 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 && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && 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:

([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc install-desktop

Support

If this project helped you, consider buying me a coffee:

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, eyedropper
Hardware — 77+ sensors, customizable dashboard, multi-device with per-device config, RGB LED control
Display — 4 resolutions, 0/90/180/270 rotation, 3 brightness levels
Extras — 5 starter themes + 120 masks per resolution, 8 languages, system tray, auto-start

Usage

trcc gui                  # Launch GUI
trcc detect               # Show connected devices
trcc send image.png       # Send image to LCD
trcc test                 # Color cycle test
trcc download themes-320  # Download cloud themes

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
HID Testing Guide	HID device support (testers wanted)
Supported Devices	Full device list with USB IDs
Development Status	What's stable, in progress, and planned

License

GPL-3.0

Name		Name	Last commit message	Last commit date
Latest commit History 221 Commits
.github		.github
doc		doc
src/trcc		src/trcc
tests		tests
tools		tools
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
install.sh		install.sh
pyproject.toml		pyproject.toml
requirements.txt		requirements.txt
trcc-hr10-tempd.service		trcc-hr10-tempd.service
trcc.desktop		trcc.desktop

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

TRCC Linux

Supported Devices

Install

Fedora / Nobara

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

Arch / Manjaro / EndeavourOS / CachyOS / Garuda

openSUSE

Void Linux

Gentoo

Alpine

Bazzite / Fedora Atomic / Aurora / Bluefin

SteamOS (Steam Deck)

NixOS

Support

Features

Usage

Documentation

License

About

Uh oh!

Releases

Packages

Languages

License

Lcstyle/thermalright-trcc-linux

Folders and files

Latest commit

History

Repository files navigation

TRCC Linux

Supported Devices

Install

Fedora / Nobara

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

Arch / Manjaro / EndeavourOS / CachyOS / Garuda

openSUSE

Void Linux

Gentoo

Alpine

Bazzite / Fedora Atomic / Aurora / Bluefin

SteamOS (Steam Deck)

NixOS

Support

Features

Usage

Documentation

License

About

Resources

License

Code of conduct

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages