Solucionar el problema de los gestos del panel táctil que no funcionan en Wayland en Ubuntu 24.04

Al mover el puntero con normalidad, el desplazamiento con dos dedos puede seguir funcionando, pero el gesto habitual de deslizar con tres dedos ya no abre Actividades ni cambia de espacio de trabajo. En Ubuntu 24.04, este síntoma suele diagnosticarse erróneamente como «deshabilitación de los gestos de Wayland». En el escritorio GNOME estándar, no existe un interruptor principal independiente para los gestos integrados de tres dedos. La pregunta clave es dónde se detiene el gesto: en la sesión, en la configuración del panel táctil, en libinput, en GNOME Shell o en el propio hardware.

Esta guía comienza con comprobaciones rápidas y reversibles, para luego centrarse en el diagnóstico de la entrada de datos. Ubuntu 24.04 LTS utiliza GNOME en Wayland de forma predeterminada en los sistemas compatibles, y GNOME documenta gestos con tres dedos para abrir la vista general de Actividades y cambiar de espacio de trabajo. La pila libinput subyacente puede informar sobre eventos de deslizamiento y pellizco en paneles táctiles compatibles. Estos dos datos nos proporcionan una ruta de solución de problemas clara: confirmar Wayland, confirmar que el panel táctil esté activo, probar el gesto predeterminado de GNOME y, finalmente, verificar si libinput recibe eventos multifinger.

1. Confirma que realmente estás en una sesión de Wayland.

Abre la terminal y ejecuta:

echo $XDG_SESSION_TYPE

El resultado esperado es wayland. Si el comando imprime x11, está solucionando un problema con una ruta de entrada diferente. Ubuntu aún puede ofrecer una sesión de Xorg, y el comportamiento de los gestos allí no es idéntico a la experiencia nativa de GNOME Wayland.

Si usa Xorg y desea la sesión Wayland predeterminada, cierre la sesión. En la pantalla de inicio de sesión, seleccione su cuenta, abra el selector de sesión y elija Ubuntu en lugar de Ubuntu en Xorg cuando estas opciones estén disponibles. El hardware, los controladores gráficos, las sesiones de escritorio remoto o la política del administrador pueden afectar las sesiones que se ofrecen, así que no fuerce una opción que no está disponible sin verificar el motivo.

El comportamiento oficial de los gestos en GNOME está documentado en la Ayuda de GNOME: Usar gestos en paneles táctiles y pantallas táctiles .

2. Asegúrese de que el panel táctil esté habilitado.

Abre Ajustes > Ratón y panel táctil . Confirma que el panel táctil esté activado. Prueba también el desplazamiento con dos dedos y la pulsación básica. El panel de ajustes de GNOME solo muestra los controles del panel táctil cuando el escritorio lo reconoce, por lo que la ausencia de la sección Panel táctil es una pista importante, no un problema estético.

No pierdas tiempo buscando la opción de "gestos con tres dedos" en el panel de configuración de Ubuntu 24.04. Los gestos del sistema integrados de GNOME Shell no suelen controlarse con un interruptor específico en ese panel. Si el movimiento del puntero y el desplazamiento con dos dedos funcionan, pero los gestos con tres dedos no, pasa a la siguiente prueba.

Para obtener información sobre los controles del panel táctil, consulte la Ayuda de GNOME: Haga clic, arrastre o desplácese con el panel táctil .

3. Prueba un gesto estándar de GNOME, no un gesto específico de una aplicación.

Usa tres dedos y desliza el dedo hacia arriba en el panel táctil. GNOME debería abrir la vista general de Actividades. Si deslizas el dedo hacia arriba nuevamente, se abrirá la vista de aplicaciones. Si deslizas tres dedos hacia la izquierda o hacia la derecha, cambiarás de espacio de trabajo. Estas son las mejores pruebas de referencia porque son gestos de GNOME Shell, no funciones proporcionadas por Firefox, una extensión del navegador, un complemento de escritorio o un demonio de gestos de terceros.

El gesto de pellizcar para hacer zoom es diferente. libinput puede reconocer gestos de pellizco, pero si un pellizco amplía o no el contenido depende de la aplicación y del conjunto de herramientas. Un deslizamiento con tres dedos que funciona en el espacio de trabajo junto con un pellizco que no funciona en una aplicación generalmente indica que el problema está en la aplicación, no en Wayland en su conjunto.

4. Compruebe si libinput reconoce el panel táctil.

Ubuntu proporciona el libinput-toolspaquete para diagnósticos de entrada. Si el libinputcomando no está instalado, agréguelo con:

sudo apt update
sudo apt install libinput-tools

A continuación, enumere los dispositivos:

sudo libinput list-devices

Encuentra el bloque correspondiente a tu panel táctil. El nombre exacto del modelo, el nodo de evento, las dimensiones y la configuración varían según el portátil. Lo importante es que libinput lo identifique como un panel táctil y muestre las funcionalidades esperadas. El paquete para Ubuntu 24.04 está documentado en el catálogo de paquetes de Ubuntu Noble , y el comando en sí se describe en la página man de libinput de Ubuntu .

Si el panel táctil no aparece libinput list-devices, ya no se trata principalmente de un problema de gestos de GNOME. Compruebe si el dispositivo aparece en la configuración del firmware/BIOS, si la opción de activar el panel táctil de hardware está activada y si el kernel detecta el dispositivo tras reiniciar el sistema. Es necesario resolver problemas específicos del kernel, I2C-HID o firmware del portátil antes de que GNOME pueda recibir gestos.

5. Observa los eventos de gestos sin procesar

La prueba más informativa consiste en comprobar si libinput emite eventos de gestos mientras mueves tres dedos. Ejecuta:

sudo libinput debug-events

Luego, desliza tres dedos. En hardware compatible, verás líneas de eventos de gestos, como el inicio, las actualizaciones y el final del deslizamiento. El nodo de evento exacto, la sincronización, las diferencias y el formato pueden variar. El comando generalmente requiere acceso de superusuario (root) porque lee /dev/input/event*los dispositivos directamente.

La página man oficial de Ubuntu libinput-debug-events describe esta herramienta como una ayuda para la depuración y advierte que su formato de salida puede cambiar. La documentación de gestos de libinput explica cómo se generan los gestos de deslizamiento y pellizco.

Si aparecen eventos de gestos: el hardware y la ruta libinput funcionan correctamente. A continuación, concéntrese en GNOME Shell, las extensiones, el estado de la sesión y las actualizaciones. Si no aparecen eventos de gestos multitáctiles: vuelva a probar con los dedos claramente separados. Si aparecen eventos básicos del puntero, pero nunca gestos de tres dedos, es posible que el panel táctil carezca de la capacidad multitáctil necesaria, o que un problema del kernel o del firmware impida que registre suficientes contactos.

6. Instale las actualizaciones actuales de Ubuntu 24.04.

Antes de reemplazar los controladores o editar los archivos de configuración de bajo nivel, actualice los paquetes 24.04 instalados:

sudo apt update
sudo apt upgrade

Reinicia el sistema si la actualización instala un nuevo kernel, una nueva pila gráfica u otros componentes que requieran un reinicio. El manejo de gestos abarca varias capas (controladores de entrada del kernel, libinput, Mutter/GNOME Shell y aplicaciones), por lo que un error ya corregido puede seguir siendo visible en un equipo que no se haya actualizado.

Evite descargar paquetes Synaptics al azar o copiar fragmentos de configuración de Xorg antiguos de tutoriales escritos para versiones anteriores de Ubuntu. En la sesión estándar de Wayland GNOME, libinput es la biblioteca de entrada relevante, y los archivos de configuración exclusivos de Xorg no son una forma fiable de reparar los gestos de GNOME Shell.

7. Deshabilitar temporalmente las extensiones de GNOME Shell.

Si libinput debug-eventsse muestran claramente gestos con tres dedos pero GNOME no responde, desactive temporalmente las extensiones de terceros de GNOME Shell y vuelva a probar. Las extensiones pueden alterar el comportamiento del espacio de trabajo, la gestión de ventanas, el comportamiento de la vista general o el manejo de gestos. Use la aplicación Extensiones si la tiene instalada, o consulte las extensiones habilitadas con:

gnome-extensions list --enabled

Desactive las extensiones sospechosas una por una con:

gnome-extensions disable EXTENSION_UUID

Reemplazar EXTENSION_UUIDcon un identificador devuelto por el comando de lista. Cerrar sesión y volver a iniciarla después de cambiar las extensiones de Shell puede ayudar a garantizar que se está probando una sesión limpia.

Este paso es de diagnóstico, no una recomendación para usar la aplicación permanentemente sin extensiones. Una vez que identifique la extensión conflictiva, actualícela, ajuste su configuración o desactive únicamente esa extensión.

8. Vuelva a iniciar una sesión Wayland limpia y realice la prueba nuevamente.

Cierra sesión, elige la sesión normal de Ubuntu Wayland al iniciar sesión y repite las pruebas de gestos predeterminadas antes de volver a abrir muchas aplicaciones. Esto borra el estado transitorio de GNOME Shell y facilita determinar si intervino alguna extensión o proceso específico de la sesión.

Si el sistema siempre vuelve a Xorg incluso al seleccionar Ubuntu, investigue la causa en lugar de asumir que el problema está en el panel táctil. La compatibilidad del controlador gráfico, la configuración de acceso remoto o la política local pueden modificar la sesión disponible.

Por qué instalar Touchegg no suele ser la primera solución en Wayland.

Una sugerencia común es instalar un demonio de gestos de inmediato. Esto puede ser útil para acciones personalizadas en algunos entornos, pero no es la primera opción cuando los gestos integrados de GNOME fallan en una sesión de Wayland. GNOME Shell ya implementa sus propios gestos de sistema de tres dedos. Agregar otra capa de gestos antes de confirmar lo que detecta libinput puede dificultar el diagnóstico y generar conflictos con los gestos reservados del sistema.

Las directrices de interfaz humana de GNOME indican que los gestos de tres y cuatro dedos están reservados para el uso del sistema. Por ello, el comportamiento de los gestos a nivel de aplicación no es intercambiable con los gestos del espacio de trabajo del escritorio. Consulte las directrices de puntero y táctiles de GNOME .

Cómo verificar que el problema esté realmente solucionado

No se conforme con que “el cursor se mueva”. Una reparación exitosa debe superar varias comprobaciones independientes:

• echo $XDG_SESSION_TYPEdevoluciones wayland.
• La sección de panel táctil está presente en la configuración y el funcionamiento normal del panel táctil es el mismo.
• Deslizando tres dedos hacia arriba se abre la sección Actividades.
• Deslizar tres dedos hacia la izquierda o hacia la derecha permite cambiar de espacio de trabajo.
• sudo libinput debug-eventsmuestra los eventos de gestos multifinger correspondientes.
• Los gestos siguen funcionando después de cerrar la sesión o reiniciar el sistema.

Si la prueba de libinput se realiza correctamente, pero los gestos de GNOME siguen fallando después de las actualizaciones, las pruebas de extensiones y un nuevo inicio de sesión de Wayland, el problema se reduce a un fallo de la sesión de escritorio o del compositor. En ese caso, recopile la versión de Ubuntu, la versión del kernel uname -r, la versión de GNOME Shell gnome-shell --version, el modelo del panel táctil libinput list-devicesy una breve descripción del gesto predeterminado que falla. Esta información es mucho más útil para un informe de errores que reinstalar los controladores a ciegas.

Si libinput nunca detecta gestos con tres dedos, concéntrese en la capacidad del hardware, el firmware y la compatibilidad del kernel. Si solo fallan los gestos de pellizco o navegación de una aplicación, mientras que los gestos del espacio de trabajo de GNOME funcionan, solucione el problema de esa aplicación por separado. Esta distinción es clave para corregir los gestos del panel táctil en Ubuntu 24.04 sin convertir un pequeño problema de entrada en un problema mayor de configuración del sistema.