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