Оверлей не виден в OBS

  1. Открой http://127.0.0.1:8000/overlay?debug=1 в браузере или добавь ?debug=1 к адресу Browser Source. Метка в углу покажет состояние WebSocket, макет, число объектов и последнюю ошибку.
  2. Открой ⚙ Settings → Application → Open log folder и прочитай последние строки. client … — то, что сообщил оверлей, http … — что запросил OBS, proxy: … — что ответил сайт через прокси. Если /overlay в логе так и не появился, OBS до сервера не дошёл: проверь адрес и порт.
  3. Частые перезагрузки страницы могут привести к ответу Too Many Requests от сайта виджета: подожди немного.

Чтобы отладить Browser Source в DevTools, запусти OBS с --remote-debugging-port=9222 --remote-allow-origins=http://localhost:9222, затем открой http://localhost:9222/ в Chrome.

Виджет запрещает встраивание

Включи Load via server proxy для этого источника. Если всё равно не работает, включи Settings → Network → Log proxy traffic и пришли лог (токены в нём скрыты).

Список сцен пуст или макет не переключается

Подключи obs-websocket: Подключение к OBS. Проверь Settings → OBS: строка состояния показывает соединение и сколько сцен известно. В OBS включи Инструменты → Настройки WebSocket-сервера → Включить WebSocket-сервер.

Анимированные виджеты тормозят во время игры

Вероятная причина — то, как Windows делит GPU между игрой и браузерным источником OBS. На практике помогало: OBS → Настройки → Дополнительно → отключить Аппаратное ускорение Browser Source и перезапустить OBS. Ещё стоит ограничить FPS игры, поднять приоритет OBS (Настройки → Дополнительно → Приоритет процесса) и выставить OBS «Высокую производительность» в настройках графики Windows. Плагин fps-meter из oc-plugins показывает FPS и время кадра в том же макете, так что цифры видно.

Планшет не открывает редактор или Deck

Проверь, что Listen on: All network interfaces сохранено и программа перезапущена, устройство сопряжено (Настройки), а порт открыт в брандмауэре. Порт прокси (port + 1) тоже должен быть свободен. /deck/probe — страница совместимости: она показывает, что умеет старый браузер и подключается ли тестовый WebSocket.

Deck ничего не делает при касании

В углу страницы виден статус соединения. Касание не сработает, если OBS не подключён или сцены больше нет в OBS (переименуй её в свойствах плитки). Плитке с вторым касанием нужно два касания.

Twitch: плагин не может читать или писать в чат

Открой Settings → Twitch: аккаунт должен быть подключён с перечисленными там правами. После обновления, которое добавляет права, центр уведомлений предлагает переподключить аккаунт. Сообщения, которые пишет chat.send, требуют аккаунт Bot.

Где ещё помогут

Создай issue в репозитории OverlayComposer. Перед отправкой логов убери токены, приватные адреса и другие секреты.