tags:
- zwook
- documentation
- ableton
Zwook Live Kit
Один пакет для продюсера: установка AbletonMCP Remote Script (с GitHub, без поиска папок внутри Live) + подключение к Telegram-боту (релей — без SSH, Taiga #72).
Быстрый старт (студенты)
npx @zwook/live-kit install
# Live → Settings (Preferences) → Link, Tempo & MIDI → Control Surface: AbletonMCP
# Код — из Telegram: /live connect
npx @zwook/live-kit connect # спросит код
# Дальше — просто:
npx @zwook/live-kit connect
# В Telegram: live status
Инструкция: https://mcp.sonicum.com
Или двойной клик:
- Mac:
mac/Zwook Live — Install.command, затемmac/Zwook Live — Connect.command… (на Mac студенты подключаются черезnpx @zwook/live-kit connectв Терминале) - Windows:
windows/Zwook Live — Install.cmd, затемwindows/Zwook Live — Connect.cmd(код спросит в окне)
Windows
Полностью поддерживается: install находит %APPDATA%\Ableton\Live *\Preferences\User Remote Scripts, connect/start/status работают как на Mac. Отличия:
- Установка:
windows/Zwook Live — Install.cmd(двойной клик) илиnpx @zwook/live-kit install - Настройка Live: Options → Preferences (в Live 12 — Settings) → Link, Tempo & MIDI → Control Surface AbletonMCP
- Подключение:
windows/Zwook Live — Connect.cmd(спросит код из/live connect; при повторном запуске достаточно Enter) tunnel(SSH) требует включённого OpenSSH-клиента Windows — но студентам он не нужен
Команды
| Команда | Действие |
|---|---|
install | Скачивает __init__.py с ahujasid/ableton-mcp во все найденные User Remote Scripts |
paths | Показывает пути Ableton (диагностика) |
connect --code XXXX-XXXX | Первое подключение: меняет код из /live connect на токен устройства (сохраняется в ~/.zwook-live/credentials.json) |
connect | Повторное подключение к релею (без флагов, creds из файла; автопереподключение) |
start | Локальный HTTP bridge 127.0.0.1:9878 → Live TCP 9877 (для SSH-пути мейнтейнера) |
tunnel | SSH reverse tunnel на сервер (только мейнтейнеры) |
status | Проверка Live + bridge |
connect держит соединение и переподключается сам. Коды выдаёт бот (/live connect), устройства хранятся на сервере — новый enrollment перепривязывает устройство и отключает старое.
Куда ставится Remote Script
Автоматически в User Library → Remote Scripts (так Live 10+ ищет пользовательские скрипты):
- macOS:
~/Music/Ableton/User Library/Remote Scripts/AbletonMCP/__init__.py - Windows:
%USERPROFILE%\\Documents\\Ableton\\User Library\\Remote Scripts\\AbletonMCP\\
Если User Library ещё нет (Live ни разу не открывали), install падает обратно на старые папки ~/Library/Preferences/Ableton/Live <версия>/User Remote Scripts (macOS) или %APPDATA%\\Ableton\\Live <версия>\\Preferences\\User Remote Scripts (Windows) — Live 10+ их игнорирует, поэтому сначала откройте Live один раз и повторите install.
Не нужно лезть в Applications/Ableton Live.app/Contents/... (это сбрасывается при обновлении).
Требования
- Node.js 20+
- Ableton Live 10+
- Ableton открыт хотя бы раз (чтобы создались папки Preferences)
Публикация (будущее)
cd packages/zwook-live-kit
npm publish --access public
# у тестера:
npx @zwook/live-kit install
Лицензия upstream
Remote Script — ableton-mcp (MIT). Zwook Live Kit — обёртка установки и bridge.