Manual
Everything MidiPanel does, step by step.
1. Install
- Download the .dmg from the download page.
- Open it and drag MidiPanel to Applications.
- Open MidiPanel. Its icon appears in the menu bar, and it keeps running when you close the window.
- Connect your controller with a USB cable. MidiPanel recognizes it and draws it on screen.
2. Permissions
macOS asks you to allow each permission once. MidiPanel asks only for the ones your actions need.
| Permission | What it's for | Where |
|---|---|---|
| Accessibility | Keyboard shortcuts, window positions, meeting buttons. | System Settings → Privacy & Security → Accessibility → turn on MidiPanel |
| Automation | Control Spotify, Music, Chrome, Zoom and System Events. macOS asks once per app, the first time an action uses it. | Click OK in the dialog. To change later: Privacy & Security → Automation |
| Chrome setting | Volume and seek of videos in Chrome (YouTube). | In Chrome: View → Developer → Allow JavaScript from Apple Events |
| Audio recording (optional) | Only for the level meter next to the fader. MidiPanel reads the sound level; it never records or sends audio. | Privacy & Security → Screen & System Audio Recording |
If an action does nothing, MidiPanel shows a message on screen with the missing permission.
3. Map a control
- Click the control on the screen, or turn on Set up from the controller and press the real control.
- Pick an action in the pop-up and adjust its options.
- Click Save. Press the real control to test it.
Mapped controls show a green dot. To remove a mapping, open it and click Remove (you can undo it).
Each controller keeps its own mappings, so the same button can do different things on two controllers.
4. Actions
Buttons
- Open app — opens or brings forward any installed app.
- Media — play/pause, next, previous; skip forward or back (tap once or hold) in Spotify, Music or a video in Chrome.
- Meeting — microphone, camera, raise hand, leave. Works in Google Meet (Chrome), Zoom and Microsoft Teams. To leave a call, hold the button for 1 second.
- Key combination — press any shortcut, such as ⌘⇧4. Record it by pressing the keys, or pick a ready-made macOS shortcut. With Toggle, each press alternates between two combinations.
- Run a Shortcut — runs a shortcut from the macOS Shortcuts app by name.
- Volume and Brightness — one step up or down per press. Brightness works on the Mac screen and on external monitors that support DDC/CI.
- Window — moves the front window to a half, a quarter, the center, or full screen.
- Keyboard cleaning mode — turns the keyboard off so you can wipe it. Press again to turn it back on; it turns on by itself after 90 seconds.
- Time display and Focus timer (X-Touch One) — change what the time display shows, or start a countdown.
Faders and knobs
- Volume — of what's playing (recommended: follows Spotify, Music or a video in Chrome, and works with any audio interface) or of the system.
- Brightness — turn or slide to brighten or dim; choose the Mac screen, the external monitor or both.
- Skip forward/back (knob or jog wheel) — about 1 second per step in the song or video.
5. Feedback on the controller
Open Feedback at the top of the window to turn each item on or off:
- Button lights — light while pressed; the play/pause button glows while playing and blinks when paused.
- Display — scrolls the song title. Choose the scroll speed.
- Time display (X-Touch One) — clock, song time or focus timer.
- Level meter — the LEDs next to the fader follow the sound level (needs the audio recording permission).
A motorized fader follows the volume of what's playing, so it moves by itself when you change the volume on the Mac.
6. Trial and license
- The trial lasts 7 days per Mac, with every feature.
- After you buy, open License → Enter key and paste the key from the e-mail.
- One license works on up to 3 Macs. To free a slot, open License → Deactivate this Mac.
- MidiPanel checks the license about every 14 days and works for 30 days offline.
7. Troubleshooting
The controller doesn't respond
Unplug the USB cable, wait 5 seconds and plug it back in. MidiPanel finds the controller again by itself. This happens after a restart or wake from sleep. With a USB hub, try a direct connection; check the power adapter if your controller has one.
A button does two things at once
Another app is listening to the same controller (a DAW, another MIDI tool or an old script). Quit it or turn the controller off in its settings.
An action does nothing
Read the message on screen: it names the missing permission. Check Permissions. For video in Chrome, check the Chrome setting.
The motorized fader jumps back
On the X-Touch One, keep the SELECT button lit — it keeps the fader active. MidiPanel locks this button for you.
Still stuck?
Write to support@midipanel.com with your controller model and macOS version.
8. Uninstall
- Quit MidiPanel from the menu bar icon (Quit).
- Drag MidiPanel from Applications to the Trash.
- Optional: delete your mappings in
~/Library/Application Support/MidiPanel.
Manual
Tudo o que o MidiPanel faz, passo a passo.
1. Instalar
- Baixe o .dmg na página de download.
- Abra o arquivo e arraste o MidiPanel para Aplicativos.
- Abra o MidiPanel. O ícone aparece na barra de menus, e ele continua rodando quando você fecha a janela.
- Ligue o controlador pelo cabo USB. O MidiPanel reconhece o aparelho e desenha na tela.
2. Permissões
O macOS pede cada permissão uma vez. O MidiPanel pede só as que as suas ações usam.
| Permissão | Para que serve | Onde |
|---|---|---|
| Acessibilidade | Atalhos de teclado, posição das janelas, botões de reunião. | Ajustes do Sistema → Privacidade e Segurança → Acessibilidade → ligue o MidiPanel |
| Automação | Controlar Spotify, Música, Chrome, Zoom e System Events. O macOS pergunta uma vez por app, na 1ª vez que uma ação usa esse app. | Clique em OK no aviso. Para mudar depois: Privacidade e Segurança → Automação |
| Opção do Chrome | Volume e avanço de vídeos no Chrome (YouTube). | No Chrome: Visualizar → Desenvolvedor → Permitir JavaScript de Apple Events |
| Gravação de áudio (opcional) | Só para o medidor de nível ao lado do fader. O MidiPanel lê o nível do som; ele nunca grava nem envia áudio. | Privacidade e Segurança → Gravação de Tela e Áudio do Sistema |
Se uma ação não faz nada, o MidiPanel mostra na tela qual permissão falta.
3. Mapear um controle
- Clique no controle na tela, ou ligue Aprender pela controladora e aperte o controle real.
- Escolha uma ação no pop-up e ajuste as opções.
- Clique em Salvar. Aperte o controle real para testar.
Controles mapeados mostram um ponto verde. Para remover um mapeamento, abra o controle e clique em Remover (dá para desfazer).
Cada controlador guarda os próprios mapeamentos, então o mesmo botão pode fazer coisas diferentes em dois controladores.
4. Ações
Botões
- Abrir app — abre ou traz para frente qualquer app instalado.
- Mídia — play/pause, próxima, anterior; avançar ou voltar (um toque ou segurando) no Spotify, na Música ou num vídeo no Chrome.
- Reunião — microfone, câmera, levantar a mão, sair. Funciona no Google Meet (Chrome), no Zoom e no Microsoft Teams. Para sair da chamada, segure o botão por 1 segundo.
- Combinação de teclas — aperta qualquer atalho, como ⌘⇧4. Grave apertando as teclas ou escolha um atalho pronto do macOS. Com Alternar, cada toque troca entre duas combinações.
- Rodar Atalho do Mac — roda um atalho do app Atalhos pelo nome.
- Volume e Brilho — um passo para cima ou para baixo por toque. O brilho funciona na tela do Mac e em monitores externos com DDC/CI.
- Janela — move a janela da frente para uma metade, um quarto, o centro ou a tela toda.
- Modo Limpeza do teclado — desliga o teclado para você limpar. Aperte de novo para religar; ele religa sozinho depois de 90 segundos.
- Display de tempo e Timer de foco (X-Touch One) — trocam o que o display de tempo mostra ou começam uma contagem.
Faders e knobs
- Volume — do que está tocando (recomendado: segue Spotify, Música ou vídeo no Chrome, e funciona com qualquer interface de áudio) ou do sistema.
- Brilho — gire ou deslize para clarear ou escurecer; escolha a tela do Mac, o monitor externo ou as duas.
- Avançar/voltar (knob ou jog) — cerca de 1 segundo por passo na música ou no vídeo.
5. Feedback no controlador
Abra Feedback no topo da janela para ligar ou desligar cada item:
- Luzes dos botões — acendem enquanto você aperta; o botão de play/pause fica aceso tocando e pisca em pausa.
- Display — rola o nome da música. Escolha a velocidade.
- Display de tempo (X-Touch One) — relógio, tempo da música ou timer de foco.
- Medidor de nível — os LEDs ao lado do fader seguem o nível do som (precisa da permissão de gravação de áudio).
O fader motorizado segue o volume do que está tocando, então ele se mexe sozinho quando você muda o volume no Mac.
6. Teste e licença
- O teste dura 7 dias por Mac, com todos os recursos.
- Depois da compra, abra Licença → Inserir chave e cole a chave do e-mail.
- Uma licença funciona em até 3 Macs. Para liberar uma vaga, abra Licença → Desativar este Mac.
- O MidiPanel confere a licença mais ou menos a cada 14 dias e funciona 30 dias sem internet.
7. Solução de problemas
O controlador não responde
Desconecte o cabo USB, espere 5 segundos e conecte de novo. O MidiPanel encontra o controlador sozinho. Isso acontece depois de reiniciar o Mac ou acordar do repouso. Com hub USB, teste ligar direto no Mac; confira a fonte se o controlador tiver uma.
Um botão faz duas coisas ao mesmo tempo
Outro programa escuta o mesmo controlador (uma DAW, outra ferramenta MIDI ou um script antigo). Feche o programa ou desligue o controlador nas configurações dele.
Uma ação não faz nada
Leia o aviso na tela: ele diz qual permissão falta. Confira as Permissões. Para vídeo no Chrome, confira a opção do Chrome.
O fader motorizado volta sozinho
Na X-Touch One, mantenha o botão SELECT aceso — ele mantém o fader ativo. O MidiPanel trava esse botão para você.
Ainda não resolveu?
Escreva para support@midipanel.com com o modelo do controlador e a versão do macOS.
8. Desinstalar
- Feche o MidiPanel pelo ícone da barra de menus (Sair).
- Arraste o MidiPanel de Aplicativos para o Lixo.
- Opcional: apague seus mapeamentos em
~/Library/Application Support/MidiPanel.