Everything Twist Commando can do, and how.

Getting started

1. Move Twist Commando to your Applications folder and open it. A welcome window shows what's connected and asks for the one permission worth granting up front. After that it lives in the menu bar: click its icon to open the window.
2. Plug in your controller: a Midi Fighter Twister, or one of the others. The window's header says Connected. From a Twister, Twist Commando reads its own settings (push modes, ring styles, MIDI numbers, brightness) so you don't set anything twice.
3. Click a knob's line under its ring to pick what it controls. That's it: turn the knob. With UA Console, Hue or OBS, the "…" menu's Map… items fill a whole bank at once.

The Twister's own setup

Twist Commando works with the Twister's factory settings. If you've changed them in the Midi Fighter Utility, keep these in mind:

• Encoders send CC (absolute) by default. Relative (ENC 3FH/41H) works too, and suits knobs that press keys: an absolute knob stops at the end of its travel until you pause, a relative one keeps going.
• Switch action can be CC Hold (the factory setting), CC Toggle, Note Hold or Note Toggle. Hold modes allow long press, double press and push-and-turn.
• Every knob needs its own number. Two knobs sharing one would drive the same setting.

Settings › Twister lists anything set on the Twister that would stop a knob working. When you change settings in the Utility, Twist Commando reads them again a few seconds later.

Sharing the Twister

Knobs you haven't assigned are left alone: Twist Commando never sends them anything, so another app (UA Midi Control, a DAW) can keep using them. To reserve a knob for another app, lock it (the lock in its corner, or right-click › Lock Knob) and note what uses it.

The window

The window shows one bank at a time, laid out like your controller: a 4 × 4 grid for the Twister (knob 1 top-left), the Komplete Kontrol's buttons, screens and knobs. Each card draws the control as it is: the Twister's LED ring, an endless knob's position, a pot's pointer, a fader, a pad. The line under it says what it does. Controllers with a drawing of their own (the QuNeo, Minim, Launch Control XL, Launchpad Pro, LPD8 and SL MkIII) show as they look, each control in its place and labeled with what it does: click one to select it (the bar below shows it, with its menu), double-click for its settings. Drag the window's edge to draw it bigger: controls with room become full cards. (Or "…" › Size, ⌘+ / ⌘− / ⌘0.) A controller that isn't plugged in can open its window too, to set it up ahead: Not Connected in the title's menu or the menu bar icon's right-click menu.

• Banks: the pills 1 2 3 4 switch banks, on the Twister too. The window follows when you change banks on the hardware. Click the bank's title to name it.
• Knob settings open beside the window: double-click a knob, click the selected knob again, or use the sliders button in the header.
• Copy and paste a knob's setup from its right-click menu.
• Keep it open: click the pin, or drag the window by an empty spot. Unpinned, it closes when you click elsewhere or press Esc.
• Header buttons: knob settings, scenes, meter view, Shift, the pin, and a "…" menu with Auto Map Controls…, Cheat Sheet… (a printable page per bank of what every control does, Shift layers included), Clear (the bank shown), Settings, Resync LEDs, LED Test, the MIDI log and Quit.
• More than one controller: the title's menu switches which one the window shows, or gives one its own window (closed with its close button or ⌘W). Two of the same controller each get their own: the second is "Twister 2", with its own settings, setups and scenes, and stays itself when you reconnect it. A controller shows in one place at a time: its own window, or the menu bar window. An own window's "…" menu has Keep on Top; off, it goes behind other apps like any window, and the menu bar icon's right-click menu brings it back.
• All your controllers at once: with more than one plugged in, the title's menu (and the menu bar icon's right-click menu) has All Controllers: one window with every controller plugged in, each working as in its own window. Its toolbar's Arrange button opens a map of them to drag to where they sit on your desk, as in System Settings › Displays: each lets go beside the nearest, lined up, and dropping one between two slides them apart to make room. One can sit anywhere along its neighbor's side, and lines up with its start, middle or end when it's let go near one. Turn a knob while arranging to see which one it is. Drag the window's edge to draw them all bigger or smaller; on a smaller screen they shrink to fit. Knob settings open under the window, wide and short with their sections side by side, for the knob you last clicked or turned on whichever controller; on a small screen the controllers shrink to make room. Its toolbar's Banks Together button (or Switch Banks Together in any controller's "…" menu) makes them act as one big controller: changing bank on one moves the others plugged in to the same bank, and one plugged in later joins them.
• Controller sets: the toolbar's Sets button (or Controller Sets… in a controller's "…" menu) chooses which controllers switch together. All Controllers is every controller not in a set of its own; untick one to leave it out. New Set makes a set of some controllers, switching Together (all to the same bank) or Paging. Paging takes two Twisters side by side: the one on the left shows a bank and the other the next, and either one's bank buttons slide both along, from banks 1 and 2 up to 7 and 8. The pair uses one Twister's settings, with 8 banks (pick which under Settings from); the other's own settings are kept for when the set is turned off. While paging, each Twister stays on its own bank 2 and Twist Commando decides which bank its knobs mean, so leave the Twisters' bank settings in the Midi Fighter Utility as they are.

Keyboard: the arrow keys move between knobs, Return opens the knob's settings, L locks or unlocks it, ⌘Z / ⇧⌘Z undo and redo any change, and ⌘, opens Settings.

Other controllers

The Twister has the fullest support, and more controllers work too. Each has a page in Settings › Controllers, with its knob and wheel speed.

Komplete Kontrol S MK2

Its eight knobs and screens show each knob's name and value, with UA Console, OBS and app meters, and a second value such as a channel's pan. The white buttons above the screens select a knob, and pressed again press it; so do Mute and Solo (Solo runs a knob's Solo action if it has one, and solos a UA channel). The 4D encoder fine-tunes the selected knob, pushes for Shift, and on an open wheel chooses. NI's own software keeps running alongside.

Novation SL MkIII (beta)

In InControl, its knobs, faders and 16 pads, with names and values on its screens and pads lit in each control's colors, and its other buttons too: the upper row over the faders, Scene Launch, the arrows, Grid, Options and the transport. Its Shift is Twist Commando's Shift; Screen Up / Down and Track ◀ ▶ switch banks. It steps aside while a DAW is running.

Novation Launchpad Pro (beta)

The first-generation Launchpad Pro, in its Fader layout: each column of pads is a fader it lights to the level, and its 32 round buttons light in full color.

Novation Launch Control XL (beta)

On Factory template 1 (press Factory, then the first Track Focus button): its 24 knobs, 8 faders and 16 buttons, with the side buttons, all laid out like the device, and every knob and button lit in its control's colors (red, amber or green). If you taught Twist Commando an XL yourself before it was built in, its page in Settings › Controllers offers Use the Built-In One.

Midi Fighter Spectra (beta)

Its 16 arcade buttons, laid out like the Twister's knobs, in four banks: its side buttons switch the window's bank, and the window's bank buttons switch the Spectra's. Each button's ring lights in its control's color (the closest of the Spectra's nine), bright while on and dim while off; unassigned buttons stay dark. In the meter view its buttons show levels, green through red.

Akai LPD8, Livid Minim and QuNeo

• Akai LPD8 mk2: its factory program, pads and knobs (one bank for now).
• Akai LPD8: the window follows its four programs (hit a pad after switching). Its page can pair each knob with a pad (the pad is the knob's button) and set every pad to momentary. PROG CHNG mode gives the pads and knobs their Shift layers; the first press after switching modes only switches.
• Livid Minim (Bluetooth): its top four side buttons switch four banks, and its pads light while on.
• Keith McMillen QuNeo: its pads light green, amber and red, and its sliders and rotaries follow their values. Its touch rotaries are smoothed, so a resting finger doesn't wobble the value. In the meter view its pads show levels.
• None has a Shift button, so make a pad one: choose Shift in its Controls menu.

Your own controller

Plug in any plain MIDI controller and open Settings › Add Controller…:

1. Pick it from the devices Twist Commando doesn't use yet, and name it.
2. Touch every control in order, left to right and top to bottom: turn each knob or fader all the way, press each pad or button a few times. Each one is added as you go, its type guessed from what it sends (a knob, fader, endless encoder, pad or button).
3. Click a control (or touch it) to change its type or name, start a new row with it, or remove it; drag to move it. Turn on Lights follow its value for controls whose LEDs the device lights to match what it's sent.
4. Save, and restart Twist Commando to use it.

Later, Edit Controls… on its page in Settings › Controllers changes it again; each control keeps its setup when moved. It's saved as a short JSON file in ~/Library/Application Support/Twist Commando/Devices, which you can also edit by hand for banks, bank buttons, pad shapes and pairs. The Record MIDI Log item in the "…" menu shows what a device sends.

Setting up a knob

A knob's settings have three parts:

• Header: its name (click to rename; unnamed knobs are named after what they control), its icon, and its switch colors: Off for while it's unlit and On for while it's lit. The ⇧ button edits its Shift layer.
• Control: what it controls and what that needs (a channel, a light, a shortcut), with its status.
• Press: what pressing does, the switch LED, and gestures.

Colors use the Twister's own color wheel, and are sent to its switch LEDs so the hardware matches the window. Off turns the LED dark. Controls without lights have colors too, for the window. Settings a control can't use (turning for a pad, pressing for a knob without a switch) aren't offered.

What knobs control

Each has a page in Settings › Controls, with its setup and a switch to leave it out of the menus if you don't use it.

System volume

Turning sets your Mac's output volume; pressing mutes. The switch lights while muted, and the on-screen indicator names the output device. To switch outputs from a knob, use a wheel of audio outputs.

Music Player: Spotify, Apple Music and VLC

Choose Music Player, then pick the app under Player: Whatever's Playing (below), or Spotify, Apple Music or VLC (only installed ones are listed). Turning sets the player's volume; pressing plays or pauses. (A full VLC knob is VLC's 100%; above that shows as full.) The switch lights while music plays, and follows when you pause in the app itself. The knob shows the app's icon. The first time, macOS asks to let Twist Commando control the app: click OK.

Whatever's Playing is one knob for whatever's playing. It moves to whichever app started playing last and stays on it while it's paused, until another starts. On Spotify, Music or VLC it controls that app's volume and play/pause. With app meters on (Settings › General) it also follows other apps, such as a browser: it's named after the app and shows its level, but turning it does nothing, since only Spotify, Music and VLC can be controlled. Its name, meter and ring follow the app it's on.

UA Console

Twist Commando talks to UAD Console directly (no MIDI setup, no UA Midi Control). Pick a channel, what turning adjusts and what pressing toggles:

• Map a whole bank at once: "…" › Auto Map Controls… › UA Console Channels fills the bank with your Console channels in Console's order: fader to turn, mute to press, and optionally a send or pan on each knob's Shift layer.
• Learn: click Learn… in a knob's settings and move a fader or switch in Console.
• Coming from UA Midi Control: Settings › UA Console imports its Twister mappings.
• Solo: a soloed channel's switch blinks, and the other channels' rings dim while they're silenced by the solo.

Changes made in Console or on the Apollo show on the rings straight away. Levels show in real units (−6.2 dB). Phantom power (48V) isn't offered on purpose.

OBS Studio

In OBS, turn on Tools › WebSocket Server Settings › Enable WebSocket server. Twist Commando reads its port and password from OBS on the same Mac (Settings › Controls › OBS Studio is for OBS on another computer). Then an OBS knob can:

• Turn: an input's volume, on OBS's own fader curve, or a scene wheel of your scenes.
• Press: mute, start or stop streaming or recording, the virtual camera, the replay buffer (or save a replay), studio mode, switch to a scene, show or hide a source, or turn a filter on or off. The switch lights while it's on.
• Map a bank at once: "…" › Auto Map Controls… › OBS Scenes puts your scenes on a bank's pads and buttons (or knob presses).
• Inputs' levels show in the meter view and on the Komplete Kontrol's screens.

Philips Hue

In Settings › Philips Hue, click Connect next to your bridge and press the bridge's round button within 30 seconds. Then a Hue knob can control a light, room or zone:

• Knob controls brightness (all the way down turns it off), color, saturation or color temperature. Put two knobs on one room for brightness and color. Lights are listed by room, and each only offers what it can do: a smart plug just switches, a white bulb has no color.
• On a temperature knob, the switch LED tints from warm orange to cool blue.
• Pressing switches it on and off; the switch shows the light's own color.
• Changes from the Hue app, a switch or an automation show within a second.
• Map a bank at once: "…" › Auto Map Controls… › Hue Lights gives each light a column of knobs: brightness, color and saturation (and temperature) going down, carrying on into the next banks.
• Color knobs loop round: past red at either end, the knob carries on from the other end.
• White or color: while a light is white its color and saturation knobs dim; while it shows a color, its temperature knob does. Turning a dimmed knob switches the light over.

Ableton Live (experimental)

Twist Commando has its own control surface script for Live 11 and 12. In Settings › Controls › Ableton Live click Install, then in Live choose Settings › Link, Tempo & MIDI › Control Surface: TwistCommando, with Input and Output set to None. In the MIDI Ports list on the same page, leave Track and Remote off for your controllers: Twist Commando talks to them, and Live listening to them too fights it (rings that don't follow, turns that do nothing). Then a Live knob can:

• Turn: a parameter of the selected device by number, or one of the eight on the device's page (Live's own pages, as Push shows them); a track's volume, pan or sends A–D; the master or cue volume. Names and values come from Live.
• Press: mute, solo, arm or select its track; the previous or next parameter page, device or track; the device on or off; lock the knobs to this device; play, stop, record and the metronome; move Live's box.
• Tracks are the selected track, a track by number, or one of the 8 in Live's box (the colored outline in Session view). The box follows the track you select, and shows only while the controller's bank uses it.
• The switch LEDs light in their track's color, and track knobs show Live's meters.
• Map a bank at once: "…" › Auto Map Controls… › Ableton Live: Mixer (the box's volumes and mutes, pans and solos; Shift + the first four presses move the box), Device Pages (eight page parameters, then paging, device on, lock and track moves), or All Parameters in order.

Logic Pro

Logic sees Twist Commando as a Mackie Control. In Logic, Control Surfaces › Setup…, then New › Install…, choose Mackie Designs · Mackie Control, and set its ports to Twist Commando MCU. Settings › Controls › Logic Pro adds up to three extenders (8 more tracks each). Then a Logic knob can:

• Turn: a track's fader (on Logic's own fader curve) or its V-Pot, which follows Logic's mode (Pan, Sends, Plug-in, EQ…).
• Press: mute, solo, arm, select or the V-Pot's press; move the tracks along; change the V-Pot mode, Flip, the cursor keys.
• Names and meters come from Logic, and the Mackie display appears on screen as you use them.
• Smart Controls: "…" › Auto Map Controls… › Logic's Smart Controls puts 8 knobs on the selected track's Smart Controls. Teach Logic once, as its Settings page shows; Logic doesn't send their values back.

Apple Shortcuts

A Shortcut knob can run up to three shortcuts: one on press, one while turning, and a status shortcut that reads the state back onto the ring and switch every few seconds. Each run gets a small JSON input:

{"event": "turn", "value": 62, "previous": 59, "delta": 3, "on": true, "bank": 1, "knob": 5}

What a shortcut returns updates the knob: a number 0–100 sets the ring, on / off sets the switch, or return both as {"value": 45, "on": true}. Good for HomeKit lights and scenes; each run takes a moment, so it's less suited to fast audio control.

Keyboard shortcuts

Sends a key combination per step of turning (one for each direction) and one on press, or a media key like Volume, Next or Play/Pause. That makes any app with keyboard shortcuts controllable, such as SoundSource's per-app volume. Record the combination in Twist Commando first, then assign it in the other app. Needs Accessibility permission.

Send to: keys go where the keyboard's own do, so by default they land in whatever app is in front. Name an app and they only go there: either nothing happens while that app isn't in front, or Twist Commando switches to it first and then sends. Use for the Whole Bank in the app's menu points every Keyboard control in the bank at it.

Long spins: a Twister knob set to send CC (its factory setting) has an end, and while you're turning it won't let Twist Commando move it back to the middle, so a long spin stops pressing keys until you pause. Set the knob's Encoder MIDI Type to Relative (ENC 3FH/41H) in the Midi Fighter Utility and it keeps going as long as you turn. Its ring will lean the way you turn and keep settling back to the top, so a Dot ring suits it best: it reads like a jog wheel rather than a level.

iZotope RX: "…" › Auto Map Controls… › iZotope RX fills a bank with RX's own shortcuts — the playhead with page jumps beside it, time, amplitude and frequency zoom, selection, markers, undo, and its modules on the controls that are left — all aimed at RX. RX takes no MIDI, so this is the way to put it on knobs.

MIDI Out (experimental)

Knobs become MIDI for other apps through a virtual port named Twist Commando: turning sends a CC (the level, or relative steps for endless controls), pressing a note or CC. In the other app (rekordbox, Ableton Live, Resolume…) turn on the Twist Commando MIDI input, and its output for lights, then use its MIDI Learn. What it sends back lights the knob.

Other Apps (experimental)

Apps on this Mac that support Twist Commando offer their own controls by name: choose Other Apps, then the app and one of its controls. Turning and pressing go to the app, and its values, their text and on/off show on the knob; a meter shows its level on the ring. An app shows up once it has been open, and stays listed while it's closed so knobs can be set up ahead; Settings › Controls › Other Apps lists them. (New in 0.13 as App Link; found through Applug from 0.15. For developers: how to add it.)

Run Command

Runs shell commands in your login shell, so your PATH and ssh keys work as in Terminal:

• On press: e.g. ssh amp 'power on'.
• On turn: with TWIST_VALUE (0–100), TWIST_PREVIOUS and TWIST_DELTA.
• Level from: a command whose output sets the ring (a number) and switch (on/off), after use or every few seconds.

Wheel

A Wheel knob opens a radial menu in the middle of the screen, like a game's weapon wheel. Turn to open it and to an item, then stop: a moment later it's chosen (or press to choose at once). Or hold the knob, turn and let go. No Choice cancels. A wheel can show:

• My Items: up to seven apps to open, shortcuts, key presses, commands, audio outputs or OBS scenes.
• Audio Outputs: your Mac's output devices, with the current one marked.
• Running Apps: the apps you have open, starting on the one in front. Press on one for Show, Hide and Quit.
• OBS Scenes: your scenes, with the one on air marked.
• App Switcher: macOS's own ⌘-Tab switcher. A quick press switches to the last app.
• Setups and Scenes: the controller's own; see Twist Commando.

Settings › Appearance has themes for the wheel. Wheel speed is in Settings › Controllers, for each controller. On the Komplete Kontrol, the 4D encoder's push and the button above the knob choose on an open wheel.

Presses and gestures

Switch LED sets what the switch shows: LED = state lights it while the target is on (muted, playing, light on), inverted lights it while off, and Twister LED leaves it to the Twister.

With a hold switch action (the factory CC Hold), each knob can do more:

• Push + turn: turning while holding the knob gives fine adjust (a quarter of the speed) or switches the knob to its Shift layer until you let go.
• Long press (half a second) and double press can open an app, run a shortcut, press keys, set a level, recall a scene, toggle Shift, or on UA Console knobs reset the level or toggle another switch (tap to mute, hold to solo).

With a double press set, a single press acts a moment later, once it's clear no second press is coming.

Pressing can do something other than the target's own press: Turn Up or Turn Down by 1–10% (repeating while held, like volume keys: one button for up, another for down), or set a level. It works for anything a knob turns, on any button or pad.

Shift layers

Any knob can have a Shift layer: a second setup with its own target, press and colors. While Shift is on, those knobs use it, and their rings and switches show it. For example, a knob's main layer controls a channel's fader and mute in cyan, its Shift layer the channel's AUX 1 send in amber.

Switch Shift with:

• the ⇧ button in the window's header;
• a Twister side button: Settings › Controllers › Midi Fighter Twister › Shift button › Learn…, then press it (toggles, or follows the button while you hold it);
• the Twister's own shift (a side button set to Shift in the Midi Fighter Utility);
• a pad or button set to Shift in its Controls menu (each press toggles it, or it's on while held);
• the Komplete Kontrol's 4D encoder push, or the LPD8's PROG CHNG mode;
• a gesture (Toggle Shift on a long or double press), or push + turn for one knob at a time.

Meters

The meter view (the waveform button in the header, or a Twister side button learned in Settings › Controllers) turns every UA Console and OBS knob's ring into its channel's live meter. Presses still work, so you can mute while you watch levels; turning does nothing until you switch it off. The Komplete Kontrol shows meters on its screens all the time.

Settings › General › App meters adds meters for Spotify, Music and System Volume knobs, from what those apps are playing. macOS asks once for permission; Twist Commando only reads levels and never records.

Any other knob has a Meter setting too, for any app: the one a SoundSource shortcut turns down, say, or just an app you want to keep an eye on, even on a knob that controls nothing. Pick the app, or Whatever's Playing, which follows the app that last started playing (a second or two of sound, so a notification's ding doesn't take it over) and stays on it until another starts. A browser counts as one app, Bandcamp in Firefox included.

Scenes

A scene saves the knobs in all banks or the ones you choose, and brings them back later. The theatre-masks button in the header saves and restores them; Settings › Scenes renames, updates and removes them.

• Recall (on for new scenes) also sets what the knobs control: Hue lights, volumes, Spotify and Music.
• With Recall off, a scene only repaints the rings, e.g. after the Midi Fighter Utility reset them.

Setups

A setup is what every control does, Shift layers and bank names too: a Studio setup, a Live setup, a Lights setup. Save the current one in Settings › Controllers › your controller › Setups, change the controls for another use, and save that as a new setup. Switching keeps each setup's changes.

• A setup can cover every bank or only some, leaving the others as they are.
• While an app runs: a setup can be used by itself while an app is open (Live, say), and switch back when it quits.
• Switch from its page, a press or a wheel (Twist Commando control). Scenes work within whichever setup is in use.

Auto Map Controls

"…" › Auto Map Controls… fills a bank in one go, with UA Console channels, OBS scenes, Hue lights, Ableton Live (a mixer or a device), Logic's Smart Controls or iZotope RX's keyboard shortcuts. Choose what to map and the bank to start from; some carry on into the next banks. It replaces what those controls did, and ⌘Z brings it back. Clear the rest of the banks it maps also unassigns everything else in those banks, so the mapping replaces them completely.

On-screen indicator

Turning or pressing a knob briefly shows what it controls and its new value, like macOS's volume indicator: DJ Mixer · AUX 1 −6.2 dB, Spotify Playing, Living Room 40%. It names the device too, and shows bank, Shift and meter view changes. Only your own turns and presses show it. Settings › Appearance puts it in one of nine spots on screen, in the menu bar next to the icon, or turns it off.

Web pages

Twist Commando serves pages of its own, for an iPad or phone beside your controller, a stream, or a second screen. Turn them on in Settings › General › Web Pages; they're on this Mac only unless you allow other devices, which then enter the 6-digit code shown there (once; it's remembered). Other websites can't reach them. The start page lists:

• Each controller, live and as it looks: names, rings, lights, values and meters. Tap to press, drag to turn, hold a knob to keep it pressed (a long press; drag while holding to push and turn). Tick several to see them together.
• The Web Controller: a controller of its own, eight faders and eight pads a bank, for anything Twist Commando controls.
• The Meter Bridge: every connected controller's levels side by side.
• The OBS Overlay: the on-screen indicator, for a Browser Source in OBS.

Beside each controller, a rail of buttons: its banks, Shift, the meter view, Compact (just the lights, smaller; a tap says what a control is instead of pressing it), Edit, and its setups and scenes. The button on its name's line adds labels to them. Its name is a menu to switch to another controller, or add one beside it.

• Edit: while it's on, a tap opens a control's sheet: its name, its color, Do what another control does (copy any assigned control), or Open on Mac, which shows it in the app with its settings.
• Layout (left edge): arrange controllers automatically, side by side or stacked, and fit the screen or fill it. Each set of controllers remembers its own. Full Screen is beside it, where the browser allows.
• A value that changes pops up at the bottom, like the on-screen indicator.
• On an iPad or iPhone, Share › Add to Home Screen opens a page full screen.

Sharing

A controller's page in Settings › Controllers can export it as a .twistcommando file:

• Export Controller… shares one you taught Twist Commando, so others can use it too.
• Export Controller + Controls… includes what every control does, all banks and Shift layers. Its options can give Hue rooms and OBS scenes generic names (Room 1, Scene 1…) and leave out shell commands; the file lists anything it would run.

Opening a file (or Import…) shows what it adds and what it runs first. Controls arrive as a new setup, replacing nothing; Hue lights are matched to yours (pick your room for theirs and its lights fill in), and UA channels and OBS scenes by name or in order.

Settings

Permissions

macOS asks for each of these the first time a feature needs it. None are needed for MIDI.

• Automation: controlling Spotify, Music and VLC.
• Accessibility: sending keys, and the App Switcher.
• Local Network: finding and controlling your Hue bridge.
• Audio capture: only if you turn on meters for apps.

If you declined one, turn it on under System Settings › Privacy & Security, or use Settings › Permissions.

Troubleshooting

A knob's presses fire at the wrong time

The knob's switch action on the Twister doesn't match what Twist Commando expects. Twist Commando reads it from the Twister, so check Settings › Twister for a warning, and Read Again after changing it in the Midi Fighter Utility.

The rings don't match

Choose Resync LEDs from the "…" menu. It re-reads every value (from UA Console too, without changing anything there) and repaints the rings.

"Not found"

Check the cable, then choose Rescan MIDI Devices from the "…" menu. A Bluetooth controller may need connecting again in Audio MIDI Setup › Window › Show MIDI Studio › Bluetooth.

A fader or pot doesn't move the value

It takes over only once it reaches the current value (after a bank or layer switch, or a change elsewhere), so nothing jumps. The indicator says which way to move it.

Spotify or Music knobs do nothing

Twist Commando needs Automation permission for them: System Settings › Privacy & Security › Automation › Twist Commando.

Asking for help

Save Diagnostic Report (the menu bar icon's right-click menu, or the "…" menu) puts a text file on the Desktop with what Twist Commando sees of your Mac, its MIDI devices and controllers, without private names. Send it along with a MIDI log of the problem.

Two knobs move together

They share a MIDI number. The window marks them with a warning; give each its own number in the Midi Fighter Utility.