Português

Controle de jogo para OSC em um 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.

Você pode enviar OSC de um controle de jogo em um Mac hoje, por uma ponte. O InputConfig ainda não fala OSC sozinho, mas já envia MIDI, e o app-ponte grátis Chataigne transforma esse MIDI em OSC para qualquer coisa que escute: Resolume, TouchDesigner, QLab, Max, consoles Eos e mais.

Alguém no Reddit pediu OSC nativo, de saída e de entrada, e isso foi direto para a minha lista. Você não precisa esperar por ele. Este guia é como eu montaria isso hoje, em cerca de quinze minutos, mais uma olhada nas outras opções.

A versão 1.7 do InputConfig, prevista para outubro de 2026, estará totalmente disponível em português.

Passos

  1. Conecte o controle, abra o InputConfig e ative um preset que envie MIDI (os presets Lighting Desk ou Gamepad Synth funcionam os dois).
  2. Instale o Chataigne, que é grátis e roda nativamente em Apple silicon.
  3. No Chataigne, adicione um módulo MIDI e escolha o InputConfig como dispositivo de entrada.
  4. Adicione um módulo OSC e defina o alvo como o app que você quer controlar: 127.0.0.1 se ele estiver no mesmo Mac, mais a porta que esse app escuta.
  5. Crie um mapeamento de cada controle MIDI para um endereço OSC, e reduza de 0 a 127 para 0 a 1 se o app receptor esperar isso.
  6. Mova o controle e veja os valores chegarem ao app receptor.

Por que há uma ponte, por enquanto

OSC roda pela rede, e o InputConfig não faz nenhuma conexão de rede. Eu me importo com isso, e é uma promessa da política de privacidade do app. Então, quando o OSC nativo chegar, será algo que você liga por conta própria, apontado para o endereço que você escolher, e desligado nos outros casos.

O MIDI, por outro lado, fica inteiramente no seu Mac. O InputConfig entrega o MIDI à ponte, e a ponte faz a parte de rede.

Pule o OSCulator em configurações novas

Por anos o OSCulator foi a resposta para essa pergunta exata, e muitos posts antigos de fórum ainda o recomendam. Ele encerrou as atividades no fim de 2024. A última versão é só para Intel, o que significa que depende do Rosetta, e a Apple disse que o macOS 27 é a última versão a suportar totalmente apps Intel. O Chataigne é a substituição mais próxima que encontrei.

Envie OSC pelo Chataigne

O Chataigne é grátis, de código aberto, e roda nativamente em Apple silicon. Ele recebe MIDI e envia OSC, e também pode enviar DMX, Art-Net e sACN se você acabar fazendo iluminação.

Passo 1: envie MIDI do InputConfig

  • Você: Ative um preset que envie MIDI. O preset Lighting Desk coloca faders nos gatilhos e notas nos botões. O preset Gamepad Synth cobre os analógicos também.
  • InputConfig: Envia os movimentos do controle na porta MIDI dele, com o nome InputConfig.
  • Confira: O preset aparece como rodando no InputConfig.

Passo 2: leia no Chataigne

  • Você: No Chataigne, adicione um módulo MIDI e escolha o InputConfig como dispositivo.
  • Chataigne: Lista cada valor que chega pela porta.
  • Confira: Mova um gatilho e o valor dele muda no módulo.

Passo 3: aponte o OSC para o alvo

  • Você: Adicione um módulo OSC e defina o alvo: 127.0.0.1 quando o app receptor estiver no mesmo Mac, ou o endereço IP do outro computador se ele estiver na sua rede, mais a porta que esse app escuta.
  • Chataigne: Envia mensagens OSC para esse endereço e porta.
  • Confira: A porta é a mesma que o app receptor escuta.

Passo 4: mapeie cada controle

  • Você: Crie um mapeamento com o valor MIDI como entrada e uma mensagem OSC como saída. A maioria dos apps quer de 0 a 1 em vez de 0 a 127, e o Chataigne pode remapear isso no mapeamento.
  • Chataigne: Converte cada movimento MIDI em uma mensagem OSC.
  • Confira: Mova o controle e veja o valor chegar ao app receptor. Um bom primeiro teste é um gatilho para um fader.

Alvo OSC no mesmo Mac: Digite isto como o host do módulo OSC.

127.0.0.1

O que acontece: O Chataigne envia para um app rodando neste Mac. Acrescente a porta desse app ao lado.

Editor do InputConfig mostrando quatro linhas: o analógico esquerdo enviando CC 1 e CC 2, Cross enviando a nota 60 e R2 enviando CC 3.
Figure 1. A metade do InputConfig na ponte: dois eixos do analógico como CC 1 e CC 2, uma nota em Cross e CC 3 em R2. O Chataigne os transforma em OSC.
O preset Controller to MIDI for OSC desenhado em um DualSense Edge no Live Visualizer do InputConfig.
Figure 2. As mesmas quatro linhas no controle. Mova o analógico e o rótulo CC dele acende, o que mostra que o MIDI está saindo antes de você olhar para a ponte.

Encontre os endereços OSC

Cada app dá nomes diferentes aos seus controles, então confira a documentação dele para os endereços que escuta. Resolume, QLab e a família Eos da ETC documentam os comandos OSC, e o OSC In CHOP do TouchDesigner aceita o que você enviar. Para luzes você talvez nem precise de OSC: o QLC+ e o Lightkey leem MIDI diretamente.

Se nada chega

Suba esta escada, começando pelo erro mais comum:

  1. Confira a porta. O app receptor precisa escutar a mesma porta para a qual a ponte envia. É o erro que eu mais cometo.
  2. Permita a Local Network. No macOS 15 e posteriores, os apps precisam de permissão para alcançar outros aparelhos na sua rede local. Se o OSC não aparece em outro computador, permita o app-ponte em Ajustes do Sistema, Privacidade e Segurança, Local Network. O próprio InputConfig não precisa dessa permissão, já que o MIDI nunca sai do seu Mac.
  3. Confira a escala. Se um valor chega mas quase não se move, o app receptor provavelmente espera de 0 a 1. Remapeie-o no Chataigne.

Escolha CC ou pitch bend para suavidade

  • CC MIDI. 128 passos, de sobra para opacidade, volume ou quantidades de efeito.
  • Pitch bend. 16.384 passos, para algo que precisa ser realmente suave. O preset Gamepad Synth já o coloca no analógico direito. Mapeie-o para o seu controle mais sensível.

O MIDI fica dentro do seu Mac, então a ponte acrescenta muito pouco atraso. O Bluetooth costuma ser o elo mais lento da corrente, e um cabo ajuda em shows. Coloque o pitch bend no controle que precisa se mover suavemente.

Outras opções, com honestidade

Se tudo o que você precisa é de um controle enviando OSC e nada mais, há boas ferramentas que leem controles de jogo diretamente: o TouchOSC faz isso, e o Chataigne sozinho também. O InputConfig faz sentido quando você quer o mesmo controle fazendo mais do que isso: teclas, o mouse e MIDI para o seu DAW, tudo a partir de um único preset que acompanha você de app em app.

Como seria o OSC nativo

O plano para o qual estou me inclinando:

  • OSC de saída. A partir de qualquer botão, analógico ou gatilho.
  • OSC de entrada. Para que outro app possa apertar botões no InputConfig.
  • Desligado por padrão. Tudo desligado até você ligar e dar um endereço.

Se isso ajudaria você, me avise. Ouvir de pessoas que usariam é o que faz as coisas subirem na lista.

Resumo

  • O InputConfig envia MIDI. Ainda não envia OSC.
  • O Chataigne faz a ponte. Configure um módulo MIDI de entrada e um módulo OSC de saída, com um mapeamento por controle.
  • Confira a porta primeiro. Depois confira a Local Network no macOS 15 e posteriores.

MIDI entra, OSC sai: a ponte faz a parte de rede para que o InputConfig nunca precise fazê-la.

Perguntas

O InputConfig envia OSC diretamente?

Ainda não. Ele envia MIDI, e uma ponte como o Chataigne transforma isso em OSC. OSC nativo nos dois sentidos está na minha lista.

O que aconteceu com o OSCulator?

Ele encerrou as atividades no fim de 2024. A última versão é só para Intel e depende do Rosetta, então o Chataigne é o que eu usaria agora.

Isso vai funcionar com um console de luz OSC?

Qualquer coisa que aceite OSC funciona, incluindo a família Eos. Para luzes, porém, você talvez nem precise de OSC. O QLC+ e o Lightkey leem MIDI diretamente.

Há muito atraso?

O MIDI fica dentro do seu Mac, então a ponte acrescenta muito pouco. O Bluetooth costuma ser o elo mais lento da corrente, e um cabo ajuda em shows.

Mais 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. Os principais botões e menus do app aparecem em português quando o Mac está em português; esta página os chama assim, com o nome em inglês entre parênteses. O restante do app e do site está em inglês.

Esta página em outros idiomas: English, Dansk, Deutsch, Español, Français, עברית, Italiano, 日本語, Norsk, Polski, Русский, Svenska, ไทย, Українська, Tiếng Việt

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