Patchbay
The Patchbay view shows the live state of the Jack Audio universe: all connected clients, their ports, and the connections between them.
The Patchbay is only available while Jack is running.
Concepts
Clients and ports
In Jack, each audio application is a client. Each client exposes ports:
- Output ports: on the left side of the node
- Input ports: on the right side of the node
The two system clients system (capture) and system (playback) represent the physical audio interface. Unlike regular client nodes, they display additional hardware information (new in v1.9.0):
- Device name: the CoreAudio device name is shown in the free zone above the port list
- Aggregate bar: when Jack has created an internal aggregate (two separate devices used as input and output), each physical device segment is indicated by a vertical bracket bar, with its name and channel count
Clicking the badge opens a detail sheet with the full hardware breakdown.
Connections
A connection links an output port to an input port. Audio signal flows left to right. A Jack connection is not exclusive: a port can be connected to multiple destinations.
Nodes
Each Jack client is represented as a box (node) on the canvas.
Badge
The top-left corner of each node shows a badge with the client’s initials (two letters, colour generated deterministically).
For system clients: - 🎙 system (capture): microphone icon, cyan colour - 🔊 system (playback): speaker icon, violet colour
For JackMoebius clients (native macOS apps exposed to Jack), the badge is the real application icon; apps on the shared input get a box with the two mirrored shared_input ports. See JackMoebius.
Click the badge to open a detailed info sheet for that client.
The sheet displays: - GUI applications: name, bundle path, PID, icon - CLI clients (jack_metro, a2jmidid, etc.): executable path, full command line, PID (detected by scanning the process table)
Collapse / expand
Click the arrow next to the node name to collapse it. A collapsed node hides its ports but remains on the canvas. The toolbar buttons Collapse all / Expand all act on every node at once.
Moving a node
Click and drag the box to reposition it freely.
Multiple selection
Select several nodes simultaneously:
| Action | Result |
|---|---|
| Shift + click on a node | Add/remove from selection |
| ⌘A | Select all nodes |
| Click + drag on empty canvas | Marquee selection rectangle |
A count badge appears on the collapse/expand button when a selection is active. Click the badge or outside any node to deselect.
Group drag
With multiple nodes selected, drag any one of them: all selected nodes move together, preserving their relative positions.
Out-of-view nodes
When nodes are outside the visible canvas area, directional indicators appear on the window edges. Click an indicator to centre the view on the corresponding node.
Connections
Creating a connection
Drag from an output port (the dot on the right of a node) to an input port (the dot on the left of another node). The connection is established instantly in Jack. While you drag, the compatible ports (opposite direction, same type) light up. You can also start from an input port and drop on an output port.
Removing a connection
A wire can’t be clicked: right-click instead.
- On a port (the dot): a menu offers Disconnect this port, which removes every connection of that port, plus Disconnect all inputs, Disconnect all outputs and Disconnect entire client for the whole client.
- On the client box itself, in its input zone (left half) or output zone (right half): the menu offers Disconnect all inputs or Disconnect all outputs (according to the side you clicked, or both from the header), and Disconnect all. Entries are greyed out when nothing is connected there.
Port hover
Hovering over a port animates a circle around it. Connections linked to that port are highlighted. A light haptic feedback fires on the trackpad when the cursor snaps onto a port.
Connect All
Connect All establishes connections in bulk between two clients, useful for quickly linking a DAW to system (playback) or wiring an effect chain.
- Click the Connect All button in the toolbar (or right-click a node → Connect All)
- A sheet opens with a canvas preview of both clients
- Select the source client and the destination client
- Choose the connection mode: modulo (cycles channels if counts differ) or 1-to-1
- Click Connect: all matching ports are wired at once
Output volumes
★ New in 2.0.0
The Volumes bar (toggled from the toolbar) appears at the top of the patchbay and controls the output-device volumes directly, without selecting the device in macOS:
- Jack’s output device: the interface Jack plays through
- “JackMoebius”: the JackMoebius system device (shown when JackMoebius is running)
Each has a Control-Center-style slider, synced live with the macOS volume keys (F10/F11/F12) and System Settings ▸ Sound. There is no separate mute: drag a slider to zero. The sliders are pure CoreAudio, so they work even when Jack or JackMoebius is down; a device with no settable volume (e.g. HDMI) shows greyed out.
For per-app volumes (each exposed JackMoebius app individually), see Per-app volumes.
Toolbar
| Button | Action |
|---|---|
| Tidy | Automatically reorganises nodes on the canvas (Sugiyama layout) |
| Collapse/expand | Collapse or expand clients (either all or selected nodes) |
| ⊕ Re-centre | Fit and centre all nodes; double-click to reset zoom to 100% |
| ↻ Refresh | Force-resync ports and connections from Jack |
| Transport | Open the transport panel |
| JackMoebius | Open the JackMoebius panel: expose native macOS apps to Jack (see JackMoebius) |
| Volumes | Show/hide the output volume bar (see Output volumes) |
| Save as Studio | Save the current state as a named studio |
| Open Audio Midi Setup | Quick access to macOS configuration panel |
| Logs | Open/close the Jack log panel (filtered outputs) |
Tidy layout
The Tidy button automatically arranges nodes using a hierarchical layout algorithm (Sugiyama). It minimises wire crossings and groups clients by signal flow (sources left, sinks right).
You can also Tidy a selection only: Shift-click nodes to select them, then click Tidy: only the selected nodes are rearranged.
Log panel
The log panel appears on the right side of the canvas. It shows the raw output of the Jack process in real time.
An orange badge on the Terminal button signals warnings in the logs.
Xruns (audio dropouts) are counted and displayed in the footer. A Reset button clears the counter.











