# Настройки

> Подключение к OBS, сеть и удалённые устройства, аккаунты Twitch и папки с данными.

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


Открой **⚙ Settings** в шапке редактора. В окне четыре вкладки; **Save** применяет изменения, всё хранится в `config.json`.

![Окно настроек с вертикальными вкладками](/overlaycomposer/img/settings.png)

## OBS

Подключение через obs-websocket, адрес для Browser Source и импорт сцен из OBS. См. [Подключение к OBS](../obs-setup/).

## Network

- **Listen on** и **Port**: по умолчанию `127.0.0.1:8000`, доступно только с этого компьютера. Применяется после перезапуска.
- **Log proxy traffic** выводит каждый запрос через прокси в консоль сервера (и лог). Включай, только пока отлаживаешь виджет, который не реагирует.

### Удалённые устройства (планшет, телефон)

С этого компьютера (`127.0.0.1`) редактор и оверлей открываются без входа. Чтобы зайти с другого устройства:

1. Выбери **Listen on: All network interfaces**, сохрани и перезапусти программу.
2. Открой **Settings → Network → Remote devices**. Там 6-буквенный код, скрытый как `••••••`, пока не нажмёшь на него. Код одноразовый и меняется каждую минуту.
3. На другом устройстве открой `http://<IP компьютера>:<порт>/pair` и введи код. Устройство получит постоянный токен (cookie) и появится в списке, откуда его можно **Revoke**.

Код и список устройств видны только на самом компьютере. Подбор ограничен 5 попытками с одного адреса, затем блокировка на 5 минут. Соединение идёт по обычному HTTP, поэтому пользуйся им только в доверенной сети. Запросы с заголовками `X-Forwarded-*` (за обратным прокси или туннелем) считаются внешними и тоже требуют токен.

Страница сопряжения может сразу отправить устройство в [Deck](../deck/): `/pair?next=/deck`.

### Изоляция сайтов через прокси

Сайты, открытые через прокси, — чужой код. Поэтому прокси слушает **отдельный порт** (`port + 1`, например 8001), и такие страницы не могут обратиться к API программы. Держи этот порт свободным; изменить можно полем `"proxyPort"` в `config.json`, значение `-1` отключает изоляцию (только если какой-то виджет с ней не работает).

## Twitch

Аккаунты нужны плагинам, которые читают чат и пишут в него, и для наград за баллы канала. Доступно только с этого компьютера.

1. Создай приложение на `dev.twitch.tv/console`: **Client Type: Confidential**, добавь OAuth Redirect URL из настроек (`http://localhost:<порт>/auth/twitch/callback`).
2. Введи Client ID и Client Secret, **Save application**. Смена Client ID отключает аккаунты.
3. Нажми значок копирования рядом с **Streamer** (владелец канала) или **Bot** (необязательный аккаунт, который пишет в чат). Ссылка авторизации попадёт в буфер обмена и действует 10 минут; открой её в браузере, где выполнен вход в нужный аккаунт Twitch (для второго аккаунта подойдёт приватное окно).

Запрашиваются права `chat:read` и `chat:edit`, а для стримера ещё `channel:read:redemptions` и `channel:manage:redemptions`. Если аккаунт подключён раньше, центр уведомлений предложит переподключить его.

Токены и Client Secret хранятся зашифрованными только на этом компьютере, обновляются автоматически и никогда не передаются ни редактору, ни плагинам. **Disconnect** забывает аккаунт и отзывает токен.

## Application

Версия, пути к папкам данных и логов (кнопки открывают их), **Start with the system** и **Quit Overlay Composer**.

| ОС | Конфиг | Данные и логи |
|---|---|---|
| Windows | `%APPDATA%\OverlayComposer\config.json` (+ `secret.key`) | `%APPDATA%\OverlayComposer\data`, `plugins`, `logs` |
| Linux | `~/.config/overlay-composer/config.json` | `~/.local/share/overlay-composer/{data,plugins,logs}` |
| macOS | `~/Library/Application Support/OverlayComposer` | та же папка |

Флаги запуска: `--home DIR` (переносимый режим: конфиг, данные и логи в DIR), `--autostart`, `--no-open`, `--no-tray`, `--version`.

### Секреты

Токены Twitch, Client Secret, пароль obs-websocket и ключ подписи устройств хранятся зашифрованными (AES-256-GCM). Ключ — файл `secret.key` рядом с `config.json`; в Windows он дополнительно защищён DPAPI. Это защищает от утечки папки данных или копии без ключа, но не от вредоносной программы, запущенной от твоего пользователя. **Чтобы сделать копию или перенести программу, копируй `config.json` вместе с `secret.key`.** Если ключ потерян, программа запустится, но аккаунты Twitch и сопряжённые устройства придётся подключать заново.

### Обновления

Релизная сборка проверяет новую версию через 10 секунд после запуска (не чаще раза в 6 часов) и показывает её в меню трея и в Settings; сама файл не заменяет. Отключается параметром `"noUpdateCheck": true` в `config.json`. Обновления плагинов появляются в центре уведомлений (колокольчик), где также написано, что делать после обновления.

