suckless/README.md
alejandrogs73 3aa250c8dd Dotfiles de la sesión e install.sh para Void
- home/: xinitrc, bashrc, bash_profile, gitconfig, picom, dunst,
  mimeapps.list y el fondo de pantalla. Se enlazan en ~ con la misma ruta.
- xinitrc: feh directamente en vez de .fehbg, y XDG_RUNTIME_DIR a mano solo
  si elogind no lo ha creado.
- mimeapps.list: firefox.desktop en vez del .desktop autogenerado.
- install.sh: instala los paquetes de Void, compila los programas, enlaza
  home/, prepara GnuPG (permisos, pinentry-gtk y agente SSH), copia
  sistema/ y activa servicios y grupos.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016UdJsHrbkmzhoCb6TthP2m
2026-09-27 17:52:32 +02:00

107 lines
4.5 KiB
Markdown

# suckless
Mis dotfiles para Void Linux: dwm, st, dmenu, slstatus, slock, scroll y
clipmenu, más la configuración de la sesión (xinitrc, bash, picom, dunst...).
Tema Everforest y fuente Fira Code en todos.
## Estructura
| Carpeta | Contenido |
|---|---|
| `suckless/` | Los programas, cada uno con su `config.h` y sus parches |
| `home/` | Archivos que van en `~`, con la misma ruta (se enlazan) |
| `sistema/` | Archivos que van en `/` (acpid, zzz, elogind) |
| `install.sh` | Lo instala todo en un Void recién instalado |
## Instalar
En un Void recién instalado, como tu usuario (pide sudo cuando hace falta):
git clone ssh://forgejo@ssh.alejandrogs.es/alejandrogs73/suckless.git ~/suckless
cd ~/suckless && ./install.sh
Hace cinco pasos, que también se pueden lanzar por separado
(`./install.sh enlaces`, por ejemplo) y repetir sin problema:
1. `paquetes`: instala con xbps todo lo que usa la configuración.
2. `suckless`: compila e instala los programas en `/usr/local`.
3. `enlaces`: enlaza cada archivo de `home/` en `~`. Si ya existía un archivo
distinto, lo guarda como `.bak`. Como son enlaces, editar `~/.bashrc` es
editar el repo.
4. `gnupg`: para después de copiar `~/.gnupg` a mano (de un USB, por
ejemplo). Arregla los permisos, pone `pinentry-gtk` (en una tty cae a
curses solo), activa el agente SSH de gpg y añade a `sshcontrol` las
subclaves de autenticación. `.bashrc` ya apunta `SSH_AUTH_SOCK` al agente.
Si `~/.gnupg` no existe todavía, no hace nada.
5. `sistema`: copia `sistema/` en `/`, activa los servicios de runit (dbus,
elogind, polkitd, NetworkManager, bluetoothd, acpid, chronyd), quita
dhcpcd y wpa_supplicant (NetworkManager ya gestiona la red) y añade el
usuario a los grupos audio, video, input, network y bluetooth.
Después hay que cerrar sesión y volver a entrar (por los grupos) y lanzar
`startx`.
Nix no se instala: lo poco que viene de ahí (webcord) se instala a mano.
## Recompilar tras cambiar la configuración
cd suckless/dwm && make && sudo make install
## Actualizar desde el proyecto original
Cada programa se importó con `git subtree --squash`:
git subtree pull --prefix=suckless/dwm https://git.suckless.org/dwm master --squash
git subtree pull --prefix=suckless/clipmenu https://github.com/cdown/clipmenu develop --squash
Los demás funcionan igual que dwm, cambiando el nombre en `--prefix` y en la URL.
## Atajos de dwm
`Mod` es `Super` (en el dwm original es `Alt`). Los atajos de ratón también usan
`Super`. Solo aparecen los atajos que cambian respecto al original o que son
nuevos; el resto están igual. Los atajos de st, scroll, dmenu y slock no se han
tocado.
### Cambiados
| Acción | Original | Ahora |
|---|---|---|
| Abrir terminal (`st`) | Mod+Shift+Return | Mod+Return |
| zoom (mover la ventana al área principal) | Mod+Return | Mod+Shift+Return |
| Cerrar ventana | Mod+Shift+c | Mod+q |
| Salir de dwm | Mod+Shift+q | Mod+Shift+m |
### Nuevos
| Atajo | Acción |
|---|---|
| Mod+v | clipmenu (misma paleta y fuente que dmenu) |
| Mod+Shift+l | Bloquear la pantalla con `slock` |
| Mod+`-` / Mod+`+` | Reducir / aumentar los gaps |
| Mod+Shift+`+` | Gaps a 0 |
| Tecla de subir / bajar volumen | Volumen ±5% con `wpctl` (máximo 100%) |
| Tecla de silenciar | Silenciar o activar el audio |
| Tecla de silenciar micro o Mod+ñ | Silenciar o activar el micrófono |
| Impr Pant | Captura de pantalla completa con `maim` |
| Shift+Impr Pant | Captura de una región |
Las capturas se guardan en `~/Imágenes/Capturas`, se copian al portapapeles y
muestran una notificación.
## Notas
- La configuración personal está en `config.h`. `config.def.h` es la versión
original más los parches. Si un parche cambia `config.def.h`, hay que pasar
el cambio a mano a `config.h`: `make` solo lo copia si `config.h` no existe.
- Los parches aplicados están en `suckless/<programa>/patches/`.
- dwm: fullgaps, restartsig, preserveonrestart, statuscmd-nosignal y swallow.
- st: kitty-graphics, alpha, glyph-wide-support y ligatures, en ese orden.
kitty-graphics ya incluye anysize. glyph-wide-support y la combinación
con ligatures vienen de la rama `graphics-with-patches` de
[st-graphics](https://github.com/sergei-grechanik/st-graphics), sin
boxdraw.
- st muestra imágenes con el protocolo de gráficos de kitty; yazi lo detecta
solo y enseña las vistas previas sin ueberzugpp.
- slock está modificado a mano (no es un parche): reloj, fecha, batería y
una barra inferior con el color del estado.