Repolode
Enviar
tinydesk-project

tinydesk-project/tinydesk

Un escritorio con ventanas controlado con el mouse que funciona en microcontroladores ESP32 y se muestra en cualquier terminal ANSI conectada por puerto serie.

Ver en GitHubSitio web
Estrellas
104
Forks
15
Issues abiertos
4
Último commit
hace 3 días

¿Qué es?

TinyDesk es un escritorio en modo texto para microcontroladores. Dibuja ventanas superpuestas y arrastrables mediante secuencias de escape ANSI, y recibe del terminal las entradas del teclado y el mouse, por lo que no hace falta una pantalla. Conecta al puerto serie de la placa un terminal UTF-8 con control de cursor ANSI/VT y compatibilidad con el protocolo de mouse de xterm, como PuTTY, y aparecerá el escritorio.

El escritorio incluye una app Terminal que ejecuta TinyDesk Shell, además de Archivos, un Editor con resaltado de sintaxis para Python, Red, MQTT, Modbus (TCP y RTU), Monitor del sistema, Visor de registros, Configuración y actualización de software OTA. Los scripts se pueden escribir en shell (.tdsh) o MicroPython, y una pequeña API permite a los desarrolladores añadir sus propias apps.

El núcleo portable en C11 no tiene dependencias de terceros y, mediante ESP-IDF, es compatible con ESP32-S3, ESP32-C6 y las placas ESP32 clásicas, además de Linux, Windows y macOS para el desarrollo. El proyecto es una versión preliminar para desarrolladores, actualmente en la versión 0.2.0.

Funciones clave

  • 01Ventanas superpuestas, arrastrables y redimensionables que se muestran en un terminal conectado por puerto serie.
  • 02Control con mouse y teclado, con copiar y pegar desde y hacia la PC.
  • 03Apps integradas para gestionar archivos, editar, conectarse a redes y usar MQTT y Modbus.
  • 04Scripts de shell y MicroPython con acceso a archivos, MQTT y Modbus.
  • 05Funciona en placas ESP32-S3, ESP32-C6 y ESP32 clásicas, y de forma nativa en Linux, Windows y macOS.

Casos de uso

  • Gestionar los archivos, la configuración de red y los registros de un dispositivo ESP32 sin pantalla ni software adicional.
  • Supervisar y escribir registros Modbus en equipos industriales RS-485 desde una placa.
  • Crear prototipos de scripts de MQTT o control de pines con MicroPython en un microcontrolador.
  • Aprender sobre sistemas integrados o hacer demostraciones mediante un escritorio visual en un terminal.

Inicio rápido

  1. 1

    Clona el repositorio junto con su submódulo shell

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

    Entra en el directorio del proyecto

    cd tinydesk
  3. 3

    Compila la versión de escritorio para PC y ejecútala

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

Antes de usarlo

  • Es una versión preliminar para desarrolladores (v0.2.0), así que puede tener algunos problemas.
  • Las imágenes de firmware que incluyen wolfSSH y wolfSSL se distribuyen en su conjunto bajo la licencia GPLv3.
  • Para usar todas las funciones se necesita una placa ESP32 conectada a un terminal serie; la versión para PC está pensada principalmente para el desarrollo.
  • La conexión opcional mediante Telnet no está cifrada.

En colecciones

Aplicaciones con interfaz de terminal (TUI)Herramientas de CLI y terminalSistemas embebidos y proyectos con microcontroladores

Temas

#embedded#esp32#microcontroller#tui#mqtt#modbus#micropython#terminal#ansi#c11

Preguntas frecuentes

¿Qué es tinydesk?
Un escritorio con ventanas controlado con el mouse que funciona en microcontroladores ESP32 y se muestra en cualquier terminal ANSI conectada por puerto serie. TinyDesk es un escritorio en modo texto para microcontroladores. Dibuja ventanas superpuestas y arrastrables mediante secuencias de escape ANSI, y recibe del terminal las entradas del teclado y el mouse, por lo que no hace falta una pantalla. Conecta al puerto serie de la placa un terminal UTF-8 con control de cursor ANSI/VT y compatibilidad con el protocolo de mouse de xterm, como PuTTY, y aparecerá el escritorio.
¿tinydesk es gratuito? ¿Qué licencia tiene?
tinydesk es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿tinydesk sigue mantenido?
Mantenimiento activo. El último commit de tinydesk fue el 5 nov 2026.
¿Para qué puedo usar tinydesk?
Gestionar los archivos, la configuración de red y los registros de un dispositivo ESP32 sin pantalla ni software adicional. Supervisar y escribir registros Modbus en equipos industriales RS-485 desde una placa. Crear prototipos de scripts de MQTT o control de pines con MicroPython en un microcontrolador. Aprender sobre sistemas integrados o hacer demostraciones mediante un escritorio visual en un terminal.
¿Cómo se instala tinydesk?
Clona el repositorio junto con su submódulo shell: git clone --recursive https://github.com/tinydesk-project/tinydesk.git Entra en el directorio del proyecto: cd tinydesk Compila la versión de escritorio para PC y ejecútala: cmake -B build -G Ninja && cmake --build build && ./build/tinydesk
¿Dónde consigo tinydesk?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/tinydesk-project/tinydesk

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados