Руководства

Узнайте, как настроить Social Stream Ninja под себя и использовать все его возможности

Источники чата YouTube, Twitch, TikTok и ещё более 100 платформ
Social Stream Ninja Расширение или настольное приложение объединяет все чаты в один сеанс
Док-панель Модерация, показ сообщений и ответы
Оверлей OBS Выбранные сообщения и оповещения в эфире

Один идентификатор сеанса связывает все компоненты: используйте одинаковый ?session= в URL док-панели и оверлея.

Найти руководство

Воспользуйтесь поиском или откройте категорию. Если нужен только чат на экране, начните с OBS.

Начните здесь Установите приложение, подключите чат и добавьте оверлеи в OBS
Проведение трансляцииУправление док-панелью, модерация, ретрансляция и участие зрителей
Оверлеи и оформление Шаблоны, оформление, шрифты и события
Автоматизация и интеграции API, команды, Event Flow и вебхуки
ИИ и озвучивание текста Голосовые соведущие, помощники в браузере, боты, локальные модели и озвучивание
Руководства по платформам TikTok, YouTube, Twitch, Kick и поддерживаемые сайты
Устранение неполадок и поддержка Пропавший чат, пустые оверлеи и подробная справка

Подходящие руководства не найдены.

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

Начало работы (расширение браузера)

1. Установка

Перед использованием Social Stream Ninja его нужно установить. Расширение браузера можно установить несколькими способами:

  • Ручная установка (рекомендуется): Чтобы получить самую свежую версию, установите расширение вручную в режиме разработчика.
  • Chrome Web Store: Для самой простой установки используйте Chrome Web Store.

Подробные инструкции по установке находятся на Страница загрузки.

2. Базовая настройка

После установки выполните следующие действия для начала работы с Social Stream Ninja:

  1. Откройте чат платформы трансляции в браузере или используйте отдельное окно чата, если оно доступно
  2. Нажмите значок расширения Social Stream Ninja на панели браузера
  3. Нажмите «Enable Extension», чтобы включить расширение: значок должен стать зелёным
  4. Откройте ссылку «Dashboard Link» из меню расширения
  5. Откройте «Overlay Link» в OBS как источник «Браузер»

Примечание: При использовании расширения браузера лучше оставлять окна чата видимыми, не сворачивая их.

3. Подключение к разным платформам

Social Stream Ninja работает с более чем 100 платформами. Вот как подключить самые популярные:

YouTube

  • Откройте чат YouTube Live
  • Нажмите «Pop out chat» в правом верхнем углу
  • Убедитесь, что расширение Social Stream Ninja включено: значок зелёный

Twitch

  • Откройте чат своего канала Twitch
  • Нажмите значок шестерёнки и выберите «Pop out chat»
  • Убедитесь, что расширение Social Stream Ninja включено: значок зелёный

Facebook

  • Откройте свою трансляцию Facebook Live как зритель или автор
  • Убедитесь, что подключены по Wi-Fi или Ethernet, а не через мобильный интернет
  • Убедитесь, что расширение Social Stream Ninja включено: значок зелёный

Discord, Slack, WhatsApp и другие.

  • Сначала включите эти платформы переключателем в настройках расширения
  • Откройте веб-версии этих платформ в браузере
  • Убедитесь, что расширение Social Stream Ninja включено: значок зелёный

Настройка внешнего вида (расширение браузера)

Параметры URL

Панель управления и оверлей можно настроить параметрами URL. Несколько примеров:

Параметры панели управления:

&darkmode — включает тёмную тему панели управления
&scale=2 — удваивает размер и разрешение всех элементов
&hidesource — скрывает значки платформ (YouTube, Twitch и других)
&compact — убирает промежуток между именем и сообщением
&inline — размещает сообщение рядом с именем, сохраняя обычные интервалы
&autoshow — автоматически выводит сообщения по мере появления (около двух за три секунды)

Параметры оверлея:

&showtime=20000 — автоматически скрывает выбранные сообщения через 20 секунд
&showsource — показывает значки платформ рядом с именами пользователей
&fade — выбранные сообщения плавно проявляются вместо мгновенного появления
&swipe — выбранные сообщения выезжают слева
¢er — размещает выбранные сообщения в центре экрана

Для удобного управления URL попробуйте наш Редактор параметров URL.

Настройка CSS

Внешний вид можно настроить с помощью CSS несколькими способами:

Способ 1: CSS источника «Браузер» в OBS

В OBS можно добавить собственный CSS к источнику «Браузер»:

  1. Добавьте оверлей как источник «Браузер» в OBS
  2. Включите параметр «Custom CSS»
  3. Введите собственный CSS в текстовое поле
body { background-color: rgba(0, 0, 0, 0); margin: 0px auto; overflow: hidden; }

:root {
    --comment-color: #090;
    --comment-bg-color: #DDD;
    --comment-border-radius: 10px;
    --comment-font-size: 30px;
    --author-border-radius: 10px;
    --author-bg-color: #FF0000;
    --author-avatar-border-color: #FF0000;
    --author-font-size: 32px;
    --author-color: blue;
    --font-family: "Arial", sans-serif;
}

.hl-name {
    padding: 2px 10px !important;
}

Способ 2: настройки меню расширения

Добавьте CSS прямо через меню расширения:

  1. Нажмите значок расширения Social Stream Ninja
  2. Найдите раздел настроек CSS/JavaScript
  3. Введите собственный CSS или JavaScript
  4. CSS добавится к URL в виде данных в кодировке base64

Способ 3: собственные шаблоны

Выберите готовый шаблон со встроенным CSS:

  • Посмотрите наш Галерея шаблонов
  • Выберите шаблон, подходящий стилю вашей трансляции
  • Замените YOURSESSIONID в URL шаблона своим идентификатором сеанса
  • Добавьте URL шаблона как источник «Браузер» в OBS

Пример: https://socialstream.ninja/themes/pretty.html?session=YOURSESSIONID

Разные цвета для имён в чате

Для цветов имён нужны две настройки: общий источник цвета в разделе Сообщение — оформление и переключатель отображения в док-панели в разделе Сообщение — видимость.

Откройте руководство по цветам имён в чате со снимками экрана, вариантами цветов, решениями проблем и примерами CSS.

Самостоятельное размещение шрифтов и оформление

Используйте свои шрифты в dock.html или featured.html без зависимости от Google Fonts или системных шрифтов.

  • Разместите файлы .woff2/.ttf/.otf на сервере и загружайте их с помощью @font-face.
  • Примените CSS через пользовательский CSS в OBS или параметры URL, например &css=, &b64css=, &font=, или &googlefont=.
  • Работает одинаково в расширении Chrome, приложении Electron и размещённых веб-страницах.

Откройте руководство по самостоятельному размещению шрифтов с пошаговыми инструкциями по размещению и примерами CSS.

Расширенные возможности (расширение браузера)

Озвучивание текста

Social Stream Ninja может читать сообщения чата вслух с помощью синтеза речи:

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

  1. Добавить &speech=en-US к URL featured.html или dock.html
  2. Для других языков выберите поддерживающие их провайдера и голос. Например, для португальского можно использовать Piper &pipervoice=pt_BR-faber-medium или eSpeak &espeakvoice=pt-br, а для испанского можно использовать Piper &pipervoice=es_ES-davefx-medium или eSpeak &espeakvoice=es.
  3. Настройте голос с помощью параметров, например &pitch=1&volume=1&rate=1

Бесплатное локальное озвучивание без API-ключа:

  • Kokoro TTS: Встроенный ИИ браузера, отличное качество — &ttsprovider=kokoro
  • Piper TTS: Быстрое и лёгкое нейросетевое озвучивание — &ttsprovider=piper
  • eSpeak-NG: Лёгкий резервный вариант для разных языков, включая португальский &espeakvoice=pt-br и испанский &espeakvoice=es
  • Kitten TTS: Минимальное потребление ресурсов, только процессор — &ttsprovider=kitten
  • Собственный сервер: Запустите Kokoro-FastAPI или openedai-speech локально через Docker — &ttsprovider=openai&openaiendpoint=http://localhost:8880/v1/audio/speech

Платные облачные варианты озвучивания:

  • Google Cloud TTS: Голоса профессионального качества; требуется API-ключ Google
  • ElevenLabs: Очень реалистичные голоса с обучением собственного голоса
  • Speechify: Премиальные голоса с естественным звучанием

Хотите работать локально и приватно? См. Руководство по локальному ИИ-озвучиванию для подробных инструкций, включая собственный сервер и захват звука в OBS.

ИИ-соведущие, чат-боты и помощники в браузере

Social Stream Ninja использует ИИ несколькими способами. Сначала выберите задачу, а затем провайдера.

  • Голосовой соведущий: общайтесь через микрофон, пока вопросы из чата поступают в тот же сеанс соведущего.
  • Помощник ChatGPT в браузере: захватывайте чат или экспериментально передавайте его в открытую chatgpt.com вкладку без API-ключа.
  • Основной чат-бот: отвечают выбранным зрителям в оверлее, голосом или в поддерживаемых чатах.
  • Инструменты обработки: модерация, перевод, сводки, поиск знаний RAG и оверлеи, созданные ИИ.

Выберите вариант настройки ИИ

Очередь и закрепление сообщений

Настройте порядок появления сообщений в оверлее:

Добавление сообщений в очередь:

  1. Удерживайте CTRL (или Cmd на Mac) при выборе сообщений в панели управления
  2. Нажимайте «Next in Queue», чтобы показывать сообщения по одному
  3. Сообщения появятся в оверлее в порядке добавления в очередь

Закрепление сообщений:

  1. Удерживайте ALT при нажатии на сообщение в панели управления
  2. Сообщение останется закреплённым вверху панели управления
  3. Чтобы открепить сообщение, снова нажмите на него, удерживая ALT

Захват событий трансляции

Захватывайте события трансляции помимо чата: новых подписчиков, платные подписки, рейды и пожертвования с ваших платформ.

Как включить:

  1. Нажмите значок расширения Social Stream Ninja
  2. Найдите «Захватывать события трансляции» в настройках
  3. Включите его, чтобы получать оповещения

Примечание: События с пожертвованиями (Super Chat, Bits, чаевые) передаются автоматически независимо от этого переключателя. Он в основном отвечает за оповещения о новых и платных подписчиках.

Захватываемые события по платформам:

YouTube

  • Новые и подарочные платные подписки
  • Повышения уровня и памятные даты платной подписки
  • Пожертвования Super Chat и Super Sticker
  • Число подписчиков и зрителей

Twitch

  • Новые, повторные и подарочные подписки
  • Новые подписчики и их количество
  • Bits/Cheers и активации наград за баллы канала
  • Рейды с числом зрителей

TikTok, Kick и другие

  • Новые подписчики и подарки (TikTok)
  • Подписки и чаевые (Kick)
  • Число зрителей на большинстве платформ

Полный список данных и полей событий приведён в Справочник событий .

Верхняя полоса Hype Train

Показывайте прогресс Twitch Hype Train и Treasure Train в OBS в виде верхней полосы в стиле Twitch.

  • Скопируйте специальную ссылку верхней полосы Hype Train из меню.
  • Перед эфиром проверьте его кнопкой «Fake Hype Train».
  • В руководстве приведены этапы настройки, снимки экрана и решения проблем.

Открыть руководство по верхней полосе Hype Train

Новые участники чата

Выделяйте новых участников чата, добавляйте необязательный значок листочка или звуковой сигнал док-панели только для первого сообщения.

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

Открыть руководство по новым участникам чата

Редактор Event Flow

Редактор Event Flow — мощная система автоматизации на основе узлов для создания собственных процессов. Этот уровень расширенной автоматизации позволяет задавать свою логику маршрутизации.

Что можно делать:

  • Пересылка чата между платформами с умными фильтрами, например передавайте Twitch в Discord, блокируя команды
  • Создание собственных команд с логическими операторами И/ИЛИ/НЕ
  • Запускайте оверлеи и звук по определённым событиям или ключевым словам
  • Управление OBS сценами и источниками автоматически
  • Создавайте розыгрыши призов с управлением очередью

Начало работы:

  1. Откройте редактор Event Flow из главного меню панели управления
  2. Создайте новый поток и добавьте узлы источников, например «Twitch Message»
  3. Подключите логические узлы для фильтрации сообщений: ключевое слово, роль пользователя и другие
  4. Добавьте узлы действий для ответа: отправить сообщение, воспроизвести звук или показать оверлей
  5. Перед эфиром проверьте всё во встроенном симуляторе

Оверлей Flow Actions:

Чтобы работали звук, медиаоверлеи и действия OBS, добавьте страницу Flow Actions как источник «Браузер» в OBS:

  1. В меню найдите раздел «Flow Actions» и скопируйте URL
  2. Добавьте его как источник «Браузер» в OBS (рекомендуется 1920×1080)
  3. Держите оверлей открытым: его можно скрыть, но нельзя закрывать

Важно: Современные действия Relay Chat автоматически пропускают распознанные возвращённые копии сообщений. Используйте Reflection Filter («Фильтр отражений») для управления показом захваченных копий сообщений в док-панели и оверлеях. См. пошаговое руководство по ретрансляции чата для настройки. Подробная документация находится в Руководство по Event Flow. Для звуков или медиа наград Kick используйте Руководство по баллам канала и наградам Kick.

Управление MIDI и сочетаниями клавиш

Управляйте Social Stream Ninja напрямую через Stream Deck, MIDI-контроллеры или горячие клавиши.

Настройка MIDI:

  1. Подключите MIDI-устройство: Stream Deck, MIDI-контроллер или другое
  2. Откройте меню Social Stream Ninja
  3. Найдите раздел настроек MIDI
  4. Выберите MIDI-устройство в раскрывающемся списке
  5. Назначьте MIDI-нотам конкретные действия

Доступные действия:

  • Запускайте собственные оверлеи и медиа
  • Отправляйте заранее заданные сообщения в чат
  • Переключайте сцены OBS
  • Воспроизводите аудиоклипы или озвучивайте текст
  • Запускайте триггеры Event Flow

Совет: MIDI удобен для управления трансляцией без рук. Используйте педаль для запуска оповещений или ручку регулятора для изменения громкости.

Команды бота и автоответы

Создавайте интерактивные команды бота и автоматические ответы для чата.

Встроенные команды:

  • !joke — отправляет случайную шутку в духе гиковского папы
  • !hi — автоматически приветствует зрителей
  • !cycle — позволяет зрителям переключать сцены OBS (с разрешения)

Настройка автоответов:

  1. Откройте меню расширения и найдите раздел бота и автоответов
  2. Включите нужные команды
  3. Чтобы ответы работали, оставляйте окно чата видимым и не сворачивайте его
  4. Убедитесь, что вошли на платформу и можете отправлять сообщения

Создание собственных команд:

Для более сложных команд используйте редактор Event Flow:

  1. Создайте новый поток с источником «Message»
  2. Добавьте узел «Содержит ключевое слово» (Contains Keyword) для распознавания команды, например «!social»
  3. Подключите действие «Send Chat» с текстом ответа
  4. При необходимости добавьте фильтры роли пользователя для команд только модераторов

Требования: Автоответы лучше всего работают в браузерах на Chromium. Окна чата должны оставаться видимыми, а у вас должно быть разрешение на отправку сообщений на платформе.

Вебхуки и интеграции

Подключайте внешние платформы пожертвований, чтобы показывать чаевые и покупки в оверлее трансляции.

Что потребуется:

  1. Запишите идентификатор сеанса из меню расширения
  2. Оставляйте Social Stream Ninja включённым
  3. В разделе Global settings and tools → Mechanics, включите удалённое управление расширением через API
  4. Используйте обычные созданные ссылки на док-панель и оверлей; не добавляйте &server, &server2, или &server3 для вебхуков пожертвований
  5. Один раз перезагрузите док-панель, если она уже была открыта
Достаточно включить один переключатель API: удалённое управление API позволяет фоновому скрипту нормализовать вебхуки пожертвований и передавать их как обычные сообщения. Остальные транспортные переключатели API можно оставить выключенными.

Нормализованные данные пожертвования передаются в чат, оповещения, Event Flow, копилку и индикатор цели.

Удалённое управление API включено, а остальные транспортные переключатели API выключены

Поддерживаемые платформы:

Платформа URL вебхука Тип события
Stripe https://io.socialstream.ninja/{sessionID}/stripe checkout.session.completed
Ko-Fi https://io.socialstream.ninja/{sessionID}/kofi Публичные чаевые, подписки, заказы магазина и индивидуальные заказы
Buy Me A Coffee https://io.socialstream.ninja/{sessionID}/bmac Чаевые, подписки, заказы магазина, индивидуальные заказы и финансирование списка желаний
Fourthwall https://io.socialstream.ninja/{sessionID}/fourthwall Заказы, подарки, пожертвования и новые подписки

Настройка Stripe:

  1. Создайте Платёжная ссылка Stripe
  2. Важно: Добавьте пользовательские поля в платёжную ссылку:
    • Отображаемое имя или Имя пользователя (обязательно) — без этого поля пожертвования будут отклоняться
    • Сообщение (необязательно) — позволяет отправителю пожертвования оставить сообщение
  3. Откройте Вебхуки Stripe и создайте новую конечную точку
  4. Укажите URL: https://io.socialstream.ninja/YOUR_SESSION_ID/stripe
  5. Выберите событие: checkout.session.completed
  6. Проверка подписи не требуется; вместо этого держите идентификатор сеанса в тайне

Проверка: Используйте тестовый режим Stripe с картой 4242 4242 4242 4242, любой будущий срок действия и любой CVC.

Настройка магазина автора

Используйте иллюстрированное руководство по настройке для Fourthwall, Ko-fi и Buy Me a Coffee, включая статус приёмника, изолированный предпросмотр и импорт товаров.

Примечание о безопасности: Держите идентификатор сеанса в тайне. Любой, кто его знает, может отправлять поддельные события пожертвований в ваш оверлей.

Экспорт чата через вебхук:

Данные чата также можно экспортировать во внешние сервисы:

  • Укажите URL исходящего вебхука в настройках
  • Сообщения чата отправляются POST-запросами с данными JSON
  • Используйте это для записи чатов, запуска внешней автоматизации или синхронизации с другими инструментами

Устранение неполадок (расширение браузера)

Решения частых проблем с расширением браузера

Проблема со свёрнутым окном

Чат останавливается в фоне или при сворачивании

Сообщения перестают появляться, когда окна браузера уходят в фон или сворачиваются. Это происходит потому, что браузеры замедляют фоновые вкладки для экономии ресурсов.

Отключите замедление браузера
  • Chrome/Edge/Brave:
    1. Открыть chrome://flags/#enable-throttle-display-none-and-visibility-hidden-cross-origin-iframes
    2. Установите «Disabled»
    3. Также отключите chrome://flags/#calculate-native-win-occlusion
    4. Перезапустите браузер
  • Отключите ограничение производительности:
    1. Откройте chrome://settings/performance
    2. Отключите «Throttle Javascript timers in background»
Альтернативные подходы
  • Не скрывайте окна: Расположите окна так, чтобы они не были свёрнуты; даже небольшая видимая часть может предотвратить замедление.
  • Используйте виртуальные рабочие столы: В Windows нажмите Win+Tab и создайте два виртуальных рабочих стола: один для окон чата, другой для OBS.
  • Попробуйте отдельное приложение: Настольное приложение Social Stream Ninja позволяет избежать многих проблем с замедлением браузера.
Проблема с полосой отладки

Синяя полоса / автоответчик не работает

При использовании команд бота или автоответов появляется синяя полоса отладки либо автоматические ответы не работают.

Проверьте видимость окна чата
  • При работе с YouTube или Twitch убедитесь, что отдельное окно чата открыто и видно
  • На некоторых платформах нужно оставлять открытым основное окно вместе с отдельным окном чата
Совместимость с браузерами
  • Автоответчик лучше всего работает в браузерах на Chromium: Chrome, Edge и Brave
  • Firefox ограниченно поддерживает возможности расширения

Частые вопросы

Social Stream Ninja поддерживает более 100 платформ, включая YouTube, Twitch, Facebook, Instagram, TikTok, Discord, Zoom, Google Meet, X (Twitter), WhatsApp, Telegram и многие другие. Полный список смотрите в Поддерживаемые платформы странице.
Отдельное приложение рекомендуется большинству пользователей, поскольку оно:
  • Помогает избежать замедления со стороны браузера
  • Поддерживает автоматические обновления
  • Поддерживает закрепление окон и настройку прозрачности
  • Обеспечивает более высокую производительность и стабильность
Расширение браузера лучше подойдёт, если вы:
  • Нужно использовать на нескольких компьютерах
  • Предпочитаете не устанавливать дополнительные программы
  • Хотите сразу получать свежие обновления при ручной установке
Нет! Одно из главных преимуществ Social Stream Ninja — для большинства платформ не нужны API-ключи или данные входа. Программа захватывает данные чата прямо из окна браузера или интерфейса приложения. Однако для обычного просмотра чата нужно войти в аккаунт на каждой платформе.
Для расширения браузера: Чтобы обновить расширение, установленное вручную, скачайте последнюю версию, замените старые файлы новыми и перезагрузите расширение или браузер. Не удаляйте приложение , если хотите сохранить настройки. Версия из Chrome Web Store обновляется автоматически, но реже. Для отдельного приложения: Приложение автоматически обновится при перезапуске. Проверить обновления вручную также можно в меню приложения.
Да! Social Stream Ninja поддерживает двусторонний чат для большинства платформ. Если вы вошли на платформу и имеете нужные разрешения, можно отправлять сообщения из панели управления или командами API; они появятся одновременно во всех подключённых чатах.
Конечно! Social Stream Ninja рассчитан на работу с OBS Studio и другими программами для трансляций. Просто добавьте URL оверлея как источник «Браузер». Внешний вид можно настроить с помощью CSS прямо в OBS или через параметры URL.
Да, Social Stream Ninja полностью бесплатен, а его исходный код открыт по лицензии GPLv3.0. Здесь нет подписок, скрытых платежей или ограничений функций. Проект поддерживает Steve Seguin при участии сообщества.
Канонический список данных всех событий — новых подписчиков, платных подписок, рейдов, числа зрителей, пожертвований и других — находится в Справочник событий. Там также объясняется, для каких источников нужны переключатель «Захватывать события трансляции», разрешения при входе или дополнительные права доступа.
Все URL оверлеев, API док-панелей, команды WebSocket и точки подключения автоматизации описаны в Команды и API . Это лучшая отправная точка для создания собственного поведения или интеграции Social Stream Ninja с другими инструментами.
У Social Stream Ninja есть активное сообщество в Discord, где можно получить помощь от разработчика и других пользователей. Присоединяйтесь: discord.socialstream.ninja. Также можно сообщать о проблемах на Репозиторий GitHub.

Всё ещё нужна помощь?

Присоединяйтесь к нашему серверу сообщества в Discord, где разработчик и другие пользователи помогут разобраться с проблемами.