tinydesk-project/tinydesk

这是什么？

核心功能

• 01在串口终端中绘制可重叠、可拖动、可缩放的窗口。
• 02支持鼠标和键盘操作，并可与电脑之间复制粘贴。
• 03内置文件、编辑器、网络、MQTT 和 Modbus 等应用。
• 04支持 shell 脚本和 MicroPython 脚本，可访问文件、MQTT 和 Modbus。
• 05可运行于 ESP32-S3、ESP32-C6 和经典 ESP32 开发板，也可原生运行于 Linux、Windows 和 macOS。

适用场景

• 无需屏幕或额外软件，即可管理 ESP32 设备的文件、网络设置和日志。
• 通过开发板监控和读写 RS-485 工业设备的 Modbus 寄存器。
• 在单片机上用 MicroPython 原型验证 MQTT 或引脚控制脚本。
• 通过终端中的可视化桌面学习或演示嵌入式系统。

快速上手

1. 1

   克隆仓库及其 shell 子模块

   git clone --recursive https://github.com/tinydesk-project/tinydesk.git
2. 2

   进入项目目录

   cd tinydesk
3. 3

   在电脑上构建桌面并运行

   cmake -B build -G Ninja && cmake --build build && ./build/tinydesk

使用前须知

• !这是开发者预览版（v0.2.0），可能存在不完善之处。
• !包含 wolfSSH 和 wolfSSL 的固件镜像整体遵循 GPLv3 发布。
• !完整使用需要通过串口终端连接 ESP32 开发板；电脑版主要用于开发。
• !可选的 Telnet 接管功能不加密。

收录于专题

标签

常见问题

tinydesk 是什么？

一个在 ESP32 单片机上运行、通过终端鼠标操作的窗口式桌面环境。 TinyDesk 是一个面向单片机的文字模式桌面环境。它用 ANSI 转义序列绘制可重叠、可拖动的窗口，并从终端读回键盘和鼠标输入，因此不需要显示屏硬件。把支持 ANSI/VT 光标控制和 xterm 鼠标上报的 UTF-8 终端（例如 PuTTY）连接到开发板的串口，就能看到桌面。

tinydesk 可以免费使用吗？用的什么许可证？

tinydesk 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

tinydesk 还在维护吗？

活跃维护中。tinydesk 最近一次提交是在 2026年11月5日。

tinydesk 适合用来做什么？

无需屏幕或额外软件，即可管理 ESP32 设备的文件、网络设置和日志。 通过开发板监控和读写 RS-485 工业设备的 Modbus 寄存器。 在单片机上用 MicroPython 原型验证 MQTT 或引脚控制脚本。 通过终端中的可视化桌面学习或演示嵌入式系统。

tinydesk 怎么安装和运行？

克隆仓库及其 shell 子模块: git clone --recursive https://github.com/tinydesk-project/tinydesk.git 进入项目目录: cd tinydesk 在电脑上构建桌面并运行: cmake -B build -G Ninja && cmake --build build && ./build/tinydesk

在哪里获取 tinydesk？

源代码和安装说明在 GitHub 上：https://github.com/tinydesk-project/tinydesk