把闲置的 USB-C 小屏变成系统监控面板:Turing Smart Screen Python 完整上手指南
【免费下载链接】turing-smart-screen-pythonUnofficial Python system monitor and library for small IPS USB-C displays like Turing Smart Screen / TURZX项目地址: https://gitcode.com/GitHub_Trending/tu/turing-smart-screen-python
挂在主机上的那块 USB-C 小屏幕,是不是只被当成装饰摆着?Turing Smart Screen Python 可以把 Turing、XuanFang 等这类显示屏改造成系统监控面板,把 CPU 占用率、内存水位、温度、磁盘与网络状态实时投射上去,全程开源免费。
📊 它到底能做什么:监控和屏幕控制
主程序会周期性采集 CPU/GPU 利用率、内存、磁盘、网络等指标,按所选主题渲染成图片或文字推送到小屏上,刷新间隔可以调。除了当监控用,library/里的抽象层也能直接嵌进你自己的 Python 项目:画图片、写文本、拉进度条、旋转屏幕、调亮度,部分型号还能控制背板 RGB 灯。
🛠️ 四步完成 USB-C 显示屏监控面板的首次配置
- 克隆仓库:
git clone https://gitcode.com/GitHub_Trending/tu/turing-smart-screen-python - 安装依赖:
pip install -r requirements.txt - 运行图形化向导,选择屏幕型号、串口和主题:
python configure.py - 启动监控主程序:
python main.py
🎨 换主题不用写代码:theme.yaml 与主题编辑器
所有主题放在 res/themes/ 下,每个主题一个目录加一份theme.yaml,仓库自带几十个成品:网格布局、竖屏时钟、赛博风格都有预览图可查。想改背景、字体或条目位置,直接用 theme-editor.py 图形化编辑即可,不用碰 Python 代码。

🧩 适配范围:支持哪些屏幕和系统,边界在哪
- 屏幕:Turing Smart Screen / TURZX 全系尺寸(2.1"~12.3",UART 与 USB 协议均可)、XuanFang 3.5"、Kipye Qiye 3.5"、WeAct 0.96"/3.5",以及 UsbPCMonitor 3.5"/5"
- 系统:Python 3.9+,Windows、Linux(含树莓派)验证较完整;macOS 可跑但官方标注存在已知 bug
- 已知限制:暂不支持视频与存储功能;AX206 相框类、Waveshare USB-Monitor、GUITION 等依赖专用固件的屏幕不在支持列表;本项目与 Turing/XuanFang 品牌无官方关联,硬件故障需找厂商处理
📌 文档、源码与社区入口
仓库根目录的 config.yaml 是用户配置入口,AGENTS.md 里写清了传感器采集、主题渲染、硬件驱动三层架构,想改代码可以先读它;simple-program.py 则演示了如何用库 API 直接控制屏幕。社区在 Discussions 的 Themes 板块分享大量自制主题,遇到怪问题可翻 issue 列表。
下一步动作:先跑一遍python configure.py,确认向导能识别出你的屏幕型号,再挑一个匹配尺寸的主题套上去看实际效果。
【免费下载链接】turing-smart-screen-pythonUnofficial Python system monitor and library for small IPS USB-C displays like Turing Smart Screen / TURZX项目地址: https://gitcode.com/GitHub_Trending/tu/turing-smart-screen-python
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考