Português

Como transformar um dispositivo HID em controlador MIDI no Mac

Baixar o InputConfig na Mac App StoreEste app é totalmente gratuito. Você não precisa criar uma conta. Não há assinaturas nem downloads complicados, e nada fica bloqueado. Otimizado para Apple Silicon.

O InputConfig, um app grátis para Mac, lê dispositivos HID e envia MIDI a partir deles. Os botões tocam notas, enviam Program Changes ou iniciam e param um transporte. Os eixos, como um analógico, um acelerador, um volante ou um pedal, enviam um Control Change ou pitch bend que acompanha a posição. Os apps de música veem o resultado como uma entrada MIDI chamada InputConfig.

Eu faço o InputConfig. A lista de dispositivos que ele lê está abaixo, junto com os que ele não consegue ler.

Passos

  1. Conecte o dispositivo e abra o InputConfig.
  2. Adicione uma linha, use Escanear (Scan) e pressione o botão ou mova o eixo.
  3. Escolha uma saída MIDI para a linha: Note, CC, Pitch Bend (Pitch bend), Program Change ou Transport.
  4. Ative a entrada InputConfig no app de música e arme uma faixa.

Configure

  • Você: Conecte o dispositivo. No InputConfig, adicione uma linha, use Escanear (Scan) e pressione o botão ou mova o eixo. Depois escolha uma saída MIDI para a linha.
  • InputConfig: Dá nome ao controle e envia a mensagem pela própria porta MIDI sempre que o preset está ativo.
  • Confira: O indicador de MIDI do app de música pisca quando você pressiona o botão.

O Scan descobre o que o controle é, então você nunca precisa saber o número HID dele. Saída MIDI cobre todos os tipos de mensagem que uma linha pode enviar.

Linhas do InputConfig enviando notas MIDI 36 a 39 dos botões frontais e o MIDI CC 20 do gatilho esquerdo.
Figura 1. Linhas do InputConfig enviando notas MIDI 36 a 39 dos botões frontais e o MIDI CC 20 de um gatilho.
O preset HID to MIDI desenhado em um DualSense Edge no Live Visualizer do InputConfig, cada controle rotulado com a mensagem MIDI que envia.
Figura 2. O mesmo preset desenhado no controle. Cada rótulo é a nota ou o CC que aquele controle envia para o seu app de música.

Saiba quais dispositivos ele lê

  • Sem configuração. Controles de PlayStation, Xbox, Switch e MFi, que o macOS já conhece.
  • Como dispositivos HID brutos. A maioria dos controles USB genéricos, joysticks de voo, volantes de corrida e seus pedais, arcade sticks e controles sem alavanca no modo PC ou DirectInput, e controles 8BitDo nos modos X e D.
  • Interfaces de botão. Caixas de botões assistivos e dispositivos de sopro e sucção, no modo que envia botões de joystick.
  • Jog wheels, mouses 3D e decks. Desde a 1.8, o jog e o shuttle de um Contour ShuttlePRO e os seis eixos de um 3Dconnexion SpaceMouse são lidos, então empurrar um SpaceMouse pode controlar um Control Change. As teclas e os botões giratórios de um Stream Deck também são lidos, como recurso experimental.
  • Teclados e mouses. Qualquer tecla ou botão do mouse pode ser a entrada de uma linha. Uma tecla que envia MIDI ainda digita, então use teclas que não digitam nada, como F13 a F19.

Se o Live Visualizer (Visualizador ao vivo) mostra um controle se mexendo, esse controle pode enviar MIDI. Controles que o InputConfig lê tem a lista completa.

Combine o controle com a mensagem

Controle HIDMensagem MIDI que combina
Botão, gatilho de botão, botão de arcadeUma nota, mantida enquanto o botão é mantido
Eixo de analógico, acelerador, torção, volanteControl Change ou pitch bend que acompanha a posição
Pedal com curso, como um pedal de corridaControl Change, como o CC 11 para expressão
Pedal de botão ou botão assistivoUma nota, um Program Change, ou Start e Stop
Chapéu ou direcionalQuatro notas, ou transporte

Um acelerador que fica onde você o deixa é um fader melhor do que um analógico que volta com a mola. A lista de CC MIDI nomeia os números de controlador que os instrumentos esperam.

O editor do InputConfig mostrando linhas de controle que enviam MIDI: os botões frontais como notas, os analógicos como pitch bend e CC 1, um gatilho como CC 11.
Figura 3. Os botões tocam notas, o analógico esquerdo dobra o tom e o R2 envia expressão. Leia uma linha da esquerda para a direita para ver qual mensagem um controle envia.

Veja primeiro o que o Mac lê

  1. Abra o teste de joystick em um navegador, ou o Live Visualizer do InputConfig.
  2. Pressione cada botão e mova cada eixo.
  3. Anote quais aparecem. Esses são os que você pode associar.
  4. Se nada aparece, tente o outro modo do dispositivo: DInput, PC ou Switch.

Um controle que o Mac não vê é um controle que nenhum app consegue mapear.

Saiba o que não pode ser lido

  • Dispositivos só XInput. Controles de Xbox 360 com fio e muitos joysticks e volantes só XInput não podem ser lidos em um Mac. Mude o dispositivo para o modo DInput ou PC se ele tiver um.
  • Dispositivos que falam só com o próprio software. Os botões de DPI e de perfil de um mouse gamer são tratados dentro do mouse.
  • Force feedback. Não é acionado em volantes e joysticks de voo.

Quando um dispositivo tem uma chave de modo, a posição PC ou DInput é a que um Mac consegue ler.

Conheça as ferramentas HID para MIDI mais antigas

Duas ferramentas mais antigas para Mac faziam esse trabalho e ainda aparecem nas buscas. O código do MidiHID foi arquivado em 2017. A última versão do ControllerMate aceita no máximo o macOS Mojave. Conferi as duas em setembro de 2026. Nenhuma das duas ferramentas antigas é mantida para o macOS atual. Alternativa ao ControllerMate para Mac percorre o que ainda funciona.

A versão curta

  • Escaneie. Pressione o botão ou mova o eixo.
  • Envie. Escolha Note, CC, Pitch Bend, Program Change (Troca de programa) ou Transport.
  • Escute. Ative a entrada InputConfig no app de música.

Qualquer controle HID que o Mac consegue ver pode virar um controle MIDI.

Perguntas

O que significa HID para MIDI?

Transformar a entrada de um Human Interface Device, como um controle de jogo, joystick, pedal ou teclado, em mensagens MIDI que um app de música entende.

Existe um software grátis de HID para MIDI para Mac?

Sim. O InputConfig é grátis na Mac App Store. Ele lê controles de jogo e a maioria dos outros controles, joysticks e volantes HID, e envia notas, Control Change, pitch bend, Program Change e transporte.

Um volante de corrida ou seus pedais podem enviar MIDI?

Sim, se o Mac lê o volante. Os eixos dele agem como analógicos, então o volante e cada pedal podem enviar um Control Change que acompanha a posição.

O acelerador de um joystick de voo pode ser um fader MIDI?

Sim. Associe o eixo do acelerador a um Control Change. Ele fica onde você o deixa, o que serve para volume ou um filtro.

Um pedal USB pode enviar MIDI em um Mac?

Sim, quando ele chega ao Mac como um botão de joystick ou como uma tecla. Configure-o no software dele para enviar F13 a F19 ou um botão de joystick, para que um pressionamento não digite também uma letra.

O MidiHID ainda funciona?

O código dele foi arquivado em 2017, então não é mais mantido.

Mais em português

Páginas em português

Guias completos, em inglês

Quem escreve. Ryleigh Newman desenvolve o InputConfig e usa o próprio Mac todos os dias com um controle, porque as mãos não funcionam bem. Esta página foi traduzida do inglês. O InputConfig aparece em português quando o Mac está em português. Algumas páginas do site estão só em inglês.

Esta página em outros idiomas: English, Deutsch, 日本語

Baixar o InputConfig na Mac App StoreGrátis. macOS 14 ou posterior. Sem conta, nada sai do seu Mac. Código aberto no GitHub.