cursorpop

Dos pequeños efectos visuales para el cursor del mouse en Linux, inspirados en macOS:

• Al hacer click, el cursor se achica un instante y vuelve con un pequeño rebote.
• Al sacudir el mouse rápido de un lado a otro, el cursor crece temporalmente para que lo encuentres en pantalla.

Funciona en cualquier escritorio sobre X11: Cinnamon, GNOME, KDE, XFCE, MATE y otros.

v0.1.0 — Probado en Linux Mint Debian Edition (Cinnamon).

---

Instalación

Opción 1 — Paquete Debian (más fácil)

Descargá el archivo .deb desde la página de releases e instalalo con doble click, o desde la terminal:

sudo dpkg -i cursorpop_0.1.0_amd64.deb

Si faltara alguna dependencia, ejecutá después:

sudo apt install -f

Opción 2 — Compilar desde el código fuente

1. Instalá las dependencias:

# Debian / Ubuntu / Linux Mint / LMDE
sudo apt install build-essential libx11-dev libxfixes-dev libxi-dev libxext-dev \
                 python3-gi gir1.2-gtk-3.0 gir1.2-xapp-1.0

2. Compilá e instalá:

make
sudo make install

3. (Opcional) Para generar un paquete .deb vos mismo:

make deb
sudo dpkg -i cursorpop_0.1.0_amd64.deb

---

Primeros pasos

Después de instalar, abrí Configuración de Cursorpop desde el menú de tu escritorio (está en Preferencias o Accesorios).

Se abre una ventana donde podés:

• Activar o desactivar cada efecto por separado.
• Ajustar cuánto se achica el cursor al hacer click y cuánto crece al sacudir.
• Activar el inicio automático con la sesión gráfica — solo marcá el tilde "Iniciar con la sesión gráfica" y listo.

Al hacer click en Aplicar, los cambios se aplican de inmediato. Al cerrar la ventana, cursorpop queda corriendo en la bandeja del sistema (el ícono del mouse en la esquina del panel).

Bandeja del sistema

Desde el ícono de la bandeja podés:

• Activar o desactivar cursorpop con un solo click.
• Abrir la ventana de configuración.
• Cerrar la aplicación completamente.

---

Desinstalar

Si instalaste con el paquete .deb:

sudo apt remove cursorpop

Si instalaste con make install:

sudo make uninstall

---

Preguntas frecuentes

¿Funciona con Wayland? No. Wayland no permite este tipo de efecto global sobre el cursor. Funciona solo en sesiones X11.

¿El cursor se ve borroso al agrandarse? Con factores de escala muy grandes (más de 2×) puede verse algo borroso, ya que la imagen del cursor se escala por software. Con el valor por defecto (2×) se ve bien.

¿Necesita algún compositor especial? Necesita que haya un compositor activo para la transparencia del efecto. La mayoría de los escritorios modernos lo tienen por defecto (en Cinnamon, GNOME, KDE y XFCE ya viene activado).

La GUI no aparece en el menú después de instalar Probá cerrar sesión y volver a entrar, o ejecutar en la terminal:

update-desktop-database ~/.local/share/applications

---

Configuración avanzada (línea de comandos)

Para usuarios que prefieren no usar la GUI, el daemon acepta opciones al correr:

cursorpop --press-scale 0.75 --grow-scale 2.5 --no-wiggle

Y lee ~/.config/cursorpop/cursorpop.conf al iniciar. Ver la referencia completa de CLI y configuración.

---

Para desarrolladores

Documento	Contenido
docs/architecture.md	Cómo funciona internamente: X11, overlay, easing, detección de sacudida
docs/cli-reference.md	Todas las opciones CLI y el formato del archivo de config
docs/CONTRIBUTING.md	Cómo compilar, estructura del código, guía de estilo y cómo contribuir

---

Licencia

MIT — ver LICENSE.