This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Turing or XuanFang brands, or any of its subsidiaries, affiliates, manufacturers or sellers of the Turing or XuanFang products. All product and company names are the registered trademarks of their original owners.
This project is an open-source alternative software, NOT the USBMonitor.exe / ExtendScreen.exe or any original software for the smart screens (even if some themes have been reused). Please do not open issues for USBMonitor.exe/ExtendScreen.exe here, instead you can use:
- for Turing Smart Screen, the official forum here: http://discuz.turzx.com/
- for XuanFang Smart screen, contact your reseller
A Python system monitor program and a library for 3.5" & 5" IPS USB-C (UART) displays.
Supported operating systems : macOS, Windows, Linux (incl. Raspberry Pi), basically all OS that support Python 3.8+
| ✅ Turing Smart Screen 3.5" | ✅ XuanFang 3.5" | ✅ Turing Smart Screen 5" |
|---|---|---|
 |
 |
 |
| also improperly called "revision A" by the resellers | revision B & flagship (with backplate & RGB LEDs) | basic support (no video or storage for now) |
| ✅ UsbPCMonitor 3.5" / 5" |
|---|
 |
Unknown manufacturer, visually similar to Turing 3.5" / 5". Original software is UsbPCMonitor.exe |
Please note the Turing and the XuanFang screens are different products designed and produced by different companies, despite having a similar appearance. The communication protocol is also different.
This project support products from both manufacturers, including backplate RGB LEDs for available models!
If you haven't received your screen yet but want to start developing your theme now, you can use the "simulated LCD" mode!
| ❔ Turing Smart Screen 8.8" | ❔ Turing Smart Screen 2.1" | ❌ (Fuldho?) 3.5" IPS Screen |
|---|---|---|
 |
 |
 |
| Very similar protocol than the 5". Support planned in a future version. | Very similar protocol than the 5". Support planned in a future version. | Managed with proprietary Windows software SmartMonitor.exe. Cannot be supported by this project: see here. Use alternative library https://github.com/braewoods/hidss |
| ❔ SmartCool Lcd / GeekTeches AD35 / AIDA64 / AX206 | ❔ Kipye Qiye Smart Display 3.5" |
|---|---|
   |
 |
| Not supported. Produced by multiple manufacturers, all use the same Appotech AX206 hacked photo frame firmware. Supported by AIDA64 and lcd4linux | Front panel has an engraved inscription "奇叶智显" Qiye Zhixian (Qiye Smart Display). Display should be compatible with this project. Support planned in a future version. |
There are 2 possible uses of this project Python code:
- as a System Monitor, a standalone program working with themes to display your computer HW info. Check if your hardware is supported.
- integrated in your project, to control the display from your own Python code.
This project is mainly a complete standalone program to use your screen as a system monitor, like the original vendor app.
Some themes are already included for a quick start!
- Fully functional multi-OS code base (operates out of the box, tested on Windows, Linux & MacOS).
- Display configuration using GUI configuration wizard or
config.yamlfile: no Python code to edit. - Support for 3.5" & 5" smart screen models (Turing and XuanFang). Backplate RGB LEDs are also supported for available models!
- Support multiple hardware sensors and metrics (CPU/GPU usage, temperatures, memory, disks, etc) with configurable refresh intervals.
- Allow creation of themes (see
res/themes) withtheme.yamlfiles using theme editor to be shared with the community! - Easy to expand: additional code that pulls specific information can be written in a modular way without impacting existing code.
- Auto detect comm port. No longer need to hard set it, or if it changes on you then the config is wrong.
- Tray icon with Exit option, useful when the program is running in background
... view full list
and more... Share yours!
If you don't want to use your screen for system monitoring, you can just use this project as a module to do some simple operations on the display from any Python code :
- Display custom picture
- Display text
- Display progress bar
- Screen rotation
- Clear the screen (blank)
- Turn the screen on/off
- Display soft reset
- Set brightness
- Set backplate RGB LEDs color (on supported hardware rev.)
Check simple-program.py as an example.
If you have trouble running the program as described in the wiki, please check open/closed issues & the wiki Troubleshooting page
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}
