Manual

Everything MidiPanel does, step by step.

1. Install

  1. Download the .dmg from the download page.
  2. Open it and drag MidiPanel to Applications.
  3. Open MidiPanel. Its icon appears in the menu bar, and it keeps running when you close the window.
  4. 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.

PermissionWhat it's forWhere
AccessibilityKeyboard shortcuts, window positions, meeting buttons.System Settings → Privacy & Security → Accessibility → turn on MidiPanel
AutomationControl 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 settingVolume 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

  1. Click the control on the screen, or turn on Set up from the controller and press the real control.
  2. Pick an action in the pop-up and adjust its options.
  3. 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

  1. Quit MidiPanel from the menu bar icon (Quit).
  2. Drag MidiPanel from Applications to the Trash.
  3. Optional: delete your mappings in ~/Library/Application Support/MidiPanel.