> For the complete documentation index, see [llms.txt](https://hacking-notes.jord4n.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hacking-notes.jord4n.pro/es/useful-resources/gh0stzk-bspwm-dotfiles.md). # Configuración de hacker en Arch Linux con BSPWM [gh0stzk/dotfiles](https://github.com/gh0stzk/dotfiles) es un entorno de escritorio BSPWM completo para Arch Linux y distribuciones basadas en Arch. Incluye temas, barras, lanzadores, ajustes de terminal, ZSH, Neovim, applets de Rofi, fondos de pantalla y scripts de ayuda para cambiar de estilo rápidamente.
gh0stzk BSPWM dotfiles desktop screenshot with terminal and Linux fetch output

Ejemplo de entorno de escritorio BSPWM del README del proyecto.

{% hint style="warning" %} Instala esto solo en una máquina de laboratorio personal o en una estación de trabajo Linux nueva. Los dotfiles reemplazan muchos archivos de configuración del usuario, así que revisa el instalador y haz una copia de seguridad de tu configuración actual antes de ejecutarlo. {% endhint %} ## Dónde encaja Esto pertenece en `Recursos útiles` porque es un recurso de configuración de estación de trabajo, no una herramienta de pentesting. Úsalo cuando quieras un entorno BSPWM limpio basado en Arch para notas diarias, laboratorios, trabajo de CTF, desarrollo y flujos de trabajo intensivos en terminal. ## Qué te ofrece | Componente | Qué significa | | ----------------------- | --------------------------------------------------------------------------------------------------------------- | | BSPWM | Gestor de ventanas en mosaico para un escritorio rápido controlado por teclado. | | 18 temas | Estilos visuales listos para usar que se pueden cambiar al vuelo. | | Polybar | Barra de escritorio con espacios de trabajo, módulos, información del sistema y colores del tema. | | Applets de Rofi | Menús para aplicaciones, energía, capturas de pantalla, portapapeles, red, Bluetooth, fondos de pantalla y más. | | Terminales | Compatibilidad con temas para Alacritty, Kitty, Ghostty, ST y Xfce Terminal. | | Configuración de ZSH | Configuración rápida del shell con autocompletado, búsqueda en el historial y vistas previas de fzf-tab. | | Configuración de Neovim | Configuración de editor preconstruida con LSP, autocompletado, formato, explorador, barra de estado y panel. | | RiceEditor | Aplicación de ayuda para ajustar la configuración visual sin editar manualmente cada archivo de configuración. | ## Vista previa visual El proyecto es muy visual, así que revisa las capturas y la demo antes de instalarlo.
gh0stzk dotfiles theme selector screenshot

Selector de temas.

gh0stzk dotfiles wallpaper selector screenshot

Selector de fondo de pantalla.

gh0stzk dotfiles RiceEditor screenshot

RiceEditor para personalizar el tema.

### Demo del proyecto {% embed url="" %} ### Guía de instalación de Arch Este video del creador es útil si quieres una instalación limpia de Arch antes de aplicar los dotfiles. {% embed url="" %} ### Canal del proyecto El canal del autor contiene más demostraciones de BSPWM, Polybar, Eww, Rofi y temas. {% embed url="" %} ## Antes de instalar El instalador oficial está pensado para Arch Linux y distribuciones basadas en Arch. El README indica que las distribuciones que no usan systemd, como Artix, no están soportadas. Punto de partida recomendado: | Requisito | Notas | | ---------------------------- | -------------------------------------------------------------------------------------- | | Distro Arch o basada en Arch | Una instalación nueva es lo más seguro. | | Cuenta de usuario normal | No ejecutes el instalador como root. | | Internet funcional | El instalador descarga paquetes y repositorios. | | Gestor de inicio de sesión | El proyecto recomienda LightDM. | | NetworkManager | Necesario para el applet de red de Rofi. | | Copia de seguridad | Conserva una copia de los archivos existentes `~/.config` y de los archivos del shell. | Comando útil de respaldo antes de probar: ```bash mkdir -p "$HOME/dotfiles-backup" cp -a "$HOME/.config" "$HOME/dotfiles-backup/config-$(date +%F)" 2>/dev/null cp -a "$HOME/.zshrc" "$HOME/.gtkrc-2.0" "$HOME/.icons" "$HOME/dotfiles-backup/" 2>/dev/null ``` ## Configuración rápida de Arch Úsalo cuando partas de una máquina o VM Arch limpia y quieras la ruta práctica más corta. ### 1. Arranca la ISO de Arch Empieza desde la ISO oficial de Arch. Si usas Wi-Fi, conéctate primero: ```bash iwctl ``` Dentro de `iwctl`: ``` device list station wlan0 scan station wlan0 get-networks station wlan0 connect "SSID" exit ``` Comprueba Internet: ```bash ping -c 3 archlinux.org ``` Sincroniza la hora: ```bash timedatectl set-ntp true ``` ### 2. Instala Arch rápidamente La ruta rápida es `archinstall`: ```bash archinstall ``` Opciones recomendadas: | Opción | Elige | | -------------------- | ---------------------------------------------------------------------------- | | Diseño de disco | Predeterminado o manual, según tu VM/disco. | | Cargador de arranque | `systemd-boot` para UEFI, GRUB si lo prefieres. | | Perfil | Minimal es suficiente; el escritorio es opcional. | | Red | NetworkManager. | | Audio | PipeWire. | | Usuario | Crea un usuario normal con acceso sudo. | | Paquetes extra | `git curl base-devel xorg-server lightdm lightdm-gtk-greeter networkmanager` | Después de la instalación: ```bash reinicia ``` ### 3. Habilita lo básico Inicia sesión como tu usuario normal y luego asegúrate de que los servicios base estén listos: ```bash sudo pacman -Syu sudo pacman -S --needed git curl base-devel xorg-server lightdm lightdm-gtk-greeter networkmanager sudo systemctl enable --now NetworkManager sudo systemctl enable lightdm ``` Reinicia una vez más si acabas de habilitar LightDM: ```bash sudo reboot ``` ## Instalación de dotfiles Abre una terminal desde tu directorio personal: ```bash cd "$HOME" ``` Descarga el instalador oficial: ```bash curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller ``` Revisa el instalador antes de ejecutarlo: ```bash less RiceInstaller ``` Dale permiso de ejecución: ```bash chmod +x RiceInstaller ``` Ejecutalo como tu usuario normal: ```bash ./RiceInstaller ``` El instalador es interactivo. Puede preguntar si quieres las configuraciones incluidas de Neovim y Firefox. Lee cada aviso en lugar de pulsar enter en todo. ### Instalación en un solo bloque Para una instalación rápida de laboratorio después de tener Arch funcionando: ```bash cd "$HOME" curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller less RiceInstaller chmod +x RiceInstaller ./RiceInstaller ``` ## Qué hace el instalador A alto nivel, el instalador: 1. Comprueba que no se esté ejecutando como root. 2. Comprueba que se esté ejecutando desde `$HOME`. 3. Añade el repositorio de paquetes `gh0stzk-dotfiles` . 4. Añade Chaotic-AUR. 5. Descarga los dotfiles. 6. Hace copia de seguridad de las configuraciones existentes del usuario cuando es necesario. 7. Instala el entorno BSPWM. 8. Habilita MPD para las funciones de música. 9. Cambia el shell a ZSH. El script también mueve muchas carpetas de configuración existentes a un directorio de respaldo antes de reemplazarlas. Aun así, conserva primero tu propia copia de seguridad. ## Primer inicio de sesión Después de la instalación: 1. Reinicia o cierra sesión. 2. Selecciona la sesión BSPWM desde tu gestor de inicio de sesión. 3. Inicia sesión normalmente. 4. Espera a que termine la autoconfiguración del primer inicio. 5. Prueba la terminal, Rofi, Polybar, el selector de temas y el selector de fondos. Si estás en una máquina virtual y el escritorio se siente roto o lento, intenta cambiar Picom de `glx` a `xrender` antes de asumir que la instalación falló. ## Primeras cosas que revisar Después del primer inicio, verifica las variables relacionadas con el hardware. Abre: ```bash ~/.config/bspwm/config/system.ini ``` Comprueba los valores de: | Valor | Por qué importa | | ------------------- | ----------------------------------------- | | Interfaz de red | Módulos de red en la barra. | | Tarjeta gráfica | Algunos módulos visuales y de estado. | | Batería y adaptador | Módulos de batería y brillo del portátil. | Si estás en un PC de escritorio, la interfaz de red suele ser la principal a la que debes prestar atención. ## Comandos útiles | Comando | Utilice | | ----------------------------------- | --------------------------------------------------------------------------- | | `RiceSelector` | Abre el selector de temas. | | `RiceEditor` | Edita visualmente el tema actual. | | `WallSelect` | Abre el selector de fondos. | | `Term --selecterm` | Elige la aplicación de terminal. | | `OpenApps --menu` | Abre el lanzador de aplicaciones. | | `OpenApps --KeyHelp` | Abre la chuleta de atajos de teclado. | | `OpenApps --screenshot` | Abre la herramienta de capturas de pantalla. | | `OpenApps --netmanager` | Abre el applet de gestión de red. | | `OpenApps --bluetooth` | Abre el applet de Bluetooth. | | `OpenApps --clipboard` | Abre el gestor del portapapeles. | | `OpenApps --powermenu` | Abre el menú de energía. | | `OpenApps --keyboard` | Abre el applet de distribución del teclado. | | `OpenApps --scratch` | Abre el scratchpad. | | `HideBar -h` | Oculta las barras. | | `HideBar -u` | Muestra las barras. | | `SoftReload` | Recarga suavemente el entorno. | | `ScreenLocker` | Bloquea la pantalla. | | `bspc wm -r` | Recarga BSPWM. | | `pkill -USR1 -x sxhkd` | Recarga los atajos de teclado. | | `~/.config/bspwm/config/system.ini` | Variables de hardware/módulo que debes verificar después de la instalación. | | `~/.config/bspwm/config/sxhkdrc` | Archivo principal de atajos de teclado. | ## Atajos de teclado completos El proyecto muestra la chuleta visual con `Alt + F1`. `Super` significa la tecla Windows en la mayoría de los teclados. La fuente de verdad es el archivo instalado `~/.config/bspwm/config/sxhkdrc`; esta tabla sigue el archivo actual del upstream y agrupa cada atajo para que sea más fácil de revisar. ### Ayuda | Teclas | Acción | | ---------- | ---------------------------------------- | | `Alt + F1` | Muestra la chuleta de atajos de teclado. | ### Aplicaciones principales | Teclas | Acción | | ---------------------- | -------------------------------------- | | `Super + Return` | Abre la terminal normal. | | `Super + Alt + Return` | Abre la terminal flotante. | | `Super + Space` | Abre el lanzador de aplicaciones. | | `Alt + Space` | Abre el selector de temas. | | `Super + B` | Abre el navegador. | | `Super + E` | Abre el editor. | | `Super + F` | Abre el gestor de archivos. | | `Super + Y` | Abre Yazi. | | `Super + V` | Abre Neovim. | | `Super + M` | Abre el reproductor de música/Ncmpcpp. | | `Super + P` | Abre Pavucontrol. | | `Super + T` | Abre Telegram. | | `Super + W` | Abre WhatsApp. | | `Super + R` | Abre RiceEditor. | ### Applets de Rofi | Teclas | Acción | | ------------------------------- | ------------------------------------- | | `Super + Alt + T` | Selector de terminal. | | `Super + Alt + W` | Selector de fondo de pantalla. | | `Super + Alt + A` | Applet para montar Android. | | `Super + Alt + N` | Gestor de red. | | `Super + Alt + B` | Gestor de Bluetooth. | | `Super + Alt + C` | Gestor del portapapeles. | | `Super + Alt + S` | Herramienta de capturas de pantalla. | | `Super + Alt + P` | Menú de energía. | | `Super + Alt + L` | Selector de estilo del lanzador Rofi. | | `Super + Alt + K` | Applet de distribución del teclado. | | `Super + Alt + X` | Applet de RofiPass/contraseñas. | | `Clic derecho en el escritorio` | Abre Jgmenu. | ### Sistema y entorno | Teclas | Acción | | ------------------------ | --------------------------------------------------- | | `Super + Alt + O` | Scratchpad. | | `Ctrl + Super + Alt + P` | Apaga el equipo. | | `Ctrl + Super + Alt + R` | Reinicia el equipo. | | `Ctrl + Super + Alt + Q` | Cierra sesión. | | `Ctrl + Super + Alt + L` | Bloquea la pantalla. | | `Ctrl + Super + Alt + K` | Mata la aplicación con `xkill`. | | `Ctrl + Super + Alt + S` | Recarga suave. | | `Super + Alt + H` | Oculta la barra. | | `Super + Alt + U` | Muestra la barra. | | `Ctrl + Alt + Plus` | Aumenta la transparencia de la ventana enfocada. | | `Ctrl + Alt + Minus` | Disminuye la transparencia de la ventana enfocada. | | `Ctrl + Alt + T` | Restablece la transparencia de la ventana enfocada. | | `XF86MonBrightnessUp` | Aumenta el brillo. | | `XF86MonBrightnessDown` | Disminuye el brillo. | | `XF86AudioRaiseVolume` | Aumenta el volumen. | | `XF86AudioLowerVolume` | Disminuye el volumen. | | `XF86AudioMute` | Activa o desactiva el silencio. | | `XF86AudioNext` | Pista multimedia siguiente. | | `XF86AudioPrev` | Pista multimedia anterior. | | `XF86AudioPlay` | Reproduce/pausa multimedia. | | `XF86AudioStop` | Detener la reproducción multimedia. | ### Núcleo de BSPWM | Teclas | Acción | | ------------------- | ---------------------------------------------- | | `Super + Alt + R` | Recarga BSPWM. | | `Super + X` | Cerrar el nodo enfocado. | | `Super + Shift + X` | Matar el nodo enfocado. | | `Super + Escape` | Recargar las combinaciones de teclas de sxhkd. | ### Estados y banderas del nodo | Teclas | Acción | | ----------------- | ------------------------------------------------- | | `Alt + T` | Establecer nodo en mosaico. | | `Alt + Shift + T` | Establecer nodo pseudoen mosaico. | | `Alt + A` | Establecer nodo flotante. | | `Alt + F` | Establecer nodo en pantalla completa. | | `Alt + M` | Alternar bandera marcado. | | `Alt + X` | Alternar bandera bloqueado. | | `Alt + S` | Alternar bandera fijo. | | `Alt + P` | Alternar bandera privada. | | `Alt + H` | Ocultar la ventana enfocada. | | `Ctrl + Alt + H` | Mostrar menú para restaurar las ventanas ocultas. | ### Espacios de trabajo y enfoque | Teclas | Acción | | --------------------------------------- | ---------------------------------------------------------------------- | | `Ctrl + Tab` | Rotar el escritorio. | | `Super + Left` | Cambiar al espacio de trabajo anterior. | | `Super + Right` | Cambiar al siguiente espacio de trabajo. | | `Super + 1` a `Super + 9` | Enfocar los espacios de trabajo del 1 al 9. | | `Super + 0` | Enfocar el espacio de trabajo 10. | | `Super + Ctrl + 1` a `Super + Ctrl + 9` | Enviar la ventana enfocada al espacio de trabajo del 1 al 9. | | `Super + Ctrl + 0` | Enviar la ventana enfocada al espacio de trabajo 10. | | `Super + Ctrl + Left` | Enviar la ventana enfocada al espacio de trabajo anterior y seguirla. | | `Super + Ctrl + Right` | Enviar la ventana enfocada al siguiente espacio de trabajo y seguirla. | | `Alt + Tab` | Selector de ventanas. | | `Super + Alt + Left` | Enfocar la ventana al oeste, o la anterior como alternativa. | | `Super + Alt + Down` | Enfocar la ventana al sur. | | `Super + Alt + Up` | Enfocar la ventana al norte. | | `Super + Alt + Right` | Enfocar la ventana al este, o la siguiente como alternativa. | | `Ctrl + Alt + Left` | Intercambiar la ventana enfocada al oeste. | | `Ctrl + Alt + Down` | Intercambiar la ventana enfocada al sur. | | `Ctrl + Alt + Up` | Intercambiar la ventana enfocada al norte. | | `Ctrl + Alt + Right` | Intercambiar la ventana enfocada al este. | | `Ctrl + Shift + Comma` | Enfocar el último nodo. | | `Ctrl + Shift + Period` | Enfocar el último escritorio. | ### Preselección | Teclas | Acción | | ------------------ | ---------------------------------------- | | `Super + Ctrl + H` | Preseleccionar división horizontal/este. | | `Super + Ctrl + V` | Preseleccionar división vertical/sur. | | `Super + Ctrl + Q` | Cancelar la preselección. | ### Mover y redimensionar | Teclas | Acción | | ----------------------- | ----------------------------------------- | | `Super + Ctrl + B` | Equilibrar los nodos del escritorio. | | `Super + Alt + Plus` | Aumentar el tamaño del nodo en mosaico. | | `Super + Alt + Minus` | Reducir el tamaño del nodo en mosaico. | | `Super + Ctrl + Plus` | Aumentar el tamaño del nodo flotante. | | `Super + Ctrl + Minus` | Reducir el tamaño del nodo flotante. | | `Super + Shift + Left` | Mover la ventana flotante a la izquierda. | | `Super + Shift + Down` | Mover la ventana flotante hacia abajo. | | `Super + Shift + Up` | Mover la ventana flotante hacia arriba. | | `Super + Shift + Right` | Mover la ventana flotante a la derecha. | ### Operación múltiple | Teclas | Acción | | ---------------------------- | ---------------------------------------------------------------- | | `Super + Ctrl + X` | Cerrar todos los nodos del escritorio actual. | | `Super + N`, luego `X` | Cerrar todas las ventanas locales no enfocadas. | | `Super + N`, luego `K` | Matar todas las ventanas locales no enfocadas. | | `Super + N`, luego `M` | Traer todas las ventanas marcadas al escritorio enfocado. | | `Super + N`, luego `1` a `9` | Traer todas las ventanas de ese escritorio al escritorio actual. | ## Personalización común ### Cambiar tema Usar: ``` Alt + Space ``` Elige un tema del selector. El entorno se actualiza sin necesidad de reiniciar toda la sesión. ### Cambiar fondo de pantalla Usar: ``` Super + Alt + W ``` El proyecto admite fondos de pantalla aleatorios, directorios personalizados, fondos de pantalla fijos, fondos de pantalla animados y comportamiento de presentación de diapositivas. ### Editar el tema actual Usa RiceEditor cuando quieras ajustar la configuración visual sin editar manualmente cada módulo: ``` RiceEditor ``` Las ediciones típicas incluyen bordes, sombras, animaciones, transparencia, el comportamiento del fondo de pantalla y la configuración de módulos específica del tema. ## Solución de problemas | Problema | Qué revisar | | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------- | | El inicio de sesión vuelve al gestor de pantalla | Confirma que la sesión de BSPWM está instalada y revisa `~/.xsession-errors`. | | Los módulos de la barra son incorrectos | Comprobar `~/.config/bspwm/config/system.ini`. | | El applet de red no funciona | Confirma que NetworkManager está instalado y en ejecución. | | Los gráficos de la VM se ven defectuosos | Prueba Picom `xrender` backend en lugar de `glx`. | | Los atajos de teclado fallan | Comprobar `sxhkd` se está ejecutando y revisa `~/.config/bspwm/config/sxhkdrc`. | | El tema se ve desalineado | El proyecto está diseñado para 1600x900 y 96 DPI; ajústalo a tu monitor. | | Las configuraciones existentes desaparecieron | Revisa la carpeta de copias de seguridad creada por el instalador y la tuya propia `dotfiles-backup`. | ## Notas para una reinstalación limpia Para volver a intentarlo de la forma más segura: 1. Haz una copia de seguridad de tus archivos actuales. 2. Elimina o mueve los directorios antiguos de dotfiles. 3. Vuelve a descargar la versión más reciente de `RiceInstaller`. 4. Revisa el script de nuevo. 5. Ejecútalo desde `$HOME` como usuario normal. No ejecutes instaladores modificados al azar de forks de terceros a menos que hayas revisado el diff. ## Referencias * [Repositorio oficial de gh0stzk/dotfiles](https://github.com/gh0stzk/dotfiles) * [RiceInstaller](https://github.com/gh0stzk/dotfiles/blob/master/RiceInstaller) * [Primeros pasos después de la instalación](https://github.com/gh0stzk/dotfiles/wiki/First-steps-after-installation) * [Wiki de atajos de teclado](https://github.com/gh0stzk/dotfiles/wiki/Keyboard-Shortcuts) * [Archivo actual de combinaciones de teclas sxhkdrc](https://github.com/gh0stzk/dotfiles/blob/master/config/bspwm/config/sxhkdrc) * [Wiki de configuración de fondos de pantalla](https://github.com/gh0stzk/dotfiles/wiki/Wallpapers-Configuration) * [ArchWiki: bspwm](https://wiki.archlinux.org/title/Bspwm) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://hacking-notes.jord4n.pro/es/useful-resources/gh0stzk-bspwm-dotfiles.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.