1. Home
  2. Docs
  3. Advanced
  4. Patcher

Patcher

This is a reference for the Patcher — if you are looking for some examples instead, please check out the Getting Started guide.

The Patcher is the main stage in AudioNodes. It’s where you can set up audio, automation, and MIDI processing in your project. Right-clicking on empty area opens up the node browser to start creating (on touch devices: touch-and-hold).

Note: some Nodes also appear on the Timeline when placed on the Patcher. This is indicated by a small blue badge on the Timeline’s button in the header, near the top-left corner of the screen.

Mouse and keyboard

This is a basic usage reference of the Patcher with a mouse and optional keyboard (see touch screen below). Note that while a keyboard is not technically required to use the Patcher, it gives faster access to several tools and utilities.

InputActionNotes
empty area left-clickdeselect all nodes and i/o ports
empty area right-clickopen node browser to create nodesthis will also clear your selection (same as left clicks)
node left-clickselect nodethis will deselect other nodes
node control + left-clicktoggle selection of nodethis will keep your previous selection
node right-clickopen node menuthis will deselect other nodes – hold control to keep previous selection
node double left-clickopen node settingsthis will deselect other nodes
connection left-clickopen connection mini-menu
empty area left-click dragmove screen
mouse wheelzoom in/out
alt + left-mouse + dragarea selection toolthis will deselect already selected nodes outside the selection area
shift + left-mouse + dragconnection cut toolmove the cursor across connections to cut them
control + zundo last actionthis may affect changes elsewhere (e.g. Node options and Timeline) – also available in top-left menu, under “edit”
control + yredo last action undonethis may affect changes elsewhere (e.g. Node options and Timeline) – also available in top-left menu, under “edit”

Node Menu

Right clicking a Node opens its menu, with additional tools to edit the selected Nodes, as well as hotkeys to access them faster.

InputHotkeyResultNotes
Swapswap selected Nodesonly available with exactly 2 selected Nodes, and only with compatible connections (if any)
CopyCtrl + Ccopy selected Nodes
CloneCtrl + Dduplicate selected Nodesthe newly created Nodes are placed slightly upwards and auto-selected
DeleteDeldelete selected Nodeslike other actions, can be undone using Ctrl + Z
GroupCtrl + Ggroup selected Nodes into a subpatchonly available with 2 or more selected Nodes, and requires an AudioNodes HD subscription
Helpshow Node docs
Share Snippetcreate a shareable web link of the selectionrecipients of the link can preview or copy the shared snippet (but can’t edit your project)
View on Timelineshow the Node on the timelineonly available for Nodes which are on the Timeline
Properties2x left clickopen node settings

Some Nodes, such as the Audio File Node, the Subpatch Node and the Piano Roll Node, have additional tools in this menu. These tools only appear when there is only 1 Node selected.

Connections & I/O Ports

Most Nodes have input ports (on the left) and output ports (on the right). They are visualized as small dots. Ports can be connected to create connections between Nodes by:

  • Clicking on an output port, then clicking on an input port to create a single connection
  • Clicking on 1 or more input ports, then clicking on an output port to create connections to multiple inputs simultaneously
  • Dragging an output port to an input port to create a single connection

Deleting existing connections can be done by:

  • Clicking on a connection, and then clicking on the Delete button (X) to delete a single connection
  • Holding Alt + Left Mouse and cutting connections with the cursor

Additionally, ports can be right clicked to access additional utilities.

Touch Screen

This is a basic usage reference of the Patcher with a touch screen. While small screens (i.e. phones) are supported, larger screens (tablets) work much better thanks to the extra screen space.

InputResultNotes
empty area tapdeselect all nodes and ports
empty area touch-and-holdopen node browser to create nodesnode browser opens when the circle indicator completes
node tapselect nodethis will reveal additional Node actions in the header, and deselect other nodes
connection tapopen connection mini-menuconnections can be deleted from their mini-menu
empty area dragpan screen
pinch zoomzoom in/out

Node Menu

On touch screens, selecting a Node will open additional options in the Header, at the top. Touch-and-hold these buttons to show a tooltip about what they do:

ButtonIconResultNotes
Backleft arrowclose menu and clear selection
Multiselect2x checkmarktoggle multiselect (blue = enabled)tapping on Nodes while enabled will not deselect other Nodes
Clone2x sheetduplicate selected Nodesthe newly created Nodes are placed slightly upwards and auto-selected
Deletebindelete selected Nodeslike other actions, can be undone using Ctrl + Z
Settingsgearopen node settingscan also be accessed by selecting Node and swiping from the right edge
Moreellipsismore optionssee next table

Tapping the More button in the Header menu shows additional options:

ButtonResultNotes
Swapswap selected Nodesonly available with exactly 2 selected Nodes, and only with compatible connections (if any)
Copycopy selected Nodes
Groupgroup selected Nodes into a subpatchonly available with 2 or more selected Nodes, and requires an AudioNodes HD subscription
Helpopen Node docs
Share Snippetcreate a shareable web link of the selectionrecipients of the link can preview or copy the shared snippet (but can’t edit your project)
View on Timelineshow the Node on the timelineonly available for Nodes which are on the Timeline

Connections & I/O Ports

Most Nodes have input ports (on the left) and output ports (on the right). They are visualized as small dots. Ports can be connected to create connections between Nodes by:

  • Tapping on an output port, then tapping on an input port to create a single connection
  • Tapping on 1 or more input ports, then tapping on an output port to create multiple connections

Connections can be deleted by tapping on a connection, and then tapping on the Delete button (X) that appears above.

Was this article helpful to you? Yes No