The Live Set Viewer renders your Ableton Live session as an interactive node graph. This reference describes every visual element in the graph, what it represents, and how it maps to the underlying Live Object Model.

Node types

Track

A track node is a large rectangular container that groups a track’s devices together.

Appearance:

• Header bar — colored to match the track’s color in Ableton, displays the track name
• Border — same color as the header
• Background — dark gray (#2a2a2a)

Header indicators:

Indicator	Color	Meaning
M	Red (#ff5555)	Track is muted
S	Yellow (#ffdd57)	Track is soloed
R	Red (#ff3333)	Track is armed for recording

Track type label — a small text label in the header showing the track type: audio, midi, return, or master.

LOM mapping: Each track node corresponds to a Track object in the Live Object Model. Regular tracks come from live_set tracks N, return tracks from live_set return_tracks N, and the master track from live_set master_track.

Device

A device node sits inside a track and represents a single audio effect, MIDI effect, or instrument.

Appearance:

• Border — subtle gray (#555)
• Background — dark gray, slightly lighter when active (#333), darker when bypassed (#2a2a2a)
• Opacity — full opacity when active, 50% when bypassed
• Bypassed label — an orange “bypassed” indicator appears below the device class when the device is inactive

Displayed information:

Field	Description
Name	The device’s display name (bold, light gray)
Class name	The internal class identifier (e.g., Reverb, Compressor2)
Device type	One of instrument, audio_effect, or midi_effect

LOM mapping: Each device node corresponds to a Device object at a path like live_set tracks N devices M.

Rack

A rack node represents an Ableton device rack (Audio Effect Rack, Instrument Rack, or MIDI Effect Rack). Racks are special devices that contain chains, each of which can hold further devices.

Appearance:

• Border — blue-purple (#6a6aff)
• Header bar — purple background (#4a4a8a) with the rack name and class name
• Background — dark blue-gray (#2a2a3a when active, #222233 when bypassed)
• Opacity — full when active, 50% when bypassed

LOM mapping: A rack corresponds to a Device object whose can_have_chains property is true.

Chain

A chain node represents a processing chain inside a rack. Each chain can contain its own sequence of devices.

Appearance:

• Border — dashed gray (#555)
• Background — dark blue-tinted gray (#252530)
• Header — small text label showing the chain name

LOM mapping: Each chain corresponds to a Chain object at a path like live_set tracks N devices M chains P.

Edges

Signal flow

Solid gray lines (#666) connect devices within a track from left to right, representing the audio or MIDI signal path through the device chain.

Send routing

Dashed, animated lines (#888, with a 5,5 dash pattern) connect regular tracks to return tracks. These lines represent send routing and only appear when a send level is above approximately 1%. Each send edge displays a percentage label showing the send level (e.g., “75%”).

Layout

The graph arranges nodes in a vertical stack:

1. Regular tracks (audio and MIDI) — top of the canvas
2. Return tracks — below regular tracks, separated by extra spacing
3. Master track — at the bottom

Within each track, devices are laid out horizontally from left to right in the same order they appear on the track in Ableton.

Interactive controls

Zoom and pan

• Scroll wheel — zoom in and out
• Click and drag on the canvas background — pan the view
• Controls widget (bottom-left) — zoom in, zoom out, and fit-to-view buttons

Minimap

A small overview of the entire graph appears in the bottom-right corner. It shows your current viewport as a highlighted rectangle and can be clicked to jump to a different area.

Breadcrumbs

Clicking a node sets a focus path. A breadcrumb bar appears at the top center showing the path hierarchy (e.g., “Set / tracks 0 / devices 1”). Click any segment to navigate up the hierarchy, or click “Set” to return to the full view.

Filter panel

A collapsible panel on the left side of the canvas lets you narrow down the graph:

• Search — text input that filters tracks and devices by name or class name
• Track type checkboxes — toggle visibility of Audio, MIDI, Return, and Master tracks
• Device type checkboxes — toggle visibility of Instruments, Audio FX, and MIDI FX

Color encoding

Track colors are converted directly from Ableton’s internal integer color representation to CSS hex values. The conversion extracts red, green, and blue channels from the integer, so track nodes in the viewer match the colors you assigned in Ableton.