alivirgo/major-ai-skills/ableton-live

┌─────────────────────────────────────────────────────────────┐
│                 Ableton Live Architecture                   │
│                                                             │
│  Presentation & Dual-Workflow Tier                          │
│  ├── Session View (Non-Linear Clip Grid & Scene Launching)  │
│  ├── Arrangement View (Linear Timeline Automation & Stems)  │
│  └── Mixer & Device Chain (Audio/MIDI Effects, Macro Racks) │
│                                                             │
│  DSP & Extensibility Core                                   │
│  ├── 64-bit Native DSP Engine (Warping, Resampling, Summing)│
│  ├── Max for Live (M4L) Embedded Max/MSP Graphical DSP Engine│
│  └── Python 3 MIDI Remote Scripts Framework (`ableton.v3`)  │
│                                                             │
│  Synchronization & Audio Driver Layer                       │
│  ├── Ableton Link (Peer-to-Peer UDP Tempo & Phase Sync)     │
│  └── ASIO (Windows) / CoreAudio (macOS) Buffer Subsystem    │
└─────────────────────────────────────────────────────────────┘

"""
Ableton Live 12 Remote Automation Client via AbletonOSC (UDP Port 11000)
Automates track volume, pan, tempo, and fires Session View clips programmatically.
"""
import sys
import time
from pythonosc.udp_client import SimpleUDPClient
LIVE_IP = "127.0.0.1"
LIVE_PORT = 11000 # Default AbletonOSC Port
class AbletonController:
    def __init__(self, host: str = LIVE_IP, port: int = LIVE_PORT):
        self.client = SimpleUDPClient(host, port)
        print(f"--- [ABLETON LIVE OSC CONTROLLER: {host}:{port}] ---")
    def set_tempo(self, bpm: float):
        print(f"Setting Master Tempo: {bpm:.1f} BPM...")
        self.client.send_message("/live/song/set/tempo", [float(bpm)])
    def fire_clip(self, track_index: int, clip_index: int):
        print(f"Firing Clip: Track {track_index}, Slot {clip_index}...")
        self.client.send_message("/live/clip/fire", [track_index, clip_index])
    def set_track_volume(self, track_index: int, volume: float):
        # volume: 0.0 to 1.0 (0.85 is ~0dB unity gain)
        print(f"Setting Track {track_index} Volume to {volume:.2f}...")
        self.client.send_message("/live/track/set/volume", [track_index, float(volume)])
    def trigger_scene(self, scene_index: int):
        print(f"Triggering Scene {scene_index}...")
        self.client.send_message("/live/scene/fire", [scene_index])
if __name__ == "__main__":
    ctl = AbletonController()
    
    # Example performance sequence
    ctl.set_tempo(124.0)
    ctl.set_track_volume(track_index=0, volume=0.85) # Track 1 Unity Gain
    ctl.fire_clip(track_index=0, clip_index=0)        # Fire Clip 1 on Track 1
    
    time.sleep(2.0)
    ctl.trigger_scene(scene_index=1)                  # Launch Scene 2
    print("✅ Performance sequence dispatched successfully.")

# 1. Launch Ableton Live with Specific Project File (.als)
"C:\ProgramData\Ableton\Live 12\Program\Ableton Live 12.exe" "C:\Projects\Track01.als"
 
# 2. Configure Diagnostic Event Logging in Options.txt (Windows)
# Create: %APPDATA%\Ableton\Live 12\Preferences\Options.txt
# Add:
# -EnableEventLogging
# -LogFileProcessEvents
# -PluginAutoPopulateThreshold=128