Un entorno de escritorio retro para tu terminal. (English below)
╔══════════════════════════════════════════════════════════════╗
║ ≡ File Edit Help 12:30:45 ║
╠══════════════════════════════════════════════════════════════╣
║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
║░░ 📁 ░░░░╔═══ File Manager ═══════════[─][□][×]╗░░░░░░░░░░░░░║
║░ Files ░░║ 📂 /home/user ║░░░░░░░░░░░░░║
║░░░░░░░░░░║ ────────────────────────── ║░░░░░░░░░░░░░║
║░░ 📝 ░░░░║ 📁 Documents/ ║░░░░░░░░░░░░░║
║░Notepad░░║ 📁 Downloads/ ║░░░░░░░░░░░░░║
║░░░░░░░░░░║ 📄 readme.txt 2.4K ║░░░░░░░░░░░░░║
║░░ 💻 ░░░░║ 📄 config.json 512B ║░░░░░░░░░░░░░║
║░Terminal░╚══════════════════════════════════════╝░░░░░░░░░░░░░║
║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
║ RetroTUI v0.9.3 │ Windows: 1/1 │ Mouse: Enabled │ Ctrl+Q: Exit║
╚══════════════════════════════════════════════════════════════╝
RetroTUI es un entorno de escritorio estilo Windows 3.1 que corre completamente en la terminal. Sin X11, sin Wayland, solo Python y curses. Funciona en Linux, WSL y Windows nativo.
- Gestor de Ventanas: Mover, redimensionar, maximizar, minimizar, arrastrar y soltar.
- Soporte de Mouse: Funciona en consola TTY (via
gpm) y emuladores de terminal (protocolo xterm). - Terminal Embebida: Shell PTY completo dentro de una ventana (POSIX y Windows via
pywinpty). - Apps principales: Explorador de Archivos (doble panel), Bloc de Notas, Terminal, Calculadora, Visor Hex, Visor Markdown, Monitor de Procesos, Monitor de Sistema, Visor de Logs, Clipboard Viewer, Panel de Control, Papelera.
- Juegos: Buscaminas, Solitario, Snake, Tetris.
- Plugins: RetroNet Explorer (navegador web de texto), Mapa de Caracteres, Reloj/Calendario, Visor de Imagenes, WiFi Manager.
- Temas: Windows 3.1, DOS, Windows 95, Hacker, Amiga.
- Sistema de Plugins: Carga automatica de plugins propios desde directorio configurable. Campo
categoryenplugin.tomlpara separar juegos de herramientas. - Sin dependencias en Linux: Solo Python 3.10+ estandar. En Windows requiere
pywinptyywindows-curses.
git clone https://github.com/roccolate/RetroTUI.git
cd RetroTUI
python -m retrotui| Plataforma | Requisitos |
|---|---|
| Linux/WSL | Python 3.10+, terminal 80x24 minimo, UTF-8 recomendado |
| Windows | Python 3.10+, pip install pywinpty windows-curses |
Para Python 3.14+ en Windows: windows-curses fork.
| Tecla | Accion |
|---|---|
Tab |
Cambiar ventana activa |
F10 |
Abrir menu |
Ctrl+Q |
Salir |
Alt+Tab |
Ciclar ventanas |
| Click derecho | Menu contextual |
- File Manager:
Enterabrir,F5Copiar,F4Mover,F2Renombrar,DelBorrar,Ddoble panel. - Notepad:
Ctrl+SGuardar,Ctrl+OAbrir,Ctrl+WAjuste de linea. - Terminal:
Ctrl+CCopiar/Interrumpir,Ctrl+VPegar,F6Interrumpir,F7Terminar.
- ARCHITECTURE.md - Arquitectura del sistema.
- CONTRIBUTING.md - Guia de contribucion.
- CHANGELOG.md - Historial de cambios.
A retro desktop environment for your terminal.
RetroTUI is a Windows 3.1-style desktop environment that runs entirely in the terminal. No X11, no Wayland, just Python and curses. Works on Linux, WSL, and native Windows.
- Window Manager: Move, resize, maximize, minimize, drag and drop.
- Mouse Support: Works in TTY consoles (via
gpm) and terminal emulators (xterm protocol). - Embedded Terminal: Full PTY shell inside a window (POSIX and Windows via
pywinpty). - Core Apps: File Manager (dual-pane), Notepad, Terminal, Calculator, Hex Viewer, Markdown Viewer, Process Manager, System Monitor, Log Viewer, Clipboard Viewer, Control Panel, Trash.
- Games: Minesweeper, Solitaire, Snake, Tetris.
- Plugins: RetroNet Explorer (text web browser), Character Map, Clock/Calendar, Image Viewer, WiFi Manager.
- Themes: Windows 3.1, DOS, Windows 95, Hacker, Amiga.
- Plugin System: Auto-loads custom plugins from a configurable directory. Use
categoryfield inplugin.tomlto separate games from tools. - No dependencies on Linux: Just standard Python 3.10+. Windows requires
pywinptyandwindows-curses.
git clone https://github.com/roccolate/RetroTUI.git
cd RetroTUI
python -m retrotui| Platform | Requirements |
|---|---|
| Linux/WSL | Python 3.10+, terminal 80x24 minimum, UTF-8 recommended |
| Windows | Python 3.10+, pip install pywinpty windows-curses |
For Python 3.14+ on Windows: windows-curses fork.
| Key | Action |
|---|---|
Tab |
Switch window focus |
F10 |
Toggle menu bar |
Ctrl+Q |
Exit |
Alt+Tab |
Cycle windows |
| Right click | Context menu |
- File Manager:
Enterto open,F5Copy,F4Move,F2Rename,DelDelete,Ddual-pane. - Notepad:
Ctrl+SSave,Ctrl+OOpen,Ctrl+WToggle word wrap. - Terminal:
Ctrl+CCopy/Interrupt,Ctrl+VPaste,F6Interrupt,F7Terminate.
- ARCHITECTURE.md - System design and internals.
- CONTRIBUTING.md - Development guide.
- CHANGELOG.md - Release notes.
MIT