Skip to content

Unofficial Python system monitor and library for 3.5" and 5" IPS USB-C displays like Turing Smart Screen or XuanFang

License

Notifications You must be signed in to change notification settings

Paradoxum/turing-smart-screen-python

 
 

Repository files navigation

Icon turing-smart-screen-python

⚠️ DISCLAIMER - PLEASE READ ⚠️

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

Linux Windows macOS Raspberry Pi Python Licence

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.7+

Supported smart screens models:

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)

Not supported (for now) or not tested:

Turing Smart Screen 8.8" Turing Smart Screen 2.1" AX206

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!

How to use

There are 2 possible uses of this project Python code:

System monitor

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!

Screenshots from the latest version using included themes (click on the thumbnails to see a bigger preview):

and more... Share yours!

Control the display from your Python projects

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.

Troubleshooting

If you have trouble running the program as described in the wiki, please check open/closed issues & the wiki Troubleshooting page

About

Unofficial Python system monitor and library for 3.5" and 5" IPS USB-C displays like Turing Smart Screen or XuanFang

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%