当前位置：首页 > news >正文

实战指南：5分钟快速配置Turing智能显示屏Python系统监控项目

news 2026/7/14 14:44:58

实战指南：5分钟快速配置Turing智能显示屏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

Turing智能显示屏Python项目是一个针对Turing Smart Screen、XuanFang等小型IPS USB-C显示屏的非官方系统监控工具和库。该项目能让你的USB-C智能显示屏实时显示CPU、GPU、内存、磁盘等硬件监控数据，支持Windows、Linux、macOS和Raspberry Pi系统，为技术爱好者和DIY玩家提供强大的桌面监控解决方案。

第一步：环境准备与项目部署

首先需要准备Python 3.7或更高版本环境，然后克隆项目仓库到本地：

git clone https://gitcode.com/GitHub_Trending/tu/turing-smart-screen-python cd turing-smart-screen-python

安装项目依赖包：

pip install -r requirements.txt

项目支持多种智能显示屏型号，包括Turing Smart Screen的2.1寸、3.5寸、5寸、8.8寸等尺寸，以及XuanFang 3.5寸、WeAct Studio Display等兼容设备。如果你的显示屏尚未到货，可以使用模拟显示模式进行开发和测试。

图：Turing Smart Screen系列显示屏

第二步：图形化配置向导快速设置

运行配置向导是最简单的启动方式：

python configure.py

配置界面分为两个主要部分：显示配置和系统监控配置。在显示配置中，选择你的显示屏型号、尺寸和方向。大多数情况下，选择"Automatic detection"可以自动识别显示屏。

图：图形化配置向导界面

在系统监控配置部分，需要设置以下关键参数：

硬件传感器读取方式：Windows系统推荐使用LibreHardwareMonitor（需要管理员权限），Linux/macOS系统使用Python库
网络接口：设置以太网和Wi-Fi接口名称
CPU风扇：通常设置为AUTO自动检测
PING地址：用于网络连通性测试，默认为8.8.8.8
天气API：如果需要天气显示功能，可配置OpenWeatherMap API

配置完成后点击"Save and run"即可启动系统监控程序。

第三步：主题选择与个性化定制

项目内置了丰富的主题库，位于res/themes/目录下。每个主题都是一个独立的文件夹，包含theme.yaml配置文件和背景图片。

图：3.5寸显示屏默认主题效果

主题文件采用YAML格式配置，可以自定义显示内容、位置、字体和颜色。以3.5inchTheme2主题为例，其配置文件定义了CPU使用率、温度、频率的显示位置和样式：

CPU: PERCENTAGE: INTERVAL: 1 TEXT: SHOW: True X: 250 Y: 24 FONT: jetbrains-mono/JetBrainsMono-Bold.ttf FONT_SIZE: 23 FONT_COLOR: 255, 255, 255

项目提供了多种风格的主题，包括：

科技风格：如Cyberpunk、NVIDIA、AMD主题
简约风格：SimpleBlue、SimpleGreen等纯色主题
动漫主题：如龙珠主题、初音未来主题
实用风格：如任务管理器风格、终端风格

图：赛博朋克风格主题

第四步：高级配置与自定义开发

手动编辑配置文件

除了使用图形化配置向导，你还可以直接编辑config.yaml文件进行高级配置：

config: COM_PORT: "AUTO" THEME: "3.5inchTheme2" HW_SENSORS: "AUTO" ETH: "" WLO: "" display: REVISION: "A" BRIGHTNESS: 20 DISPLAY_REVERSE: false RESET_ON_STARTUP: true

创建自定义主题

使用主题编辑器创建个性化主题：

python theme-editor.py

主题编辑器提供了可视化界面，可以拖拽组件、调整位置、设置字体和颜色。每个主题包含以下组件：

静态图片背景
静态文本标签
动态统计数据（CPU、GPU、内存、磁盘等）
进度条和图表

编程控制显示屏

如果你需要在自己的Python项目中集成显示屏控制功能，可以使用项目提供的库：

from library.lcd.lcd_comm import LcdComm # 初始化显示屏连接 lcd = LcdComm(com_port="COM3", display_width=320, display_height=480) # 显示图片 lcd.DisplayPILImage(image) # 显示文本 lcd.DisplayText("Hello World", x=10, y=10) # 控制背光 lcd.SetBrightness(50) # 设置RGB背光（支持型号） lcd.SetBackplateLedColor(255, 0, 0)

查看simple-program.py文件可以获取完整的编程示例。