macOS · Apple Silicon + Intel · Ableton Live® · Real-time

LIVEcompanion

The missing layer between Ableton Live® and your creative workflow. Real-time session intelligence, project lifecycle management, and deep audit tools — all in one native app.

Get Started See features
Screenshot

Real-time Session Reading

A Remote Script inside Ableton Live® pushes track data, transport state, and arrangement structure to LIVEcompanion over a local socket in real time. No polling, no cloud, no accounts.

Persistent Project Metadata

Genre, key, mood, release label, mastering engineer, tasks, notes, lyrics, checklist — stored locally in SQLite, indexed by project path. Survives restarts and re-opens.

Full Lifecycle Management

From idea through sketch, development, arrangement, final mixing, to done — track your pipeline status, session time, and export history across all your projects.

Overview

Your studio at a glance

The Dashboard gives you a live pulse on your creative output — weekly session time, active days, tasks completed, and projects touched. A GitHub-style heatmap shows your production consistency over a full year.

  • Weekly summary: time, active days, tasks, projects
  • Year-long activity heatmap with day-by-day tooltips
  • Release date and deadline markers in the calendar — orange flags for releases, red triangles for deadlines
  • Rolling window for month and year views, always centered on today
  • Activity · last hour: 60-bar minute strip showing real-time session activity
  • Per-project stats: total hours, sessions, listening time
  • Pipeline kanban: idea → sketch → development → arrangement → final mixing → done (+ shelved, archived)
  • Top Projects chart: week/month/year view of your most-worked-on projects
  • Release deadlines and upcoming reminders — dismiss with Gelesen button
  • Exports widget with inline audio playback
Screenshot
Task Management

Tasks tied to arrangement positions

Create tasks directly or sync them from a MIDI track named "TASKS" in your set. Tasks with arrangement positions are grouped under your Ableton Live® marker sections, so the to-do list follows your song structure.

  • Marker-section grouping (Intro, Drop, Outro…)
  • Active task highlight follows the playhead
  • Jump to any position directly from a task
  • Sync tasks from MIDI clips in your Live set
  • Import timed SoundCloud comments as tasks (public & private links)
  • Open tasks count badge on the Tasks tab
  • Project sidebar with version history and comparison
Screenshot
Session Audit

Every track, in full detail

A live table of all tracks in your open set — type, status, instrument, effects, clip count. Expand any row for the full device chain, mix settings, and arrangement clips. Filter instantly by type or search by name.

  • Expandable detail rows: devices, clips, mix settings
  • Color accent bars matching your Ableton Live® track colors
  • Plugin latency audit per device
  • Filter by MIDI / Audio / Group and search by name
  • Drag column borders to resize
Screenshot
Arrangement Overview

Your song structure, always visible

A color-coded arrangement bar sits below the header, showing every marker section in your Live set — Intro, Drop, Break, Outro, and everything in between. Click any section to jump the playhead. Markers with tasks show dot indicators so you can spot unfinished work at a glance.

  • Color-coded sections auto-detected from marker names
  • Click-to-jump: navigate your arrangement from the bar
  • Task dot indicators per section
  • Customizable part colors in Settings
  • Collapsible — hide when you need more screen space
  • Responsive narrow mode: header and tab labels hide below 580px width
Screenshot
Project Management

Everything about your release

The redesigned Project view lets you manage every aspect of a release — from genre and key to label, distributor, catalog number, mastering engineer, and release date. Sub-tabs give you quick access to notes, lyrics, and session stats.

  • Cover artwork upload: drag-and-drop JPEG, PNG, or WebP (up to 10 MB)
  • Release title — a distinct name for the release, separate from the Ableton project name
  • Hero metadata: genre, key, BPM, mood, tags
  • Release details: label, distributor, catalog, ISRC, artwork status
  • Promo section with delivery checklist
  • Mode selector: Release or Liveset workflow
  • Sub-tabs: Info · Notes · Lyrics · Stats
Screenshot
Documentation

Notes, lyrics, and session logs

Keep freeform notes per project — mixing decisions, ideas, feedback. Write lyrics with [Section] markers for structured display and future teleprompter sync. The session log automatically captures every play, stop, and tempo change as a timeline.

  • Project notes with pin/unpin, quick-add from header
  • Plain-text lyrics with [Section] markers (Verse, Chorus, Bridge)
  • Auto session timeline: play/stop, tempo changes
  • Mix checklist — customizable per project
Screenshot
History & Analytics

Track your set over time

See your total session time, playing vs. idle breakdown, and a daily hours chart showing your work pattern over time. Take snapshots of your session state and compare them later. Analyze .als files and diff versions side by side.

  • Session time breakdown: total, playing, sessions
  • Daily work chart — hours per day from project start to today
  • Session snapshots with diff comparison
  • .als file analysis and version comparison
  • Change detection since last snapshot
Screenshot
ClyphX Pro

Deep ClyphX Pro integration

Built-in tools for producers running ClyphX Pro. Scan all X-Clips in your arrangement, audit duplicate identifiers, browse the full action reference, and build X-Clip strings visually without touching Ableton Live®.

  • X-Clip Scanner: all clips grouped by track with parsed actions
  • Audit: duplicate IDs, empty actions, muted X-Clips
  • User Actions Manager: reads your .py action files
  • Action Reference: searchable ClyphX Pro syntax guide
  • X-Clip Builder and Transpose tools
Screenshot
Signal Flow

Visualize your routing

See your entire session's signal flow at a glance. The Routing view maps out how tracks are connected — from source tracks through groups to the master bus. A dedicated Sends tab shows return channel routing in a fan layout.

  • Signal Flow: hierarchical track routing tree
  • Sends view: return channels with fan-out visualization
  • Node cards with track type, latency, and device info
  • Edge overlay showing audio routing connections
  • Release mode only — designed for complex sessions
Screenshot
Project Library

Your project library, organized

Browse, filter, and manage all your Ableton Live® projects in one place. The Library sidebar lets you search, sort, and quick-filter by recent activity or ignored status — so you always find what you need.

  • "Recent" quick filter: show only projects with sessions in the last 7 days (configurable)
  • "Show Ignored" / "Hide Ignored" toggle for managing hidden projects
  • Folder scan: deep-scan registered folders to discover all projects
  • Directory grouping: optional toggle groups projects by parent folder with batch-ignore
  • Sort by name, genre, status, release date, BPM, most worked on, or last opened
  • Inline audio playback with scrubber and time display
  • Auto-matches exports to projects by name
  • Dashboard widget shows current project's exports
Screenshot
Actions

Batch transpose your entire session

The Transpose action lets you shift MIDI and audio clips across your whole session in one click. Select which tracks to include, choose semitones, and LIVEcompanion handles the rest — with automatic key detection so you always know where you're going.

  • Automatic key detection across all harmonic tracks
  • Hierarchical track tree with group collapsing and select-all
  • Smart track classification: harmonic, drum, FX, skip — drums excluded by default
  • Clip type filter: MIDI + Audio, MIDI only, or Audio only
  • Scope selector: Arrangement, Session, or Both
  • Live key preview: see the target key before committing
  • Accessible from the Actions widget on the Project Dashboard
Transpose modal
Actions

Producer calculator at your fingertips

Three essential calculators in one modal, auto-populated with your session BPM. Open it from the Actions widget on the Project Dashboard.

  • Delay & Rhythm — delay times for all note values (1/1–1/32) in straight, dotted, and triplet variants; hover to visualize beat subdivisions on an SVG timeline
  • Note & Frequency — bidirectional note/Hz converter with interactive 2-octave keyboard, log-scale frequency band, harmonics table, and EQ reference points
  • LFO & Modulation — BPM-synced LFO rates with animated waveform preview (sine, triangle, square, saw, S&H); pulse width control for square wave
  • Every value is click-to-copy for quick pasting into your DAW
Calculator modal — Note & Frequency tab
Remote Script

Shadow clips — linked MIDI across your arrangement

Name any MIDI clip with an = prefix and it becomes a shadow clip. All clips sharing the same group name stay in sync — edit one, and all copies update automatically within two seconds.

  • Naming: =kick or =kick:intro — only the part between = and : is used for matching, so each copy can have a distinct display name
  • Synced: MIDI notes, velocities, loop points, and start/end markers
  • Independent: arrangement position and clip length remain per-clip
  • Works across different tracks — link a kick on the drums track with a sidechain trigger on the bass
  • Toggle on/off in Settings → Live Integration → Shadow clip sync
  • No Max for Live required — runs entirely in the Remote Script
Screenshot coming soon
Workflows

Timed production sessions, phase by phase

Load an HTML workflow file and start a session. LIVEcompanion reads the embedded phase metadata, highlights the active phase with a live countdown, and shows elapsed and remaining time in the status bar — so you can stay focused and move through your session with intention.

  • Phase list with time budgets displayed directly in the panel
  • Status bar shows current phase name, elapsed / total time, and a Next Phase button
  • Session survives page reload — state is stored in localStorage
  • Overtime indicator turns red when you've exceeded a phase's budget
  • Works with any HTML file — files without phase metadata still load normally
  • Generate new workflows from Claude Desktop using the included template (docs/workflow-template.md)
Workflows panel
AI Assistant

Ask anything about your session

A streaming chat drawer gives you direct access to an AI model with full context about your open project — tracks, tasks, tempo, markers, and project metadata. Use it to get mixing suggestions, summarize project state, or brainstorm ideas without leaving the app.

  • Streaming responses from Anthropic, OpenAI, Gemini, or Ollama
  • Bring your own API key — configured once in Settings
  • Works fully local with Ollama (no data leaves your machine)
  • Session-aware system prompt with live project context
  • Opens as a slide-in drawer — always accessible via the ✦ AI button
AI Chat
Claude Desktop Integration

Use Claude to control Ableton Live®

LIVEcompanion ships a bundled MCP server that exposes your Ableton Live® session to Claude Desktop. Once configured, Claude can read tracks, clips, markers, device parameters, and session state — no Python or developer tools required.

  • Zero-dependency binary — no Python installation needed
  • Copy the config snippet from Settings → Claude Desktop Integration
  • Paste into ~/Library/Application Support/Claude/claude_desktop_config.json
  • 10 tools: session overview, tracks, clips, devices, markers, routing, and more
  • Read-only — Claude observes, never modifies your session
claude_desktop_config.json
{
  "mcpServers": {
    "livecompanion": {
      "command": "/Applications/LIVEcompanion.app
                  /Contents/MacOS/livecompanion-mcp",
      "args": []
    }
  }
}
Menu Bar Integration

Lives in your menu bar

LIVEcompanion puts a persistent icon in your macOS menu bar with live stats from your session. Close the window and it keeps running — click the icon or the dock to bring it back instantly. Configure everything in Settings → Menu Bar.

  • Inline stat next to the icon — choose BPM, song name, or transport state
  • Quick-access menu: open the main window, overlay, or arrangement strip
  • Close-to-tray — closing the window hides instead of quitting
  • Launch at Login — start automatically when your Mac boots
  • Native notifications when Ableton connects or disconnects
  • Stats update every 3 seconds from the live session
Menu Bar Dropdown
My Track — 96 BPM
Open LIVEcompanion
Open Overlay
Open Arrangement Strip
Launch at Login
Quit LIVEcompanion
Onboarding

Get started in minutes

A setup wizard, guided tour, and project onboarding modal make sure you're ready to go — whether it's your first launch or your first time opening a new project in LIVEcompanion.

  • 4-step setup wizard with live connection monitoring
  • Guided tour with animated spotlight and step-by-step descriptions
  • Project onboarding modal — one-time setup for each new project: name, genre, tags, pipeline state, release date
  • Smart genre selector with your top genres and searchable Beatport list
  • Tag autocomplete from all existing project tags with keyboard navigation
  • Opens the compact overlay so you can see it in action
  • Re-trigger the tour anytime from Settings
Guided tour
Liveset Mode

Build and manage your live performance set

Switch any project to Liveset mode (via the Project Info tab) to unlock tools purpose-built for live performance preparation. The centerpiece is the Setlist view — a complete breakdown of your set's songs, scenes, follow actions, and timing.

How songs are detected

Songs are delimited by scene names that start with *. Every * scene begins a new song; scenes between two * markers belong to the same song. Truly empty scenes (no name, no clips) end the current song.

Scene name markers

Scene names carry encoded metadata that LIVEcompanion reads to calculate set timing, performance flow, and detect issues. The naming convention:

Pattern Meaning Example
* NAME >N Song start, next after N bars * INTRO Zug >32
>N Name Next after N bars (prefix for non-starters) >16 Chord Changes
>NJ:ID:LABEL Jump after N bars (with stable ID) >8J:S00:SISYINSICHT Outro
>N! Stop after N bars >16! Finale
<> Loop / no follow action <> Tropical Intro
ID:>N Name Jump target (carries the ID) S00:>16 Land
* ID:NAME >N Song start that is a jump target * I01:INTRO Zug >32

Jump IDs

When a scene's follow action is set to Jump, LIVEcompanion assigns a stable 3-character code (like A03 or S00) to identify the jump target. This ID appears in two places:

  • Source scene (the one that jumps): the ID is embedded in the J: marker, e.g. >8J:A03:TARGET_SONG
  • Target scene (the one being jumped to): the ID is a prefix, e.g. A03:>16 Name or * A03:SONG >16

IDs survive scene renames and handle duplicate scene names unambiguously. If two scenes are both called "Break", the ID tells LIVEcompanion which one is the actual jump target. When you resync from the .als file, IDs are preserved if the jump still exists, reassigned if the target changed, and removed if the jump was deleted.

The Setlist view

The main setlist view shows every song as a collapsible row. Expanding a song reveals its individual scenes with:

  • Bar count — derived from the >N marker in the scene name
  • Follow action — Next (), Jump (↗ target name), Stop, or Loop
  • Duration — calculated from bars and tempo
  • Warnings — name/file mismatches, unresolvable jump targets, missing markers

Each song row shows its end-of-song flow: where playback goes after the last scene (next song, jump to a specific song, stop, or loop). Songs that are never reached by the follow action chain are marked as skipped (dimmed, struck-through).

Timeline strip

A proportional timeline strip above the setlist shows only the reachable songs, color-coded and sized by duration. Hover for details; click to launch a song in Live. The total duration reflects the actual set (excluding skipped songs).

Reachability & flow loops

LIVEcompanion traces the performance flow from the first song: following Next actions, resolving Jump targets, and treating Loop/Stop as manual-advance (the performer triggers the next scene). Songs that are never reached by this chain are marked as skipped. If the flow creates a cycle (e.g. Song A → Song B → Song C → Song A), this is shown in the info panel as a flow loop.

Inspect File (.als)

Click Inspect File to read the saved .als file and compare its follow action data against the scene name markers. This is a one-time read, not a continuous poll — scene names from the Live API update every 10 seconds, but .als data only refreshes when you click the button.

After inspecting, the info panel shows additional detail for each scene's follow action (chance percentages, linked actions, loop iterations) and highlights mismatches between the name markers and the .als data.

Sync Scene Names

The Sync Names tool in the info panel reads the .als file and proposes scene name updates to match the actual follow action state. It handles the full lifecycle:

  • Bars marker — sets >N from the follow action's beat count
  • Action type — adds J:ID:LABEL for jumps, ! for stops, <> for no-FA scenes
  • Jump IDs — assigns new IDs, preserves existing ones, removes stale ones
  • Target prefixes — adds/updates/removes ID: prefixes on target scenes

The tool shows a preview of all proposed changes before applying. Always save your set under a new name first (File → Save As in Live) — the renames are applied directly via the Live API and cannot be undone.

The sync is idempotent: running it twice with no changes produces zero proposals.

Follow Action Wizard

The Wizard is a more aggressive tool that writes follow actions into the .als file itself (creating a new versioned copy). It finds the A/B Drums clip in each scene, measures the loop length, and sets a "Next" follow action with that bar count. Use it for initial setup; use Sync Names for ongoing maintenance.

Live playback highlighting

While Live is playing, LIVEcompanion highlights the current scene in the setlist with an accent glow, and the timeline strip lights up the playing song's block. The containing song row auto-expands so you always see what's coming next without scrolling. Detection is consensus-based — it reads playing_slot_index across all tracks and only commits to a scene when ~80% agree, so a single off-grid clip can't fool it. ClyphX-only groups are skipped, and the polling rate stays low enough not to compete with audio.

Scene-linked tasks

Every task in a Liveset project can carry a scene anchor. The task quick-add captures the currently playing or selected scene with a stamp button, and the Tasks tab groups tasks by scene with the actual scene names from your setlist. A row of tasks for a scene gets highlighted while that scene is playing, so during rehearsal you can see exactly what still needs work as the set progresses. Tasks also get a one-click Launch button that fires that scene in Live — handy for jumping back to a problem spot mid-rehearsal.

Reordering scenes in Live remaps the task anchors automatically using the .als file's stable identifiers, so notes-to-self don't drift when you move songs around. Set terminators (scenes named END, STOP, or ---) end the reachability chain — tasks attached to scenes past a terminator are still kept, just not surfaced as part of the active set.

Live Mode & the performance overlay

Live Mode is a one-toggle "I'm performing now" state. Flip it on from the header and the app reduces every poll: the session refresh slows to two minutes, watchdog timers back off, and the AI chat stops fetching context. Anything that could spike CPU or interrupt audio gets put to sleep. Flip it off after the show and everything resumes.

Live Mode also unlocks the compact overlay — a small always-on-top window meant to live in a corner of your performance screen. It carries five widgets, each independently togglable in Settings:

  • Setlist — every reachable song in the current set, scrollable, with one-click focus (scroll Live to the song) and launch (fire its first scene). The currently playing song auto-scrolls into view and gets a dot indicator.
  • Scene — the playing scene's name with the next scene shown beneath, so you always know what's coming.
  • Session timer — running time of the current performance.
  • Latency — round-trip latency badge with traffic-light thresholds.
  • Actions — quick-fire buttons for Calculator, Cleanup, and Transpose.

The overlay shares its setlist data with the main window, so opening it mid-set doesn't trigger a fresh fetch — it appears with the cache already warm. An arrangement strip window (separate from the overlay) shows the same color-coded section bar as the main app, sized for a small monitor or second display.

Quick Start

Up and running in 3 steps

LIVEcompanion runs as a native macOS app alongside Ableton Live®, on both Apple Silicon and Intel Macs. No cloud, no accounts, no subscription. A built-in setup wizard walks you through everything on first launch.

01
One time

Install & launch

Drag LIVEcompanion into Applications and double-click to launch. The app is signed and notarized by Apple — no Terminal commands needed. On first launch, the setup wizard guides you through Remote Script installation, folder configuration, and Ableton Live® connection.

02
One time

Enable in Ableton Live®

In Ableton Live®: Preferences → Link, Tempo & MIDI → Control Surface → select LiveCompanion. The status bar in LIVEcompanion turns green when connected. The setup wizard monitors this automatically.

03
Every session

Open your Live set

Save your project first (Cmd+S) in Ableton Live® so LIVEcompanion can identify it. All views populate with live data immediately. The arrangement overview bar shows your marker structure in real time. An optional guided tour highlights the key features.

Requirements

  • macOS 12 or later
  • Apple Silicon or Intel Mac (Universal binary)
  • Ableton Live® 11 or 12 (any edition)
  • Saved project (.als file)

Optional

  • ClyphX Pro (for ClyphX tab)
  • Exports folder configured (for Library)

No account needed

  • All data stored locally in SQLite
  • No internet connection required
  • Works fully offline
Known Issues

Known Bugs

LIVEcompanion is in active development. Here's a transparent list of known issues and their current status.

Fixed Arrangement strip tooltips clipped

Task badge tooltips in the strip pop-out now open as a dedicated always-on-top Tauri window — they can never be clipped by the OS window boundary. Note: tooltip corners may appear as a solid rectangle rather than rounded if macOS private API transparency is not enabled.

UI Arrangement strip on all Spaces

The arrangement strip uses always_on_top + visible_on_all_workspaces, so it appears on every virtual desktop and doesn't show in Mission Control. Moving it between Spaces independently is not yet possible.

Fixed Remote Script version string

The Remote Script now declares a proper __version__ string. Settings correctly reports the installed version rather than a raw byte count.

Minor Backend startup race

On first launch the frontend may briefly show "Connecting…" while the backend sidecar starts up. Health checks retry every 10 seconds — it resolves automatically within a few seconds.

Expected Untitled project warning

Notes, tasks, and checklist features are unavailable when the Live set hasn't been saved yet. Save the set to a named folder to unlock all features.