Patchbay

A visual JACK patchbay for macOS: connect JACK clients and ports on a zoomable canvas, with automatic tidy layout and bulk connect-all.

The Patchbay view shows the live state of the Jack Audio universe: all connected clients, their ports, and the connections between them.

Note

The Patchbay is only available while Jack is running.

JackMate window maximised in Patchbay view. Several nodes visible

Patchbay view: session with multiple connected Jack clients

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.

Close-up of system (capture) and system (playback) nodes showing CoreAudio device names and vertical aggregate bracket bars separating device segments.

System cards: device names and aggregate bracket bars (new in v1.9.0)

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.


Canvas navigation

Panning

Click and drag on the canvas background to move the view.

When moving nodes or panning near the canvas edges, a subtle haptic feedback is triggered on the trackpad, indicating you’ve reached the boundary.

Zoom

  • Pinch on trackpad: smooth zoom centred on the cursor
  • Vertical scroll with the mouse wheel: discrete zoom
  • A zoom indicator appears temporarily as an overlay while zooming

Patchbay canvas during active zoom: semi-transparent overlay at canvas centre showing zoom percentage

Zoom overlay: shown during trackpad zoom

Re-centring

Click the ⊕ Re-centre button in the header to fit and centre all visible nodes. Click on the magnifier 1:1 to reset zoom to 100% (only active when already zoomed-in or zoomed-out).


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)

Close-up on a non-system node

Node badge and detailed client info sheet

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.

Patchbay canvas with a mix of expanded and collapsed nodes. Collapsed nodes appear as compact pills.

Collapsed nodes: compact view, wires preserved

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.

Patchbay canvas with one or more nodes selected - allows group drag,  group collapse, or group re-organize.

Multiple selection

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.

Patchbay canvas with one or more nodes outside the visible area. Directional indicators (arrows or pills) appear on the canvas edges.

Directional indicators: nodes outside the visible area

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.

Close-up on two nodes with a visible connection wire between them. Hover over a port (dot) to see the circle animation and wire highlighting.

Port hover: the connected wire is highlighted

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.

  1. Click the Connect All button in the toolbar (or right-click a node → Connect All)
  2. A sheet opens with a canvas preview of both clients
  3. Select the source client and the destination client
  4. Choose the connection mode: modulo (cycles channels if counts differ) or 1-to-1
  5. Click Connect: all matching ports are wired at once

ConnectAllSheet: patchbay-faithful canvas preview of source and destination clients, client pickers, connection mode selector.

Connect All: bulk connection between two clients

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.

The Volumes bar at the top of the patchbay, with the two sliders: Jack's output device and JackMoebius.

Output volume bar: Jack’s output device and “JackMoebius”
Tip

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.

Patchbay view with the Terminal log panel open on the right.

Easy access to Jack log panel in real time

Back to top