Gestor de ventanas inteligente hecho en rust y wayland
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
White-Knight 79b40ee96a core: Rust init
core: motor que se va a usar para este proyecto, RUST.
2026-09-17 15:27:29 -03:00
config core: Rust init 2026-09-17 15:27:29 -03:00
core core: Rust init 2026-09-17 15:27:29 -03:00
documentacion doc: Documentacion sobre de que va ir el proyecto 2026-09-17 15:26:47 -03:00
logo core: Rust init 2026-09-17 15:27:29 -03:00
openwiki doc: Documentacion sobre de que va ir el proyecto 2026-09-17 15:26:47 -03:00
shell core: Rust init 2026-09-17 15:27:29 -03:00
theming core: Rust init 2026-09-17 15:27:29 -03:00
AGENTS.md doc: Documentacion sobre de que va ir el proyecto 2026-09-17 15:26:47 -03:00
Cargo.lock core: Rust init 2026-09-17 15:27:29 -03:00
Cargo.toml core: Rust init 2026-09-17 15:27:29 -03:00
CLAUDE.md doc: Documentacion sobre de que va ir el proyecto 2026-09-17 15:26:47 -03:00
README.md doc: Documentacion sobre de que va ir el proyecto 2026-09-17 15:26:47 -03:00
skills-created.md doc: Documentacion sobre de que va ir el proyecto 2026-09-17 15:26:47 -03:00

G Desktop

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.

Release Rust Wayland Smithay GTK4 wgpu KDL Lua


🧭 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 warnings y cargo 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