{"id":30214562,"url":"https://github.com/rejeb/thermalright-lcd-control","last_synced_at":"2026-06-19T12:33:48.837Z","repository":{"id":308053876,"uuid":"1031374993","full_name":"rejeb/thermalright-lcd-control","owner":"rejeb","description":"A Linux application for controlling Thermalright LCD displays with an intuitive graphical interface.","archived":false,"fork":false,"pushed_at":"2026-05-10T08:38:09.000Z","size":292324,"stargazers_count":72,"open_issues_count":12,"forks_count":19,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-05-10T10:29:28.387Z","etag":null,"topics":["aio","linux","thermalright"],"latest_commit_sha":null,"homepage":"https://github.com/rejeb/thermalright-lcd-control/wiki/How-to-add-a-new-device","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rejeb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-03T15:55:03.000Z","updated_at":"2026-05-10T08:38:08.000Z","dependencies_parsed_at":"2025-09-13T13:32:43.668Z","dependency_job_id":null,"html_url":"https://github.com/rejeb/thermalright-lcd-control","commit_stats":null,"previous_names":["rejeb/thermalright-lcd-control"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/rejeb/thermalright-lcd-control","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rejeb%2Fthermalright-lcd-control","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rejeb%2Fthermalright-lcd-control/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rejeb%2Fthermalright-lcd-control/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rejeb%2Fthermalright-lcd-control/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rejeb","download_url":"https://codeload.github.com/rejeb/thermalright-lcd-control/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rejeb%2Fthermalright-lcd-control/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34532255,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-19T02:00:06.005Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aio","linux","thermalright"],"created_at":"2025-08-14T00:41:06.280Z","updated_at":"2026-06-19T12:33:48.826Z","avatar_url":"https://github.com/rejeb.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Thermalright LCD Control\n\nA Linux application for controlling Thermalright LCD displays with an intuitive graphical interface.\n\n![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)\n![Platform](https://img.shields.io/badge/platform-Linux-lightgrey.svg)\n![version](https://img.shields.io/badge/version-1.3.1-green.svg)\n\n## Overview\n\nThermalright LCD Control provides an easy-to-use interface for managing your Thermalright LCD display on Linux systems.\n\nThe application features both a desktop GUI and a background service for seamless device control.\n\nI performed reverse engineering on the Thermalright Windows application to understand its internal mechanisms.\n\nDuring my analysis, I identified four different USB VID:PID combinations handled by the Windows application, all sharing\nthe same interaction logic.\n\nSince I have access only to the Frozen Warframe 420 BLACK ARGB, my testing was limited exclusively to this specific\ndevice.\n\nAlso, this application implements reading metrics from Amd, Nvidia, and Intel GPU. My testing was limited to Nvidia GPU.\n\nFeel free to contribute to this project and let me know if the application is working with other devices.\n\nFor backgrounds, i have included all media formats supported by the Windows application\nand added the option to select a collection of images to cycle through on the display.\n\n## Features\n\n- 🖥️ **User-friendly GUI** - Modern interface for device configuration\n- ⚙️ **Background service** - Automatic device management\n- 🎨 **Theme support** - Customizable display themes and backgrounds\n- 📋 **System integration** - Native Linux desktop integration\n\n## Supported devices\n\n| VID:PID   | SCREEN RESOLUTION |\n|-----------|-------------------|\n| 0416:5302 | 320x240           |\n| 0418:5304 | 480x480           |\n| 87AD:70DB | 320x320,480x480   |\n| 0402:3922 | 320x320,...       |\n\n## Installation\n\n### Download Packages\n\nDownload the appropriate package for your Linux distribution from\nthe [Releases](https://www.github.com/rejeb/thermalright-lcd-control/releases) page:\n\n- **`.targ.gz`** - For any distribution\n\n### Installation\n\n1. **Check** for required dependencies:\n   /!\\ Make sure you have these required dependencies installed:\n    - python3\n    - python3-pip\n    - python3-venv\n    - libhidapi-* or hidapi depending on your distribution\n\n2. **Download** the `.tar.gz` package:\n   ```bash\n   wget https://github.com/rejeb/thermalright-lcd-control/releases/download/1.3.1/thermalright-lcd-control-1.3.1.tar.gz -P /tmp/\n   ```\n\n3. **Untar** the archive file:\n   ```bash\n   cd /tmp\n   \n   tar -xvf thermalright-lcd-control-1.3.1.tar.gz\n   ```\n\n4. **Install** application:\n   ```bash\n   cd /thermalright-lcd-control\n   \n   sudo bash install.sh\n   ```\n\nThat's it! The application is now installed. You can see the default theme displayed on your Thermalright LCD device.\n\n## Troubleshooting\n\nIf your device is 0416:5302 and nothing is displayed:\n- Check service status to see if it is running\n- Try restart service\n- Check service logs located in /var/log/thermalright-lcd-control.log\n\nIf your device is one of the other devices, contributions are welcome.\nHere some tips to help you:\n- Check service status to see if it is running\n- Check service logs located in /var/log/thermalright-lcd-control.log\n- If the device is not working then this possibly mean that header value is not correct.\nSee [Add new device](#add-new-device) section to fix header generation.\n- If the device is working but image is not good, this means that the image is not encoded correctly.\nSee [Add new device](#add-new-device) section to fix image encoding by overriding method _`_encode_image`.\n\n## Usage\n\n### Launch the Application\n\n- **From Applications Menu**: Search for \"Thermalright LCD Control\" in your application launcher\n- **From Terminal**: Run `thermalright-lcd-control`\n\n### System Service\n\nThe background service starts automatically after installation. You can manage it using:\n\n# Check service status\n\nsudo systemctl status thermalright-lcd-control.service\n\n# Restart service\n\nsudo systemctl restart thermalright-lcd-control.service\n\n# Stop service\n\nsudo systemctl stop thermalright-lcd-control.service\n\n## System Requirements\n\n- **Operating System**: Ubuntu 20.04+ / Debian 11+ / Other modern Linux distributions\n- **Python**: 3.8 or higher (automatically managed)\n- **Desktop Environment**: Any modern Linux desktop (GNOME, KDE, XFCE, etc.)\n- **Hardware**: Compatible Thermalright LCD device\n\n## Add new device\n\nIn [HOWTO.md](doc/HOWTO.md) I detail all the steps I gone through to find out how myy device works and all steps to add\na new device.\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n\n## Author\n\n**REJEB BEN REJEB** - [benrejebrejeb@gmail.com](mailto:benrejebrejeb@gmail.com)\n\n## 🤝 Contributing\n\nContributions are welcome! To contribute:\n\n1. Fork the project\n2. Create a feature branch (`git checkout -b feature/my-feature`)\n3. Commit your changes (`git commit -am 'Add my feature'`)\n4. Push to your branch (`git push origin feature/my-feature`)\n5. Create a Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frejeb%2Fthermalright-lcd-control","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frejeb%2Fthermalright-lcd-control","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frejeb%2Fthermalright-lcd-control/lists"}