Configurar Logitech MX Master en Ubuntu: botones, gestos y rueda

Actualización de agosto de 2026: publiqué la primera versión de esta guía en 2018, después de comprar un MX Master 2S y configurarlo en Ubuntu 17.10 con xbindkeys y xautomation. Aquello funcionaba bajo X11, pero hoy ya no es la mejor solución. He reescrito el artículo para los Logitech MX Master 2S, 3, 3S y 4, Ubuntu 24.04/26.04 y sesiones X11 o Wayland.

El ratón funciona nada más conectarlo: movimiento, clics y rueda básica dependen del soporte HID del kernel. Lo que Linux no recibe de Logitech es Logi Options+. El propio fabricante confirma que esa aplicación solo está disponible para Windows y macOS, aunque las funciones básicas del ratón sí son compatibles con Linux. Para configurar Logitech MX Master en Ubuntu sin renunciar a los botones laterales, SmartShift o la rueda del pulgar, la alternativa más completa es Solaar.

Qué modelos y conexiones cubre esta guía

Solaar gestiona dispositivos Logitech que hablan HID++ mediante receptores Unifying, Logi Bolt, algunos receptores Nano, cable USB o Bluetooth. El MX Master 2S figura expresamente entre los dispositivos HID++ 2.0 compatibles. Los modelos nuevos se detectan por las capacidades que anuncian, por eso la lista histórica de la documentación no debe interpretarse como una lista cerrada.

• MX Master 2S: receptor Unifying o Bluetooth.
• MX Master 3: receptor suministrado con esa variante o Bluetooth.
• MX Master 3S: normalmente Logi Bolt o Bluetooth.
• MX Master 4: Logi Bolt o Bluetooth. Solaar añadió soporte para el modelo normal en la rama 1.1.17 y las versiones posteriores.

Un receptor Unifying y uno Bolt no son intercambiables. Antes de emparejar, comprueba el logotipo del receptor y el de la base del ratón. Si solo quieres usar Bluetooth, el emparejamiento se hace desde Configuración → Bluetooth de Ubuntu y Solaar se encarga después de las funciones HID++ que exponga el dispositivo.

Instalar Solaar en Ubuntu

En Ubuntu 24.04 y 26.04 el paquete está en el repositorio universe:

sudo apt update
sudo apt install solaar

Después, despierta el ratón moviéndolo o pulsando un botón y ejecuta:

solaar show

El comando debe mostrar el receptor o la conexión Bluetooth, el nombre del ratón, su versión HID++, batería y controles reprogramables. Para conocer la versión instalada:

solaar --version

Hay una diferencia importante para el MX Master 4. El repositorio de Ubuntu 24.04 conserva Solaar 1.1.11, anterior a ese ratón; Ubuntu 26.04 incluye 1.1.19. Si usas 24.04 con un MX Master 4 y faltan opciones, no es un fallo del ratón: instala una versión reciente siguiendo la documentación oficial de Solaar. No recomiendo descargar scripts de terceros ni ejecutar Solaar como root para esquivar los permisos.

En GNOME puede que la ventana funcione pero no aparezca el icono del área de estado. En ese caso instala el soporte AppIndicator:

sudo apt install gnome-shell-extension-appindicator

Cierra y vuelve a abrir la sesión para que GNOME cargue la extensión.

Ajustar rueda, DPI y SmartShift

Abre Solaar y selecciona el ratón en la columna izquierda. Las opciones exactas cambian según el modelo y el firmware; Solaar solo enseña capacidades que el dispositivo declara. En un MX Master pueden aparecer:

• Sensibilidad o DPI: ajusta cuánto se desplaza el puntero. Empieza alrededor de 1000-1600 DPI y corrige desde ahí.
• SmartShift: define cuándo la rueda pasa del giro con pasos al giro libre.
• Desplazamiento de alta resolución: mejora la suavidad, aunque algunas aplicaciones interpretan de manera distinta los eventos de rueda.
• Dirección de la rueda: permite invertir el desplazamiento sin cambiar todo el sistema.
• Rueda del pulgar: puede conservar el desplazamiento horizontal o desviarse para ejecutar reglas.
• Key/Button Diversion: entrega a Solaar los botones reprogramables para que sus reglas decidan qué hacer.

No copies a ciegas el nombre de dispositivo de otra guía. MX Master 3S, Wireless Mouse MX Master 3 y otros nombres dependen de la conexión y el firmware. Usa siempre el nombre que devuelve tu propio solaar show.

Configurar los botones y gestos del MX Master

La configuración moderna ya no necesita averiguar números de botón con xev ni mantener un .xbindkeysrc. En Solaar:

1. Selecciona el ratón y busca Key/Button Diversion.
2. Cambia únicamente el botón que quieras personalizar a Diverted o Mouse Gestures.
3. Abre Rule Editor.
4. Añade una condición para ese dispositivo y botón.
5. Añade una acción KeyPress, MouseScroll, Set o Execute.

Estas son asignaciones sensatas para empezar:

Conviene empezar con una sola regla y probarla antes de añadir la siguiente. Deja el clic izquierdo y derecho sin desviar y evita acciones que mantengan modificadores pulsados: una regla incompleta puede dejar Ctrl, Alt o Super aparentemente atascados.

Qué cambia entre X11 y Wayland

Esta es la diferencia que más rompe tutoriales antiguos. Solaar funciona en Wayland, pero su documentación advierte de que algunas condiciones por proceso y ciertas simulaciones de teclado no tienen la misma cobertura que bajo X11. En GNOME Wayland, la extensión de GNOME para Solaar recupera parte de la información sobre la aplicación activa.

Comprueba tu tipo de sesión con:

echo "$XDG_SESSION_TYPE"

Si una regla sencilla funciona y otra que depende de la aplicación activa no, no cambies permisos al azar: prueba primero una regla sin condición de proceso. Para simular teclas y clics, Solaar utiliza /dev/uinput. El paquete de Ubuntu instala las reglas necesarias; las instalaciones manuales deben incorporar la regla udev oficial. Dar permisos globales con chmod 666 /dev/uinput no es una solución aceptable.

Problemas habituales

El ratón mueve el puntero, pero Solaar no lo muestra

Despierta el ratón, comprueba que no está conectado a otro canal Easy-Switch y repite solaar show. Si es un MX Master 4 sobre Ubuntu 24.04, revisa primero la versión de Solaar. También puedes comprobar que el kernel ha cargado sus módulos Logitech:

lsmod | grep -E 'hid_logitech_(dj|hidpp)'

Solaar lo detecta, pero no deja cambiar opciones

Suele ser un problema de permisos udev o una versión antigua. Cierra Solaar, desconecta y vuelve a conectar el receptor y abre la aplicación como usuario normal. Si la instalación procede de PyPI o Git, sigue el apartado de reglas udev de su documentación.

El MX Master 4 for Business no muestra Button Diversion

En agosto de 2026 existe una incidencia abierta para la variante Business B048: el dispositivo y sus capacidades aparecen, pero la interfaz puede omitir la sección de desvío de botones. No confundas ese caso con el MX Master 4 normal. Comprueba el identificador que enseña solaar show y revisa la incidencia de compatibilidad antes de modificar el sistema.

La rueda va demasiado rápida o demasiado lenta

Prueba primero a cambiar el desplazamiento de alta resolución y el umbral de SmartShift, una opción cada vez. La aceleración del puntero pertenece al escritorio; el comportamiento físico de la rueda y el DPI pertenecen al ratón. Tocar ambos a la vez hace imposible saber qué ajuste ha corregido el problema.

¿Sigue mereciendo la pena el método antiguo con xbindkeys?

Solo como último recurso en una sesión X11 y para botones que ya llegan como eventos normales. El método de 2018 dependía de números como b:8 y b:9, ejecutaba xte y no conocía Bolt, HID++ moderno ni Wayland. Solaar entiende el dispositivo, persiste sus ajustes y permite crear gestos sin convertir el ratón en una colección de números mágicos.

Una vez configurados los controles, el artículo complementario explica cómo comprobar la batería de un teclado o ratón Logitech en Ubuntu desde la interfaz, la terminal y UPower.

Fuentes y compatibilidad comprobada

• Logitech: Logi Options+ solo admite Windows y macOS.
• Logitech: compatibilidad básica de MX Master 4 con Linux.
• Solaar: receptores, conexiones y dispositivos compatibles.
• Solaar: reglas, botones, gestos y limitaciones de Wayland.
• Ubuntu: versiones publicadas del paquete Solaar.

Preguntas frecuentes