Advanced Command Line documentation
jackmoebius is the command-line control tool. It talks to the jackmoebiusd daemon over a local socket. Most commands require the daemon (hence a running JACK server); version works even when everything is stopped.
Apps are matched by their display name (Safari, Music) or their bundle ID (com.apple.Safari), case-insensitive.
jackmoebius <command> [arguments]Version & lifecycle
| Command | What it does |
|---|---|
jackmoebius version |
Print the version + copyright (works while stopped). Aliases: --version, -v. |
jackmoebius start |
Launch jackmoebiusd (JACK must be up). |
jackmoebius stop |
Stop the daemon cleanly. |
jackmoebius status |
Daemon, device, JACK and transport health, shared input (--verbose for details). It also shows how full the two buses are (capacity), with --verbose, from 80 %, or whenever channels are held by a card that kept a stream without its side, naming the apps that hold them (see rebuild). |
jackmoebius doctor [--json] |
Say what is wrong and what to do about it. See Doctor. |
$ jackmoebius version
JackMoebius 1.1.0
Copyright © 2026 Éric Bavu. All rights reserved.License & trial
JackMoebius runs as a 14-day trial, then needs a license. These commands work while the daemon is stopped (like version); reading the status needs no network.
| Command | What it does |
|---|---|
jackmoebius license |
Show the trial / license status. Add --json for a machine-readable form. |
jackmoebius license activate <KEY> |
Activate this Mac with your license key (needs an internet connection). |
jackmoebius license refresh |
Re-validate the license online now (e.g. after freeing a slot on another Mac). |
$ jackmoebius license
Trial — 9 day(s) left
$ jackmoebius license activate XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
License activated on this Mac (1/5 machines used).A license is perpetual and, once activated, stays valid offline indefinitely, so you’re never locked out for lack of network. A license covers up to its activation limit of Macs (shown in the status); to move it to another Mac, contact support.
Apps & routing
Every app has two directions, and for each one you choose where it goes. That choice is a spec:
| Spec | What it means |
|---|---|
shared |
The common JackMoebius device, with nothing to set in the app. Output: a stereo pair of its own, separate from every other app. Input: the same two channels (shared_input_1/2 in JACK) for every app in this mode. |
private |
A device of its own, JackMoebius for <App>, that you select in the app (the guide calls it a card: a virtual sound card for that app). 2 channels. |
private=N or N |
The same with N channels, from 1 to 64 (mono included). A bare number always means a card of N channels. |
| Command | What it does |
|---|---|
jackmoebius apps |
List CoreAudio apps seen by the driver (per-app state: exposed, backing, channels, capture-capable, blacklisted). |
jackmoebius add <App> [--in [<spec>]] [--out [<spec>]] |
Expose an app’s input and/or output; its JACK box appears. |
jackmoebius remove <App> [--in] [--out] |
Hide an app’s box (the channel reservation is kept). |
jackmoebius list |
Currently exposed boxes, with per-box routing status. |
A flag without a spec asks you the question (at a terminal). add, remove and clear with neither --in nor --out ask which side you mean. In a script nothing is guessed: say it on the command line.
$ jackmoebius add Music --out shared
exposed 'Music' on channels 2/3 (the app plays to the JackMoebius default output)
$ jackmoebius add Safari --in shared
'Safari' reads the shared input (ports shared_input_1/2, the same two channels for every app in this mode) ...
# one device, JackMoebius for REAPER, with 8 inputs and 16 outputs
$ jackmoebius add REAPER --in private=8 --out private=16
$ jackmoebius add "QuickTime Player"
Which side of 'QuickTime Player' do you want to expose?
1) output the app's sound towards JACK
2) input JACK towards the app
3) both
Choice [1/2/3, q to cancel]:- Use shared for apps that have no device menu (browsers, dictation, many small apps): they follow the Mac’s default input and output, which JackMoebius takes care of.
- Use a card when the app lets you choose its input or output device in its settings and you want channels of its own (a DAW, a video call, a recorder). Then select JackMoebius for <App> in the app.
- If an app has a single device setting for input and output and you want it on a card, make both directions private (
--in private --out private): a card that only has an input has no output for it. Such an app can also stay on the shared device: leave both directions shared and select JackMoebius in it.
Changing a direction
A card only holds the directions you made private. When you change one direction of an app:
- Adding a private direction to an app that already has a card for the other one, or changing the number of channels, rebuilds the card: the app sees its device go and come back for a moment.
- Moving a direction back to
sharedwhile the other direction keeps a card leaves the card as it is. That direction is no longer wired, so choose the shared JackMoebius device for it in the app. Its channels stay reserved until the card is deleted or rebuilt. - Moving it back when nothing else needs the card deletes the card. An app that had selected it falls back to another device.
The routing status in list is ok / mismatch / idle / absent. It reports whether the app actually uses the right JackMoebius device (see the IPC protocol).
Reservations
Channel reservations are persistent: an app keeps its channels across restarts, so a saved patchbay restores itself. remove hides a box but keeps the reservation; clear frees it.
| Command | What it does |
|---|---|
jackmoebius assignments |
Show the persistent channel reservations (outputs, then private inputs). |
jackmoebius clear <App> [--in] [--out] |
Drop an app’s reservation (frees its channels; the card goes when nothing else needs it). Works with the daemon stopped, too. |
jackmoebius rebuild <App> |
Rebuild an app’s card as it is, to free the channels held by a stream the card kept without its side (the app sees its device go and come back). status and doctor say which apps hold channels; with none, nothing happens. |
Volume
Per-app output volume, with a “cadenas” (lock): locked = follows the volume of the JackMoebius device; unlocked = its own independent gain.
| Command | What it does |
|---|---|
jackmoebius volume <App> |
Show the app’s {locked, gain}. |
jackmoebius volume <App> lock | unlock |
Lock to master, or take independent control. |
jackmoebius volume <App> <gain> |
Set an independent linear gain (1.0 = unity, 0.0 = mute). |
Safety offset
The safety offset is the value, in frames, that the JackMoebius devices announce to macOS. The default is 64. It is applied when the daemon starts, so a new value takes effect after jackmoebius stop and jackmoebius start (in JackMate, deactivate and activate JackMoebius). In our measurements it does not change the round trip: see Latency.
| Command | What it does |
|---|---|
jackmoebius safety |
Show the configured value and the one in force. |
jackmoebius safety <frames> |
Set it, from 0 to 2048. |
jackmoebius safety reset |
Back to the default (64). |
Doctor
jackmoebius doctor lists what is wrong and what to do about it: the daemon or JACK not running, the background service missing or switched off, an app that does not use its card, a bus that is nearly full, another account using JackMoebius. Add --json for the structured list (stable codes, which JackMate shows as banners). The exit status is 1 when there is an error. It also works with the daemon stopped, with what it can check on its own.
Blacklist
Apps you never want proposed for routing (hidden from add and from the selector). Ships with Audio MIDI Setup, JackMate, and Zoom (see the note below); fully revertable.
| Command | What it does |
|---|---|
jackmoebius blacklist --show |
List the blacklist. |
jackmoebius blacklist --add <App> |
Blacklist an app (refused if it’s currently exposed). |
jackmoebius blacklist --remove <App> |
Un-blacklist. |
jackmoebius blacklist --reset |
Restore the shipped defaults. |
Zoom is blacklisted by default and does not work with JackMoebius. On macOS, Zoom rejects virtual audio devices, even when wrapped in an Aggregate Device, unlike most apps. This is a Zoom limitation (its handling of virtual devices is undocumented), not a JackMoebius bug: every other app we tested (Microsoft Teams, Audacity, OBS, browsers…) works normally.
Shell completion
The installer ships zsh and bash completions (commands, --in and --out with their values, and live app names for add / remove / clear / blacklist).
The zsh completion file is installed on the completion path (/usr/local/share/zsh/site-functions), but zsh only activates completions once your shell has initialized its completion system. If jackmoebiusTab does nothing (typically on a fresh account with no ~/.zshrc), add this line to your ~/.zshrc and open a new terminal:
autoload -Uz compinit && compinitMost setups (Oh My Zsh, a customized ~/.zshrc, …) already do this. It’s the standard step for every tool’s zsh completion. The installer deliberately does not edit your shell configuration.
For bash (a minority on macOS, whose default shell is zsh), the completion is installed in the standard Homebrew directory /usr/local/etc/bash_completion.d. It activates automatically once you have bash-completion installed and sourced (brew install bash-completion, then source it from your ~/.bash_profile). Again, a shell-config step the installer leaves to you.