Guia de Solução de Problemas no Linux
O Linux possui dois protocolos de servidor de display — Wayland e X11 — e cada um requer ferramentas diferentes para simular entrada de teclado. Este guia vai ajudá-lo a configurar tudo.
A maioria das distribuições modernas (Fedora 40+, Ubuntu 24.04+, GNOME 46+) usa Wayland por padrão. Configurações mais antigas ou com certos drivers NVIDIA ainda podem usar X11.
Como saber se estou no Wayland ou X11?
Verifique seu servidor de display
Abra um terminal e execute este comando:
Se a saída estiver vazia, você provavelmente está no X11. Alguns gerenciadores de display não definem essa variável.
Configuração do Wayland
Para Fedora, Ubuntu, Arch e outras distros modernas
O Wayland precisa do ydotool — um emulador de entrada independente do servidor de display que se comunica diretamente com o kernel. Ele requer um daemon em segundo plano e permissão para escrever em /dev/uinput.
Fedora / Fedora Atomic
Instale o ydotool
Para Fedora padrão:
Em variantes Fedora Atomic (Silverblue, Kinoite, Universal Blue), use rpm-ostree install ydotool && systemctl reboot.
Habilite o daemon
Adicione seu usuário ao grupo input
Você precisa fazer logout e login (ou reiniciar) para a mudança de grupo ter efeito.
Verifique se funciona
Ubuntu / Debian
Instale o ydotool
Habilite o daemon
Adicione seu usuário ao grupo input
Verifique se funciona
Arch Linux
Instale o ydotool
Habilite o daemon
Adicione seu usuário ao grupo input
Verifique se funciona
Configuração do X11
Para distribuições mais antigas ou tradicionaisO X11 usa o xdotool, que é mais simples — não precisa de daemon e geralmente funciona imediatamente após a instalação.
Instale o xdotool
Pronto
O xdotool funciona imediatamente após a instalação. Nenhum daemon ou mudança de grupo necessária.
Digitação de texto no Wayland
Se você usa a ação Digitar Texto no Wayland, o MIDI Mapper precisa do wtype para digitar caracteres.
O wtype é necessário apenas para digitar strings de texto. A simulação de atalhos de teclado usa o ydotool.
Problemas Comuns
"ydotool: command not found"
O ydotool não está instalado. Siga os passos de configuração do Wayland acima para sua distribuição.
"As teclas são enviadas mas nada acontece"
O daemon ydotoold provavelmente não está em execução. Verifique o status e reinicie:
"Permission denied" ou "Failed to open /dev/uinput"
Seu usuário não está no grupo input. Adicione-se e faça logout/login:
Lembre-se de fazer logout e login após executar este comando.
"Os atalhos de teclado não são capturados no app"
O compositor do seu desktop (GNOME, KDE, Cosmic) pode interceptar certos atalhos antes que cheguem ao app. Verifique as configurações de atalhos de teclado do sistema e desative os conflitantes, ou digite a combinação de teclas manualmente no campo de texto do MIDI Mapper em vez de usar o botão de captura.
"O SELinux bloqueia o ydotool" (Fedora)
No Fedora, o SELinux pode bloquear o ydotool de acessar /dev/uinput. Verifique se há negações:
Se aparecerem negações, crie uma exceção local na política do SELinux. Este é um passo avançado — consulte a documentação de SELinux do Fedora para detalhes.
Tudo pronto!
Seu sistema Linux está configurado para atalhos de teclado e digitação de texto com o MIDI Mapper.