Проблема
Оверлей для OBS обычно разрастается так. Алерты, чат, цель доната, key overlay, виджет «сейчас играет»: каждый из них — отдельный Browser Source. Потом появляется вторая сцена, третья, и те же источники копируются в каждую с другими позициями.
- Десяток источников в каждой сцене. Чтобы подвинуть один виджет, нужно открыть дюжину сцен и поправить одно и то же в каждой. Новый виджет приходится добавлять везде вручную.
- Виджеты перезагружаются при смене сцены. Чат, алерты или цель, которые перезапускаются при каждом переключении, теряют состояние, а каждый источник — ещё одна страница, которую OBS обязан держать.
- Нет общей картины. Позиции лежат в OBS числами на отдельных источниках; чтобы увидеть, как выглядит сцена, нужно на неё переключиться.
- Встраивание работает не всегда. Некоторые сайты виджетов запрещают показывать себя внутри другой страницы, а локальные программы (tosu и подобные) не любят запросов из песочницы.
- Ничего не переиспользуется. Маленький виджет, который читает чат Twitch или принимает награды за баллы, — это отдельная программа, скрипт и токен, за которыми нужно следить.
OverlayComposer сделан, чтобы убрать всё это: один Browser Source в OBS, а остальное расставляется в визуальном редакторе. У каждой сцены OBS свой макет, а виджеты остаются живыми при переключении сцен.
Редактор: макеты и слои слева, холст посередине, свойства выбранного слоя справа.
Низкий порог входа: приезжай со своими сценами
Ничего не нужно собирать заново. Подключи obs-websocket, нажми Import from OBS, и готовая сцена станет макетом: каждый Browser Source превращается в слой с теми же размером, положением, поворотом и порядком, включая группы и вложенные сцены. Дальше заменяешь десяток источников в OBS одним /overlay — и всё, за минуты, а не за вечер.
С Twitch так же просто: нажми Connect, подтверди код на twitch.tv/activate — и аккаунт стримера (или бота) подключён. Своё приложение Twitch создавать не нужно, Client ID и Secret копировать не нужно.
Один источник, макет на каждую сцену
Добавь http://127.0.0.1:8000/overlay в сцены одним Browser Source. OverlayComposer следит за активной сценой OBS и показывает подходящий макет; сцена без своего макета показывает макет по умолчанию.

- Макет — набор слоёв на холсте (по умолчанию 1920 × 1080). Один макет может обслуживать несколько сцен, а макет по умолчанию покрывает остальные.
- Связанные копии: положи один и тот же виджет в несколько макетов так, чтобы при смене сцены он переезжал, а не перезагружался. Алерты и чат сохраняют состояние.
- Подключи obs-websocket, и программа знает все сцены и текущую. Import from OBS превращает готовую сцену в макет: каждый Browser Source становится слоем с теми же размером, положением, поворотом и порядком, включая группы и вложенные сцены.

Редактор, в котором приятно работать
Перемещение, размер, поворот, обрезка (зажми Alt и тащи ручку, как в OBS), прозрачность, масштаб. Snap выравнивает края и центры розовыми направляющими, режим компоновки рисует пунктирные рамки вокруг прозрачных виджетов, отмена и возврат помнят историю даже после сохранения, Alt+клик выбирает слой под другим, стрелки сдвигают. Настройки открываются в окне с вертикальными вкладками: OBS, Network, Twitch, Application.
Режим прокси для упрямых виджетов
Некоторые сайты виджетов запрещают встраивание в другую страницу. Для такого источника отметь Load via server proxy: программа откроет страницу через себя и уберёт запрещающие заголовки. Через прокси работают HTTP, WebSocket и long-poll.
Чужие страницы — чужой код, поэтому прокси работает на отдельном порту (port + 1). Для браузера это другой origin, и такая страница не достанет до API программы. Если что-то не работает, Log proxy traffic покажет, что видит прокси, с замаскированными токенами.
Виджеты
Виджет добавляется через + Add Source тремя способами:
- Веб-страница по адресу: тот же адрес, что ты дал бы Browser Source в OBS (с описанным выше режимом прокси).
- Локальный HTML-файл или папка: программа оборачивает их в плагин без разрешений.
- Плагин из магазина плагинов: по умолчанию compico/oc-plugins, любой репозиторий GitHub, теги и коммиты для фиксации версии, приватные репозитории по токену.
Плагины защищены там, где это важно. Виджет живёт в изолированном iframe без доступа к программе. Всё, что он умеет, он делает через разрешения, которые выдаёшь ты и которые можно отозвать (читать чат, писать в чат, хранилище, запросы к локальным программам). Магазин показывает версию, разрешения и точный коммит до установки и откажется ставить, если файлы изменились после того, как ты их увидел. Обновления плагинов и заметки о миграции приходят в центр уведомлений.
Виджет чата Twitch встроен, так что с него можно начать.
Автономные плагины (WebAssembly)
Некоторые задачи — не виджеты: принять награду за баллы канала, вести очередь, запустить таймер, сделать HTTP-запрос, написать в чат. Они должны работать независимо от того, открыта ли страница. Для этого есть автономные плагины: один файл .wasm, который работает внутри программы и написан на Go (Rust и другие — через тот же ABI).
music — плагин заявок на треки за баллы канала: награда, плеер, очередь заявок и бан-лист. Это один файл .wasm с собственными виджетами и этой страницей.
- Награды за баллы канала Twitch (EventSub включается сам), с выполнением и отменой (баллы возвращаются).
- Сообщения бота в чат, с лимитами на стороне хоста, чтобы плагин не мог спамить.
- Хранилище, таймеры, исходящие HTTP-запросы (никогда в твою локальную сеть).
- События для виджетов, аддонов и Deck по WebSocket, с сохранением последнего значения для новых подписчиков.
- Упавший плагин перезапускается, а пять сбоев за минуту останавливают его до ручного перезапуска.
Руководство Разработка плагинов объясняет всё на примерах на Go; его же можно отдать ИИ-агенту как сырой Markdown.
Deck: панель управления для планшета
Старый iPad в углу стола становится пультом для стрима. Deck — страница с большими плитками в стиле Metro; касание переключает сцену OBS. Работает даже в Safari 9.

- Квадратные плитки в 4 ряда, размеры 1×1, 2×1, 3×1 и 2×3, группы с заголовками и горизонтальная прокрутка, как на начальном экране Windows 8. Выглядит одинаково в любой ориентации.
- Для опасных сцен есть Ask for a second tap: случайное касание не оборвёт эфир.
- Безопасность: касание передаёт только id плитки, действие берётся из сохранённой на сервере раскладки, частота нажатий ограничена. Устройство должно быть сопряжено.
Раскладка собирается в редакторе Deck: группы и плитки, перетаскивание (в том числе между группами), название, сцена, цвет, значок и размер каждой плитки.

И ещё
- Другие устройства: редактор открывается с ноутбука или планшета; код сопряжения одноразовый и меняется каждую минуту; сопряжённые устройства можно отозвать.
- Аккаунты Twitch: стример и бот, подключаются по коду без собственного приложения Twitch; токены не покидают компьютер и никогда не передаются плагинам.
- Секреты зашифрованы (AES-256-GCM, DPAPI в Windows). Копируй
config.jsonвместе сsecret.key. - Трей, автозапуск, переносимый режим (
--home), сборки для Windows и Linux, проверка новых версий без самостоятельной замены файлов и центр уведомлений. - Страница отладки
/overlay?debug=1, читаемые логи и подсказка про просадки FPS при запущенной игре (цифры покажет плагин fps-meter).
Что дальше
В Deck появятся действия плагинов (пауза, пропуск и бан для плагина музыки, плитка «сейчас играет») и состояние по WebSocket вместо опроса. SDK для Rust для автономных плагинов запланирован.
Скачать на GitHub Releases · Документация · Сообщить о проблеме