dotfiles
Dark Hyprland desktop on CachyOS/Arch: Waybar, Rofi, kitty, zsh with starship, GNOME theme and a smart installer.
This README is only available in Spanish.
Un escritorio completo con un solo comando: ./install.sh
🚀 Instalar · 📸 Capturas · 🧠 Cómo funciona
Barra flotante con métricas reales · kitty + fastfetch · prompt starship de una línea con pastillas
✨ Qué incluye
| 🪟 Hyprland | Configuración en Lua (hyprland.lua): atajos, animaciones, reglas de monitor y ventanas. hyprland.conf queda de respaldo. |
| 📊 Waybar | Una sola barra flotante casi opaca: 6 escritorios fijos, CPU y temperatura (con GPU y disco desplegables), RAM, audio y red en tiempo real (net.sh, con SSID y señal en el tooltip). |
| 🔍 Rofi | Lanzador, selector de ventanas, portapapeles, emojis, wifi, bluetooth y menú de apagado. |
| 🖥️ kitty + zsh + starship | Prompt de una línea con pastillas, autosugerencias, resaltado de sintaxis, zoxide, fzf y fastfetch. |
| 🖼️ Fondos | Selector propio (quickshell): eliges las carpetas, buscas, pruebas sin guardar, cambia con fundido (awww) y recuerda el último. También pone el fondo del bloqueo. |
| 🔒 hyprlock, mako, hypridle | Bloqueo con la hora en DM Serif y tu avatar; notificaciones y menú de apagado con la misma paleta negra de la barra. |
| 🎚️ EQ «M1ke EQ» | Ecualizador nativo de PipeWire; solo se activa si está conectado el DAC USB para el que está hecho. |
| 🎨 Tema GNOME oscuro | adw-gtk3-dark, iconos Adwaita, cursor Bibata y fuentes Inter + JetBrainsMono Nerd. |
| 🔊 PipeWire de baja latencia | Configuración lista en config/pipewire. |
| ⚡ Rendimiento (opcional) | BBR, wifi sin ahorro de energía, CPU en performance y planificador scx_lavd. |
| 🗃️ Copia y deshacer | Antes de tocar nada guarda tus configs en un .tar.gz; ./install.sh --deshacer lo deja todo como estaba. |
| 🧭 Instalador con menú | ./install.sh abre un menú en la terminal (instalar · reparar · deshacer): muestra el estado de tu equipo, recomienda qué hacer y pide confirmación. |
🚀 Instalación
git clone https://github.com/macorredor270/dotfiles ~/dotfiles
cd ~/dotfiles && ./install.sh
Se abre un menú en la terminal: te dice en qué estado está tu equipo y te recomienda qué hacer (★).
![]() |
![]() |
| Elige con ↑ ↓ y Enter, pulsa 1 2 3 o escribe la orden | Antes de actuar cuenta qué va a hacer y pide confirmación |
Tres órdenes, nada más:
| Orden | Qué hace |
|---|---|
| Instalar | Todo: actualiza el sistema, instala lo que falta (drivers según tu GPU), enlaza las configuraciones, activa los servicios, aplica el tema y los ajustes de rendimiento. |
| Reparar | Arregla enlaces rotos (por ejemplo si moviste o borraste el repositorio), recrea lo que falte y rehace los ajustes de este equipo (pantallas, fuentes, fondo). No instala nada ni pide sudo. |
| Deshacer | Vuelve atrás: quita todo lo que puso el instalador y devuelve tus configuraciones a como estaban antes de la primera instalación. |
- En el menú:
↑↓+Enter, las teclas123, o escribeinstalar,repararodeshacer(basta con el principio:rep).qoEscsalen sin tocar nada. - Sin menú (scripts, SSH sin terminal completa):
./install.sh --instalar,--repararo--deshacer. Sin terminal y sin orden solo muestra la ayuda: nunca instala por sorpresa. - Repetirlo no hace daño. Si ya está todo aplicado, lo detecta, lo dice y no toca nada; tampoco acumula copias de seguridad (guarda solo la de antes de la primera instalación).
- Mover o borrar el repositorio rompe los enlaces, porque
~/.configapunta a esa carpeta (la.zshrc, Hyprland, Waybar… dejan de cargar): Reparar los reapunta. Lo mejor es dejarlo siempre en~/dotfiles. - Antes de empezar comprueba bash ≥ 4.4, las herramientas básicas, que puedas escribir en tu carpeta y que el repositorio no esté en una ruta temporal (
/tmp,Descargas, un USB…), donde los enlaces acabarían rotos. - En una distro que no es Arch solo enlaza las configuraciones: no instala paquetes ni toca
/etc. - Si instalaste en un equipo sin configuraciones previas, Deshacer simplemente quita los enlaces.
- Las shells no fallan en un equipo distinto:
.zshrcy.bashrcsolo carganstarship,zoxide,fnmo Rust si existen, y.bashrcsolo salta azshsi está instalado. - Avatar del bloqueo: si no tienes
~/Pictures/avatar.png, se crea uno de ejemplo con tu inicial (cámbialo por el tuyo). - Los paquetes opcionales (Steam, Prism, Wine, Node, Rust, Podman, PostgreSQL, LibreOffice…) están en
packages/opcional.txt; no se instalan solos.
📸 Capturas
![]() Rofi con iconos, buscador y la misma paleta del escritorio |
![]() Selector de fondos ( Ctrl + Alt + W): tus carpetas, vista previa, fundido y fondo del bloqueo |
![]() hyprlock: tu fondo oscurecido y desenfocado, hora en DM Serif Display, avatar y campo de cristal |
![]() Menú de sesión con confirmación ( Super + Esc) y notificaciones de mako a juego |
⌨️ Atajos (Super = tecla Windows)
|
Aplicaciones
|
Ventanas y escritorios
|
Selector de fondos — Enter/clic: poner · Espacio/clic derecho: probar sin guardar (Esc lo deshace) · b/clic central: usarlo en el bloqueo ·
El fondo elegido también se usa en el bloqueo (Super + L), oscurecido y con un desenfoque suave que se ajusta en config/hypr/hyprlock.conf (brightness, blur_size, blur_passes); con b puedes poner otra imagen solo para el bloqueo hasta el siguiente cambio de fondo.
m: rellenar/ajustar/centrar · r: al azar · Tab: siguiente carpeta · a: añadir carpeta (escribe la ruta o pulsa examinar) · s: subcarpetas · /: buscar · ?: atajos.
Desde la terminal: fondo poner IMG, fondo siguiente, fondo carpetas añadir ~/ruta, fondo bloqueo IMG, fondo ayuda.
Capturas y sonido — Ctrl + Alt + S o Super + S: región · Ctrl + Alt + K: pantalla completa (se guardan en ~/Pictures/Screenshots y se copian al portapapeles, sin editor) ·
Ctrl + Alt + ↑ / ↓: volumen · teclas multimedia y de brillo.
🧠 Cómo funciona el instalador
install.sh está pensado para repetirse sin romper nada: si algo ya está bien, lo deja como está.
| Fase | Qué hace |
|---|---|
| Paquetes | pacman -Syu y solo instala lo que falta de packages/*.txt. Si un paquete no existe, lo salta y avisa; si falla en bloque, prueba uno a uno. Compila paru si no está. |
| Hardware | Detecta CPU y GPU por identificador PCI y añade el microcódigo y los drivers que toquen (nvidia-open-dkms o nvidia-dkms con las cabeceras de cada kernel, o Mesa/Vulkan para AMD e Intel). |
| Copia | Antes de enlazar, guarda en ~/.dotfiles-backup-FECHA.tar.gz todo lo que va a tocar (hypr, waybar, rofi, kitty, mako, shell, scripts…). Si la copia falla, no sigue. |
| Enlaces | Enlaza con symlinks cada archivo de config/ en ~/.config, más .zshrc, .bashrc, local-bin/ y los .desktop. Lo que ya existía se guarda en ~/.dotfiles-backup-FECHA/. |
| Equipo | Genera ~/.config/hypr/equipo.lua y equipo.conf con tus pantallas a su mejor resolución y tasa de refresco (leídas de Hyprland) y las variables de NVIDIA si hay NVIDIA. Instala DM Serif Display, prepara el fondo del bloqueo, pone el fondo y activa el EQ si está su DAC. |
| Shell / Servicios | zsh como shell y los servicios de red, Bluetooth, SDDM, PipeWire y aria2. |
| Tema | gsettings: modo oscuro, adw-gtk3-dark, iconos Adwaita, cursor Bibata y fuentes. |
| Sistema | Ajustes de /etc, cada uno solo si aplica a tu equipo (módulo del kernel, wifi, cpufreq, sched_ext). |
| Verificación | Programas (incluidos quickshell, awww, zenity y magick), fuentes (Inter, JetBrainsMono Nerd y DM Serif), enlaces, equipo.lua, el script fondo, sintaxis de .zshrc, Hyprland --verify-config y configuración de Rofi. |
Todo queda registrado en ~/.dotfiles-install.log.
🔧 Se adapta al equipo donde lo instalas
- GPU — las variables de NVIDIA de
hyprland.luasolo se aplican si el driver propietario está cargado. En AMD o Intel no se tocan: con ellas, la pantalla se quedaría en negro. El módulo de GPU de Waybar lee NVIDIA y AMD, y muestran/asi no hay ninguna. - Pantalla —
hyprland.luano lleva monitores fijos: cargaequipo.lua, que el instalador escribe en cada PC. Si instalas desde una TTY sin Hyprland, las pantallas quedan en automático; luego, ya dentro,./install.sh --repararfija la mejor tasa. Los.lua/.confde equipo no están en el repo y nunca se sobrescriben. - Portátil — la barra está pensada para sobremesa (sin batería). Las teclas de brillo sí funcionan si el equipo las tiene (
brightnessctl). - Temperatura de la CPU — si
hwmon1no es la CPU, el instalador buscak10temp,coretempozenpowery ajusta la ruta. - Rutas — si tu usuario no es
m1ke, los archivos con rutas escritas a mano se copian ya corregidos; el resto sigue enlazado al repo, así que ungit pullactualiza atajos y estilo sin reinstalar.
🗂️ Estructura
dotfiles/
├── install.sh instalador inteligente
├── config/ → ~/.config (hypr, waybar, rofi, kitty, mako, fastfetch, gtk-3.0/4.0, pipewire, systemd/user…)
├── local-bin/ → ~/.local/bin (fondo, screenshot, rofi-wifi, rofi-bluetooth, rofi-clipboard, rofi-power…)
├── local-share/ → ~/.local/share/applications (lanzadores)
├── packages/ listas de paquetes: pacman, aur y opcional (Steam, Prism, Wine… no se instalan solos)
├── system/ → /etc (sysctl, NetworkManager, systemd, modprobe) — solo con sudo y solo si aplica
├── templates/ archivos con la ruta de tu $HOME (aria2.conf)
├── wallpapers/ fondos de pantalla (lock-torres.png es el del bloqueo)
├── fonts/ → ~/.local/share/fonts (DM Serif Display, OFL)
├── extras/ piezas que solo se activan si aplican (EQ de PipeWire)
├── docs/ banner y capturas de este README
├── .zshrc .bashrc
↩️ Deshacer
- Configuraciones:
./install.sh --deshacerquita todo lo que puso el instalador (enlaces, copias ajustadas, fuentes,equipo.lua…; lo apunta en~/.local/state/dotfiles/instalado) y restaura la copia más antigua, la de antes de la primera instalación. Las copias usadas se apartan en~/.dotfiles-backups-usadas/. - Rendimiento:
sudo systemctl disable --now max-performance scx-schedy borra/etc/sysctl.d/99-rendimiento.conf.
📝 Notas
- Lo propio de cada PC (pantallas) va en
~/.config/hypr/equipo.lua, no enhyprland.lua. - Hyprland carga
hyprland.luasi existe; edita siempre ese archivo y deja el.confcomo respaldo. - NVIDIA: tras la primera instalación, reinicia para que DKMS compile el módulo y repite
./install.sh --instalar. - No incluye secretos (claves SSH, tokens) ni servicios de proyectos personales.
📄 Licencia
MIT © 2026 macorredor270.





