Guía de solución de problemas en Linux
Linux tiene dos protocolos de servidor gráfico — Wayland y X11 — y cada uno necesita herramientas distintas para simular la entrada de teclado. Esta guía te ayudará a que todo funcione.
La mayoría de las distribuciones modernas (Fedora 40+, Ubuntu 24.04+, GNOME 46+) usan Wayland por defecto. Las instalaciones más antiguas o las que usan ciertos controladores de NVIDIA pueden seguir en X11.
¿Cómo sé si estoy en Wayland o en X11?
Comprueba tu servidor gráfico
Abre una terminal y ejecuta este comando:
Si la salida está vacía, probablemente estás en X11. Algunos gestores de sesión no definen esta variable.
Configuración de Wayland
Para Fedora, Ubuntu, Arch y otras distros modernas
Wayland necesita ydotool — un emulador de entrada independiente del servidor gráfico que se comunica directamente con el kernel. Requiere un daemon en segundo plano y permiso para escribir en /dev/uinput.
Fedora / Fedora Atomic
Instala ydotool
Para Fedora estándar:
En las variantes de Fedora Atomic (Silverblue, Kinoite, Universal Blue), usa rpm-ostree install ydotool && systemctl reboot en su lugar.
Activa el daemon
Inicia ydotoold ahora y configúralo para que arranque en cada inicio:
Añade tu usuario al grupo input
Dale a tu usuario permiso para usar el dispositivo de entrada virtual:
Debes cerrar sesión y volver a iniciarla (o reiniciar) para que el cambio de grupo surta efecto.
Comprueba que funciona
Comprueba que ydotool puede simular pulsaciones de teclas:
Ubuntu / Debian
Instala ydotool
Activa el daemon, añádete al grupo input y comprueba que funciona
Los mismos pasos que en Fedora, más arriba:
Arch Linux
Instala ydotool
Activa el daemon, añádete al grupo input y comprueba que funciona
Los mismos pasos que en Fedora, más arriba:
Configuración de X11
Para distribuciones más antiguas o tradicionalesX11 usa xdotool, que es más sencillo — no necesita daemon y normalmente funciona sin más configuración.
Instala xdotool
Elige el comando para tu distribución:
Eso es todo
xdotool funciona nada más instalarlo. No necesita daemon ni cambios de grupo.
Entrada de texto en Wayland
Si usas la acción Escribir texto en Wayland, MIDI Mapper necesita wtype para escribir caracteres.
wtype solo se necesita para escribir textos. La simulación de atajos de teclado usa ydotool.
Problemas comunes
"ydotool: command not found"
ydotool no está instalado. Sigue los pasos de configuración de Wayland de más arriba para tu distribución.
Las teclas se envían pero no pasa nada
Probablemente el daemon ydotoold no se está ejecutando. Comprueba su estado y reinícialo:
"Permission denied" o "Failed to open /dev/uinput"
Tu usuario no está en el grupo input. Añádete y cierra sesión / vuelve a entrar:
Recuerda cerrar sesión y volver a entrar después de ejecutar este comando.
Los atajos de teclado no se capturan en la app
El compositor de tu escritorio (GNOME, KDE, Cosmic) puede interceptar ciertos atajos antes de que lleguen a la app. Revisa los ajustes de atajos de teclado de tu sistema y desactiva los que entren en conflicto, o escribe la combinación de teclas a mano en el campo de texto de MIDI Mapper en lugar de usar el botón de captura.
SELinux bloquea ydotool (Fedora)
En Fedora, SELinux puede impedir que ydotool acceda a /dev/uinput. Busca denegaciones:
Si aparecen denegaciones, crea una excepción local en la política de SELinux. Es un paso avanzado — consulta la documentación de SELinux de Fedora para más detalles.
¡Todo listo!
Tu sistema Linux está configurado para los atajos de teclado y la entrada de texto de MIDI Mapper.