MIDI + OBS + Claude Code: за 3 часа от идеи до решения

Сережа Рис · 11 January 2026

У меня лежал Arturia MiniLab 3. Использовал только для музыки.

Подумал — почему бы не переключать им сцены в OBS во время стримов?

Три часа с Claude Code. Результат: пэды переключают сцены, активная сцена подсвечивается.

Задача

Хотел простую вещь: нажимаю Pad 1 — включается сцена “Десктоп”. Pad 2 — камера. Pad 3 — телефон. Без мыши, без горячих клавиш.

Бонус: чтобы пэд активной сцены светился зелёным. Раньше переключался мышкой во время стрима — терял фокус, пару раз нажимал не туда. С пэдами переключаюсь вслепую.

Хронология

0:00 — Описал задачу Claude Code. Он провёл исследование через Exa, нашёл obs-midi-mg как лучший вариант для macOS.

0:15 — Плагин установлен. Устройство видит. Создал биндинг через UI — не работает.

0:30 — Claude Code предложил поставить MIDI Monitor. Оказалось — пэды отправляют разную velocity при каждом ударе.

0:45 — Нашли решение: velocity ignore mode. Дважды кликнуть на “Velocity” в настройках биндинга. Заработало.

1:00 — Попросил добавить третий пэд программно. Claude Code прочитал JSON-конфиг, добавил биндинг, перезапустил OBS.

1:30 — Захотел LED-индикатор. Claude Code нашёл SysEx-коды для MiniLab 3, написал Python-скрипт.

2:00 — Светятся не пэды, а кнопки Shift/Hold. Оказалось — пэды начинаются с индекса 4, не 0. Исправили.

2:30 — Индикатор работает, но иногда пропускает. Переписали с polling на EventClient. Мгновенная реакция.

3:00 — Не получает события. Оказалось — в obsws-python callback должен называться on_current_program_scene_changed. Исправили. Работает.

Главные грабли

1. Velocity

Пэды MiniLab чувствительны к силе удара. Каждое нажатие — разное значение: 21, 45, 67. Плагин записывает конкретное значение при настройке. Ударил чуть сильнее — биндинг молчит.

В JSON это выглядит так:

"velocity": {"state": 2, "index": 0, "min": 0, "max": 127}

state: 2 — игнорировать. state: 0 — фиксированное значение.

2. LED индексы MiniLab 3

Отправил цвет на индекс 0 — загорелась кнопка Shift. Индекс 1 — Oct-. Индекс 2 — Hold.

Пэды начинаются с индекса 4:

3. obsws-python callback naming

Написал функцию _on_scene_change. EventClient её игнорирует. Никаких ошибок, просто молчит.

Роль Claude Code

Я не писал ни строчки кода. Вот что делал Claude Code:

• Исследование — нашёл obs-midi-mg через Exa, сравнил с альтернативами
• Установка прошла быстро: pkg, установщик, готово
• С диагностикой повозились: MIDI Monitor показал проблему с velocity
• Конфигурация — JSON напрямую, без UI
• Python-скрипт для LED индикатора — с нуля
• Отладка: индексы пэдов оказались не 0-7, а 4-11
• Всё задокументировал в правила для следующих сессий

Это и есть вайбкодинг: описываешь что хочешь, агент делает.

Итоговый стек

Код индикатора

Ключевые части:

def set_pad_color(led_index, r, g, b):
    # F0 00 20 6B 7F 42 02 02 16 [led] [r] [g] [b] F7
    data = [0x00, 0x20, 0x6B, 0x7F, 0x42,
            0x02, 0x02, 0x16, led_index, r, g, b]
    port.send(mido.Message('sysex', data=data))

## Имя функции ДОЛЖНО соответствовать событию
def on_current_program_scene_changed(self, data):
    scene_name = data.scene_name
    self._update_pads(scene_name)

Запуск

## Установка
cd ~/Documents/GitHub/obs-midi
uv venv && uv pip install -r requirements.txt

## Тесты
source .venv/bin/activate
python scene_indicator.py --test

## Запуск
python scene_indicator.py

Не забудь включить OBS WebSocket: Tools → WebSocket Server Settings → Enable.

Установка obs-midi-mg

curl -LO "https://github.com/nhielost/obs-midi-mg/releases/download/3.1.1/obs-midi-mg-3.1.1-macos-universal.pkg"
open obs-midi-mg-*.pkg

После установки: OBS → Tools → obs-midi-mg. Выбираешь устройство, жмёшь Connect.

Настройка obs-midi-mg через JSON

Настраивать через UI долго. Каждый пэд — отдельный биндинг. Можно редактировать JSON напрямую.

Конфиг лежит тут:

~/Library/Application Support/obs-studio/plugin_config/obs-midi-mg/obs-midi-mg-config.json

Сначала нужны UUID сцен:

cat ~/Library/Application\ Support/obs-studio/basic/scenes/*.json | \
python3 -c "import sys,json; d=json.load(sys.stdin); \
[print(f'{s[\"name\"]}: {s[\"uuid\"]}') for s in d.get('sources',[]) \
if s.get('versioned_id')=='scene']"

Структура биндинга:

{
  "name": "Pad 1 → Desktop",
  "enabled": true,
  "type": 0,
  "messages": [{
    "device": "Minilab3 MIDI",
    "channel": {"state": 0, "value": 10},
    "note": {"state": 0, "value": 36},
    "velocity": {"state": 2, "index": 0, "min": 0, "max": 127}
  }],
  "actions": [{
    "id": 4353,
    "scene": {"state": 0, "value": "UUID-СЦЕНЫ"}
  }]
}

Channel 10 — стандарт для пэдов MiniLab. Note 36 — первый пэд. Каждый следующий +1.

MiniLab 3: режимы

У MiniLab три режима работы. Переключение: Shift + пэд 1/2/3.

Для OBS нужен User mode. В DAW mode пэды отправляют другие сообщения.

Выводы

Три часа — от “хочу переключать сцены пэдами” до работающего решения с LED-индикатором. Без написания кода вручную.

Claude Code не просто генерирует код — он ставит MIDI Monitor, читает логи, правит конфиг. Я описывал проблему (“не работает”), он находил причину и исправлял.

Смотри также

• Claude Code — напарник, Codex — исполнитель — чем Claude Code отличается от других агентов при отладке таких задач
• Software for One: софт, который нужен только тебе — MIDI-контроллер для OBS — хороший пример инструмента, который нужен только тебе

Источники

• obs-midi-mg на GitHub
• obs-midi-mg на OBS Forum
• Документация плагина
• MIDI Monitor для macOS
• obsws-python — WebSocket клиент
• MiniLab 3 SysEx коды
• Axios: Claude Code и вайбкодинг
• The Vibe Coding Stack for 2026

Об авторе

Подписаться на обновления — @sereja_tech