- Rust 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| config | ||
| core | ||
| documentacion | ||
| logo | ||
| openwiki | ||
| shell | ||
| theming | ||
| AGENTS.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| CLAUDE.md | ||
| README.md | ||
| skills-created.md | ||
G Desktop
Un gestor de ventanas tiling moderno para Linux
Dinamismo estilo Hyprland, estética premium y estabilidad rock-solid — construido desde cero en Rust sobre Wayland.
🧭 Filosofía del proyecto
"Fácil para el usuario y para el desarrollador. Que se siente y lo tenga automatizado, que funcione y sea sencillo."
G Desktop nace para resolver la fragilidad del ecosistema actual: dotfiles que se rompen, problemas de foco en XWayland, y una curva de aprendizaje que aleja al usuario final. La idea es combinar lo mejor de cada mundo:
- El dinamismo visual y el tiling de Hyprland — layouts Dwindle y Master-Stack, workspaces numerados, operación 100% por teclado.
- La robustez e integración de KDE Plasma — ajustes desde una GUI, sin tocar archivos de texto.
- La simplicidad de GNOME — que funcione out-of-the-box, sin configuración previa.
- La base técnica de Niri — Rust + Smithay: predecible, rápido y que nunca se cuelga.
Los pilares
| Pilar | Compromiso |
|---|---|
| Plug & Play | Fácil de instalar, fácil de configurar, fácil de compartir diseños. |
| Anti-fragilidad | Un error de sintaxis en la config nunca tira el escritorio: notificación nativa y carga de la última configuración válida. |
| Gaming nativo | XWayland robusto con Direct Scan-out para juegos: adiós flickering y crashes de Wine/Proton. |
| Estética premium | Blur real en GPU, bordes redondeados y animaciones significativas, todo con un sistema de temas transaccional y reversible. |
| Set & Forget | La experiencia diaria automatizada: multimedia, captura de pantalla, clipboard, autostart, wallpapers. |
🛠️ Stack Tecnológico
| Capa | Tecnología | Rol |
|---|---|---|
| Lenguaje | Rust (Edition 2021+) | Todo el sistema. Seguridad de memoria y concurrencia segura para un servidor gráfico. |
| Núcleo del compositor | Smithay | Protocolo Wayland, outputs, superficies, inputs y hardware. |
| Shell (GUI) | GTK4 + Relm4 | Barra de tareas, launcher, notificaciones y bloqueo de sesión vía wlr-layer-shell. |
| Renderizado | wgpu (Vulkan) + tiny-skia | Composición general en GPU; bordes, esquinas y sombras 2D. |
| Configuración | KDL (parseado con knus) |
100% declarativo, con recarga y fallback a la última configuración válida. |
| Scripting | mlua (Lua 5.4) | Scripting avanzado estrictamente sandboxeado: sin os/io/debug, con límites de memoria e instrucciones. |
| IPC | Sockets Unix + JSON | Comunicación compositor ↔ shell, con aislamiento de fallos entre procesos. |
| Integración de sistema | D-Bus (zbus), systemd-logind, PipeWire/PulseAudio | Notificaciones estándar, sesión, multimedia MPRIS. |
🏗️ Arquitectura
Workspace de Cargo dividido en crates con responsabilidades aisladas:
g_os/
├── core/ → El compositor Wayland puro (Smithay, hardware, inputs)
├── shell/ → La GUI: barra, launcher, notificaciones (GTK4)
├── config/ → Parser de KDL y estado de configuración
└── theming/ → Lógica de temas y exportación/importación de .tema
Reglas de arquitectura (obligatorias)
1. Lógica padre-hijo (la solución al problema de Hyprland)
Las ventanas principales entran en tiling; las hijas (xdg_toplevel.parent, xdg_popup, WM_TRANSIENT_FOR) abren flotantes y centradas sobre su padre. Más un sistema de window-rules configurable para apps que no declaran el padre.
2. XWayland robusto (anti-flickering)
Los juegos de Wine/Proton que piden cambios constantes de resolución son interceptados: se les fuerza Direct Scan-out y se ignoran sus redimensionamientos. Trade-off explícito: una ventana en scan-out directo no pasa por wgpu (sin blur ni animaciones) — aceptable para juegos.
3. Tolerancia a fallos
- KDL inválido → notificación nativa + última configuración válida.
- Temas
.tema→ ZIPs validados contra zip-slip y zip bombs, aplicación transaccional con rollback automático. - Watchdog interno que relanza el shell si se cae, y desconexión graceful de clientes que violen el protocolo.
4. Cero unwrap() en producción
Todo manejo de errores con Result, match o ?. El lint clippy::unwrap_used está denegado en producción (permitido solo en tests). Un puntero nulo nunca tira el servidor gráfico.
✨ Características
- Tiling dinámico: layouts Dwindle y Master-Stack, workspaces numerados por monitor (1–10), ventanas sticky y reglas por app.
- Shell integrado: barra de tareas, launcher estilo KRunner/Rofi y centro de notificaciones (daemon D-Bus
org.freedesktop.Notifications), embebidos en el binario. - Centro de configuración GUI: cambia colores, bordes y monitores con clics; la GUI escribe el KDL.
- "Figma" de temas: diseña tu escritorio en un canvas y expórtalo como
.tema(ZIP seguro). Importar toma 2 clics y es 100% reversible. - Multimonitor: cada pantalla tiene su propio árbol de ventanas independiente.
- Ciclo de vida de sesión: pantalla de bloqueo GTK4 sobre
ext-session-lock-v1, idle nativo y menú de sesión con logind. - Protocolos esenciales:
fractional-scale-v1,presentation-time,wlr-gamma-control-v1,cursor-shape-v1,text-input-v3+input-method-v2(CJK/IME). - Experiencia diaria: teclas multimedia con OSD, captura de pantalla integrada (
wlr-screencopy), clipboard manager, autostart KDL + XDG, wallpaper dibujado por el compositor.
🗺️ Roadmap
| Fase | Objetivo | Estado |
|---|---|---|
| 0 — Concepción y Arquitectura | Crates del workspace, setup de Smithay (DRM/KMS), parser de KDL. | 🚧 En curso |
| 1 — El Motor Rock-Solid | Inputs, padre-hijo, XWayland + anti-flickering, hotplugging, tiling básico. | ⏳ |
| 2 — El Ecosistema Set & Forget | Shell GTK4, launcher, centro de configuración, portales XDG, sesión, multimedia. | ⏳ |
| 3 — Temas y Automatización | App de diseño visual, .tema seguro, rollback transaccional. |
⏳ |
| 4 — Pulido y Animaciones | Motor de animaciones (curvas de Bézier) en wgpu, documentación con mdbook. |
⏳ |
🧪 Calidad y Workflow
- Commits: Conventional Commits (
feat:,fix:,chore:,docs:). - Ramas:
main(estable) ·dev(integración) ·feature/*. - Linters:
cargo clippy --all-targets --all-features -- -D warningsycargo fmt --check. - Testing progresivo: unitario en Fase 0 → integración headless (Smithay) en Fase 1 → coverage gates en Fase 2+.
📦 Distribución
Distro principal: Arch Linux (PKGBUILD + AUR). Luego Fedora (COPR/rpm), Ubuntu/Debian (PPA/deb) y NixOS (flake.nix). Todo el código propio compila dentro de los binarios de Rust; GTK4 y su stack son la única dependencia dinámica de sistema.
Construido con ❤️ y mucho café · Rust · Wayland · Smithay