Skip to content
M1KE
Back to projects

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.

dotfiles: un escritorio Hyprland oscuro, limpio y rápido

CachyOS Hyprland Waybar zsh

Un escritorio completo con un solo comando: ./install.sh

🚀 Instalar · 📸 Capturas · 🧠 Cómo funciona


Escritorio: Waybar, kitty con fastfetch y prompt starship

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 (★).

Menú del instalador Confirmación antes de instalar
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 teclas 1 2 3, o escribe instalar, reparar o deshacer (basta con el principio: rep). q o Esc salen sin tocar nada.
  • Sin menú (scripts, SSH sin terminal completa): ./install.sh --instalar, --reparar o --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 ~/.config apunta 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: .zshrc y .bashrc solo cargan starship, zoxide, fnm o Rust si existen, y .bashrc solo salta a zsh si 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

Lanzador Rofi
Rofi con iconos, buscador y la misma paleta del escritorio
Selector de fondos
Selector de fondos (Ctrl + Alt + W): tus carpetas, vista previa, fundido y fondo del bloqueo
Pantalla de bloqueo hyprlock
hyprlock: tu fondo oscurecido y desenfocado, hora en DM Serif Display, avatar y campo de cristal
Menú de sesión y notificaciones
Menú de sesión con confirmación (Super + Esc) y notificaciones de mako a juego

⌨️ Atajos (Super = tecla Windows)

Aplicaciones

Atajo Acción
Super + Enter · Ctrl + Alt + T Terminal (kitty)
Super + E Archivos (Nautilus)
Super + D · Alt + Espacio Lanzador de apps
Super + Tab Selector de ventanas
Super + R Ejecutar comando
Super + Shift + V Historial del portapapeles
Super + . Selector de emojis
Super + W Wifi
Super + B Bluetooth
Super + Esc Menú de apagado (pide confirmación)
Ctrl + Alt + W Selector de fondos
Super + Shift + W Fondo al azar
Super + L Bloquear pantalla

Ventanas y escritorios

Atajo Acción
Super + Q Cerrar ventana
Super + F Pantalla completa
Super + V Flotante / mosaico
Super + P · Super + J Pseudo-mosaico · cambiar división
Super + ← ↑ ↓ → Mover el foco
Super + Shift + ← ↑ ↓ → Mover la ventana
Super + 1…0 Ir al escritorio 1–10
Super + Shift + 1…0 Enviar ventana al escritorio
Super + rueda Escritorio siguiente / anterior
Super + clic izq / der Arrastrar / redimensionar
Super + Shift + E Salir de Hyprland

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.lua solo 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 muestra n/a si no hay ninguna.
  • Pantalla — hyprland.lua no lleva monitores fijos: carga equipo.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 --reparar fija la mejor tasa. Los .lua/.conf de 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 hwmon1 no es la CPU, el instalador busca k10temp, coretemp o zenpower y 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 un git pull actualiza 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 --deshacer quita 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-sched y borra /etc/sysctl.d/99-rendimiento.conf.

📝 Notas

  • Lo propio de cada PC (pantallas) va en ~/.config/hypr/equipo.lua, no en hyprland.lua.
  • Hyprland carga hyprland.lua si existe; edita siempre ese archivo y deja el .conf como 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.

Hecho con 🖤 para CachyOS · Hyprland · Wayland