Configuración completa de escritorio con Hyprland y una shell 100% nativa en Quickshell: barra, dashboard, launcher de apps, gestor de WiFi/Bluetooth, gestor de wallpapers, selector de tema con vista previa, OSD de volumen/brillo, y centro de notificaciones — todo escrito en QML, con Quickshell como única capa de interfaz.
Soporta múltiples rices bajo un mismo framework: cada rice vive en
rices/<nombre>/, se activa/cambia con el comando rice, y solo tiene que
cumplir el contrato de comportamiento en rices/CONTRATO.md — la forma
(colores, layout, animaciones) es 100% libre por rice.
rices/default/— el rice activo hoy (tema Tokyo Night + extracción de color dinámica). Todo en QML:Bar.qml,Sidebar.qml(dashboard),Launcher.qml,Connectivity.qml(WiFi/Bluetooth nativo),WallpaperPicker.qml,ThemeSwitcher.qml,Settings.qml,Osd.qml, notificaciones, ymodules/(workspaces, CPU, RAM, disco, batería, red, mpris, reloj...).rices/CONTRATO.md— qué tiene que cumplir cualquier rice nuevo.bin/rice— CLI para listar, cambiar y chequear dependencias de rices (rice list,rice switch <nombre>,rice check <nombre>).- hypr/ —
hyprland.conf,hyprlock.conf,hyprpaper.conf, binds, yscripts/(monitor principal, OCR).ATAJOS.mdtiene la lista completa. - matugen/ — motor de generación de paleta (Material You) que alimenta a Quickshell, ghostty, hyprlock y los bordes de Hyprland.
- keyd/ — capa de compatibilidad de teclado estilo macOS (
SUPER= Cmd). Importante: cualquier atajo nuevo con$mainModnecesita también una línea enkeyd/default.conf([mac_cmd+control]) o no va a responder al apretar la tecla física — ver comentarios en el archivo. - lightdm/ — theming opcional del greeter (pantalla de login), con script de aplicación seguro (respaldo automático, no reinicia la sesión activa).
- ghostty/ — terminal, integrada al sistema de temas.
- Quickshell es la única capa de interfaz activa; barra, launcher,
dashboard, OSD y notificaciones viven en
rices/<nombre>/.
sudo pacman -S hyprland quickshell matugen nwg-displays keyd brightnessctl \
wireplumber hyprpaper hyprlock hyprshot thunar xarchiver file-roller \
wl-clipboard tesseract tesseract-data-spa glow polkit-kde-agent qt5ct
Fuente: JetBrainsMono Nerd Font (pacman -S ttf-jetbrains-mono-nerd).
Íconos: Qogir.
Cada rice declara sus propios paquetes en rice.toml — rice check default
te dice exactamente qué falta en la máquina donde estés instalando.
git clone <esta-url> ~/dotfiles
cd ~/dotfiles
./install.sh
El script:
- Symlinkea cada carpeta a
~/.config/<app>, respaldando lo que ya tengas. - Activa el rice
default(~/.config/quickshell→rices/default). - Agrega
bin/al PATH (comandorice). - Crea
~/wallpapers/si no existe.
Después, activá el teclado estilo macOS:
sudo cp keyd/default.conf /etc/keyd/default.conf
sudo systemctl enable --now keyd
(usá sudo systemctl restart keyd, no keyd reload — esa vía tiene un bug
conocido en algunas versiones que tumba el servicio entero.)
Wallpapers: no se incluyen imágenes de terceros. Poné las tuyas en
~/wallpapers/ y elegí una con SUPER+CTRL+W.
rice list # rices disponibles, cuál está activo
rice current # nombre del rice activo
rice switch <nombre> # cambia de rice (symlink + reinicio de Quickshell)
rice check <nombre> # qué paquetes del rice.toml faltan instalar
rice bootstrap <nombre> # instala los que falten (pide confirmación)
Ver hypr/ATAJOS.md, o CTRL + / una vez dentro de Hyprland.
| Atajo | Acción |
|---|---|
SUPER + CTRL + Enter |
Terminal |
SUPER + CTRL + D / SUPER + Space |
Launcher de apps |
SUPER + CTRL + X |
Dashboard |
SUPER + CTRL + N |
WiFi / Bluetooth |
SUPER + CTRL + W |
Gestor de wallpapers |
SUPER + CTRL + A |
Selector de tema |
SUPER + CTRL + C |
Cajón de configuración |
SUPER + CTRL + Z |
Modo zen (oculta la barra) |
SUPER + SHIFT + 3/4/5 |
Capturas: completa / área / ventana |
Corre matugen para regenerar los colores de Quickshell, ghostty, hyprlock y
los bordes de Hyprland, a partir de un preset con vista previa (Tokyo Night,
Catppuccin Mocha, Nord, Gruvbox, Rosé Pine, Dracula, Everforest, Oxocarbon) o
del wallpaper activo. "Tokyo Night" es el original, guardado en
hypr/themes/tokyo-night/ como respaldo exacto.
Íconos: Nerd Fonts. Paleta base: Tokyo Night. Generación de color: matugen. Shell: Quickshell.
