Документация Twitch TTS

Быстрый старт

Чтобы озвучка заработала, нужны три вещи: токен /N/TTS, имя вашего канала и пара кликов.

1. Получите токен /N/TTS Откройте профиль на сайте /N/TTS (вход там выполняется через Discord) и скопируйте личный API-токен.
2. Вставьте токен Нажмите чип Токен не задан в шапке, вставьте токен в поле и нажмите «Сохранить токен». Чип станет зелёным: Токен ✓.
3. Подключитесь к каналу Введите имя канала Twitch (без #) и нажмите «Подключиться». В плитке «Статус» загорится «Подключено».
4. Включите озвучку Нажмите Все пользователи, чтобы озвучивались все сообщения чата, либо оставьте выключенным и разрешите зрителям команду !tts (см. «Доступ к командам»).

Токен и подключение

Для чего нужен токен

Токен выдаёт сервис /N/TTS. Он нужен для всего, что создаёт звук или меняет ваши данные:

Состояния чипа токена

• Токен не задан — озвучка работать не будет, пока вы его не введёте.
• Токен ✓ — токен сохранён в этом браузере.
• Токен отклонён — сервер ответил ошибкой 401: токен неверный или истёк. Очередь остановлена, новые запросы не отправляются, пока вы не сохраните другой токен.

Куда уходят данные

Токен хранится только в вашем браузере (localStorage) и отправляется только на API озвучки в заголовке Authorization. Подробнее — в разделе «Данные и приватность».

Подключение к каналу

Введите имя канала и нажмите «Подключиться» (или Enter в поле). Последний канал запоминается. Состояния подключения:

• серый — ожидание или отключено;
• жёлтый — идёт подключение;
• зелёный — подключено, сообщения читаются;
• красный — ошибка чата, проверьте имя канала и интернет.

Чтобы подключаться автоматически при открытии страницы, см. «OBS и автоподключение».

Обзор интерфейса

На экранах уже 900 px три панели превращаются во вкладки «Голоса / Зрители / История», а шапка перестаёт закрепляться.

Бейджи доступа

Показывают, кому из зрителей сейчас разрешены команды !tts и !s: VIP: открыт All: закрыт. Управляются командами !open / !close.

Голоса

Голоса сгруппированы по категориям (игры, фильмы, стримеры и т. д.). Свои голоса всегда закреплены сверху в категории «Мои голоса». Остальные категории свёрнуты — раскрытое состояние запоминается.

• Поиск работает по названию, ID, категории и описанию; во время поиска все подходящие категории раскрыты.
• Описание голоса появляется во всплывающей подсказке при наведении на строку.
• ID голоса — клик по нему копирует идентификатор (он нужен для команды !s).
• Предпрослушка ▶ озвучивает фразу «так звучит мой голос» с текущими громкостью и эффектом. Нужен токен.

Свои голоса

Вы можете создать голос по образцу записи. Кнопка «Добавить свой голос» открывает форму:

1. Имя голосаЛюбое название для себя. Из него автоматически подставляется ID: кириллица транслитерируется («Мой Голос» → moy_golos).
2. ID голосаИменно он отправляется на сервер как speaker_name. Допустимы латиница, цифры и _. Поле можно править вручную: после первой правки автоподстановка из имени прекращается.
3. АудиофайлОбразец голоса. Требования к длительности и формату определяет сервис /N/TTS; если файл не подошёл, страница покажет ответ сервера.

• Если ID уже занят (встроенным или вашим голосом), поле сообщает об этом сразу, и отправка блокируется — раньше такой голос загружался и пропадал из списка.
• После загрузки список обновляется, голос появляется в «Мои голоса» с кнопкой удаления. Удаление необратимо и требует подтверждения.
• Свои голоса привязаны к токену и доступны с любого устройства, где введён тот же токен.

Голоса зрителей

У каждого зрителя свой голос. Когда его сообщение озвучивается впервые, голос выбирается случайно и запоминается, поэтому он не меняется от сообщения к сообщению.

Как сменить голос зрителю

• В колонке «Зрители» нажмите кнопку с названием голоса (или «Назначить голос»), найдите голос и выберите его. Пункт «— без голоса —» сбрасывает назначение, голос снова будет выбран случайно.
• Зритель сам пишет !s id_голоса, если у него есть доступ к командам.
• Модератор пишет !s ник id_голоса.

Кнопка игнора

Значок динамика в строке зрителя добавляет его в список игнорируемых: его сообщения и команды больше не обрабатываются. Он остаётся в списке зачёркнутым, чтобы вы могли вернуть его в один клик. Стримера игнорировать нельзя.

История озвученных сообщений

В панель попадают последние 50 сообщений, которые начали звучать: время, зритель, голос и текст. Кнопка со стрелкой ставит сообщение в очередь ещё раз (повтор помечается «повтор» и проходит без фильтров). Кнопка с корзиной очищает историю.

История хранится только в памяти страницы и пропадает при перезагрузке.

Команды чата

Нажмите значок копирования, чтобы скопировать команду.

Зрителям (если им открыт доступ)

Модераторам и стримеру: авто-озвучка

Модераторам и стримеру: доступ и голоса

Доступ к командам

Команды !tts и !s проверяют права по порядку:

1. Стример и модераторы — всегда можно.
2. Зритель, которому написали !close ник — нельзя, даже если открыто для всех.
3. Если открыто для всех (!open all) — можно.
4. VIP при открытом для VIP — можно.
5. Зритель, которому написали !open ник — можно.
6. Иначе — нельзя, команда молча игнорируется.

Авто-озвучка

Автоматическая озвучка читает обычные сообщения, без команд. Она включается кнопками в строке управления или командами из раздела выше:

Персональные правила сильнее групп: !tts on ник озвучивает зрителя даже при выключенной группе, а !tts off ник отключает ему автоматическую озвучку (команда !tts у него при этом работает по правилам доступа). Количество персональных правил показано рядом с кнопками: «Включено вручную / Отключено вручную».

Включённые группы и персональные списки запоминаются между сеансами.

Рандомная озвучка

Команда !tts random n включает режим, в котором озвучиваются случайные сообщения тех зрителей, которым авто-озвучка не включена. Это удобно, чтобы «подсвечивать» живой чат, не читая его целиком.

1. С момента включения страница копит сообщения в пул (до 100 штук).
2. Каждые n секунд (минимум 1) из накопленных выбирается одно случайное сообщение и ставится в очередь.
3. После выбора пул очищается — копить начинается заново.

Сообщения зрителей с включённой авто-озвучкой в пул не попадают (иначе они прозвучали бы дважды). К рандому применяются анти-спам и ограничение очереди; лимит на одного зрителя не применяется. Режим не сохраняется между перезагрузками.

Настройки: озвучка

Открываются кнопкой «Настройки» в шапке. Все изменения сохраняются сразу.

Эффекты голоса

Список загружается с сервера, поэтому он всегда актуален:

Настройки: фильтры чата

Как обрабатывается сообщение

Порядок важен: он объясняет, почему то или иное сообщение не прозвучало.

1. Боты и игнор. Известные боты (если фильтр включён) и игнорируемые зрители отбрасываются.
2. Подходит ли сообщение. Оно должно попасть под авто-озвучку (группа или персональное правило) либо под random. Иначе оно игнорируется.
3. Очистка текста: смайлы → ссылки и адреса сайтов → @упоминания → повторы → лишние пробелы.
4. Пустое после очистки или начинающееся с ! — пропускается.
5. Длина больше лимита — пропускается.
6. Запрещённые слова — пропускается.
7. Очередь уже содержит 100 сообщений — пропускается.
8. Авто-озвучка: анти-спам → лимит на зрителя → проверка токена → голос зрителя → в очередь.
   Для остальных при включённом random сообщение попадает в пул для случайного выбора.

Для команды !tts порядок почти тот же: шаг 1 действует так же, вместо шага 2 проверяются права доступа (стример и модераторы проходят всегда), анти-спам не применяется, а лимит на одного зрителя — применяется.

Очередь, паузы и ошибки

• Сообщения озвучиваются по одному, в порядке поступления; в очереди помещается до 100.
• Скип прерывает текущее сообщение и сразу запускает следующее. Если сейчас пауза между сообщениями, «Скип» пропускает паузу.
• Очистить очередь останавливает звук и удаляет всё ожидающее (то же делает !tts clear).

Что происходит при ошибках

Уведомления об ошибках исчезают через 7 секунд или по кнопке закрытия.

OBS и автоподключение

Чтобы страница подключалась к каналу сама, включите «Подключаться к каналу при открытии страницы» в настройках либо задайте параметры в адресе:

Токен через адрес не передаётся, это небезопасно.

Использование в OBS

• Добавьте страницу как источник «Браузер» (или как пользовательскую док-панель браузера).
• Чтобы озвучка шла отдельной дорожкой в аудиомикшере, в свойствах источника «Браузер» включите «Управлять звуком через OBS».
• В обычной вкладке или доке звук воспроизводится на системное устройство вывода, как у любой веб-страницы.

Резервная копия

Раздел «Резервная копия» в настройках сохраняет и загружает JSON-файл. Он нужен, чтобы перенести настройки на другой компьютер или браузер либо не потерять их при очистке данных.

Импорт заменяет текущие настройки и голоса после подтверждения. Некорректные значения в файле отбрасываются или приводятся к допустимым, повреждённый файл страница не применяет.

Данные и приватность

Что и где хранится

Куда отправляются запросы

• Чат Twitch — анонимное подключение только на чтение. Библиотека ComfyJS (версия 1.1.29) загружается с cdn.jsdelivr.net и защищена контрольной суммой (SRI).
• API озвучки /N/TTS — через зеркало nttsfuckrkn.fdev.team (основной домен может быть недоступен из-за блокировок). Туда уходят текст озвучиваемого сообщения, ID голоса, выбранный эффект и ваш токен в заголовке.

Больше страница никуда ничего не отправляет: собственного сервера у неё нет.

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

Сообщения не озвучиваются

Пройдите по списку сверху вниз:

1. Статус «Подключено», канал указан верно.
2. Чип токена зелёный Токен ✓.
3. В колонке «Голоса» отображается число голосов (они загрузились).
4. Включена нужная группа авто-озвучки (Vip / Mods / Все) или зрителю открыт доступ к !tts.
5. Сообщение не отсеяно: лимит символов, запрещённые слова, анти-спам, лимит на зрителя, игнор зрителя или бота, сообщение из одних смайлов и ссылок. См. «Как обрабатывается сообщение».
6. Плитка «В очереди» показывает число > 0, но звука нет — проверьте автовоспроизведение (ниже) и громкость.

«Кликните в любом месте страницы…»

Браузер не разрешает звук, пока вы не взаимодействовали со страницей. Кликните по странице или нажмите любую клавишу: сообщение, которое ждало, начнёт звучать. В источнике OBS обычно это не требуется.

«Сервер отклонил токен (401)»

Токен неверный или истёк. Скопируйте актуальный из профиля /N/TTS и сохраните его в настройках: очередь запустится заново.

Голоса не загрузились

Нажмите «Повторить». Если не помогло, проверьте интернет, VPN и блокировщики для nttsfuckrkn.fdev.team, а также попробуйте ввести токен в настройках: запрос с токеном может пройти, даже если анонимный не проходит.

Настройки пропали на другом компьютере или в OBS

Настройки хранятся в конкретном браузере. Перенесите их через «Резервную копию».

Зрителя не видно в списке или у нескольких зрителей один голос

Известное ограничение: ключом зрителя служит имя, очищенное до латиницы, цифр и _. Если отображаемое имя состоит из других символов, оно не распознаётся; если часть — из латиницы или цифр, ключ строится только из них (например, «Игрок123» превращается в «123»).

Читаются смайлы

Сторонние смайлы (7TV, BTTV, FFZ) страница отличить от слов не может. Добавьте их названия в «Запрещённые слова».

API /N/TTS

Страница работает с публичным API сервиса. Полная официальная документация — на ntts.fdev.team/docs. Ниже — что используется страницей.

Токен передаётся в заголовке Authorization: Bearer …. Страница обращается к зеркалу API: в адресах выше основной домен заменён на nttsfuckrkn.fdev.team.

Клавиатура и доступность

Все кнопки и поля имеют подписи для скринридеров, фокус виден, ошибки объявляются автоматически, а контраст текста не ниже 4,5:1. Анимации отключаются, если в системе включено уменьшение движения.

Что нового