# Решение проблем

> Проверки для частых проблем с оверлеем, OBS, Deck и плагинами.

Source: https://compico.github.io/ru/overlaycomposer/docs/troubleshooting/
Translation (English): https://compico.github.io/overlaycomposer/docs/troubleshooting/


## Оверлей не виден в 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](../obs-setup/). Проверь **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** сохранено и программа перезапущена, устройство сопряжено ([Настройки](../settings/)), а порт открыт в брандмауэре. Порт прокси (`port + 1`) тоже должен быть свободен. `/deck/probe` — страница совместимости: она показывает, что умеет старый браузер и подключается ли тестовый WebSocket.

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

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

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

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

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

Создай issue в [репозитории OverlayComposer](https://github.com/compico/overlaycomposer/issues). Перед отправкой логов убери токены, приватные адреса и другие секреты.

