Guía de xbindkeys (mouse)

.xbindkeysrc.md

Guía de xbindkeys (mouse)

Archivo de configuración: ~/.xbindkeysrc

Cómo agregar o modificar una macro

Abre el archivo con tu editor. Cada macro usa este formato:

"comando a ejecutar"
    tecla o botón

Botones del mouse (X11)

• b:8 = atrás (lateral)
• b:9 = adelante (lateral)
• b:10, b:11, b:12... = otros botones extra

Para averiguar el número exacto de un botón:

xev

Pulsa el botón en la ventana de xev y anota el número que muestra (button N).

Ejemplos

Alternar ventanas:

"xdotool key alt+Tab"
  b:8

Alt+Tab "mantenido" (muestra miniaturas hasta el siguiente clic):

"nohup /home/jef/.xbindkeys-alt-tab.sh >/dev/null 2>&1 &"
  b:9

Minimizar:

"xdotool key super+d"
  b:10

Lanzar un programa:

"firefox"
  b:11

Script especial: Alt+Tab mantenido (~/.xbindkeys-alt-tab.sh)

Pulsa el botón (b:9) → se muestran las miniaturas de ventanas con Alt pulsado → haz clic en la que quieras → se confirma y Alt se suelta.

Detalles técnicos:

• Pulsa Alt+Tab y suelta Tab de inmediato (con pausas de 0.15s/0.05s) para que el WM muestre las miniaturas sin hacer loop de selección.
• Espera un clic con xinput test-xi2 --root 2 filtrando RawButtonPress (cualquier botón de cualquier ratón).
• Evita instancias duplicadas con un archivo PID en /tmp/xbindkeys-alt-tab.pid.
• Registra cada arranque en /tmp/alt-tab.log.

Para cambiar el botón asignado, modifica la línea b:9 en ~/.xbindkeysrc.

Cómo aplicar los cambios

pkill xbindkeys; xbindkeys -f ~/.xbindkeysrc

Arranque automático

Ya configurado: ~/.config/autostart/xbindkeys.desktop hace que xbindkeys inicie en cada sesión.

Para cambiarlo desde la GUI: Configuración → Sesión y arranque → Aplicaciones de arranque (aplica al mismo .desktop).

Instalación

Para una instalación desde cero:

sudo apt install xbindkeys xdotool

Generar el archivo de configuración por defecto (si no existe):

xbindkeys --defaults > ~/.xbindkeysrc

Probar que funciona:

xbindkeys -f ~/.xbindkeysrc

Estado actual de esta configuración

Botón	Acción
b:8 (atrás)	Alt+Tab (alterna ventanas)
b:9 (adelante)	Muestra miniaturas con Alt mantenido hasta el siguiente clic (~/.xbindkeys-alt-tab.sh)

• Mouse: Logitech G305 / UGREEN (ver xinput list).
• Entorno: X11 con XFCE.

Botones sin asignar

Disponibles para macros futuras: b:10, b:11, b:12...

Solución de problemas

Alt se queda "pegado" (no suelta):

xdotool keyup alt

Procesos del script acumulados/colgados:

pkill -f xbindkeys-alt-tab.sh

Verificar que el script se está lanzando al pulsar el botón:

cat /tmp/alt-tab.log

Confirmar que xbindkeys está corriendo:

pgrep -a xbindkeys

Averiguar el número de un botón:

xev

Pulsa el botón y anota el número que muestra (button N).