Посібники

Дізнайтеся, як налаштувати, персоналізувати й повною мірою використовувати Social Stream Ninja

Джерела чату YouTube, Twitch, TikTok і понад 100 інших платформ
Social Stream Ninja Розширення або настільний застосунок об’єднує всі чати в одну сесію
Док Модеруйте, вибирайте й відповідайте
Оверлей OBS Вибраний чат і сповіщення на трансляції

Один ID сесії об’єднує все: використовуйте однакове ?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 (як глядач або автор)
  • Переконайтеся, що ви підключені через WiFi або Ethernet (не мобільні дані)
  • Переконайтеся, що розширення Social Stream Ninja ввімкнене (зелена піктограма)

Discord, Slack, WhatsApp тощо.

  • Спочатку ввімкніть ці платформи в налаштуваннях розширення (перемикачем)
  • Відкрийте вебверсії цих платформ у браузері
  • Переконайтеся, що розширення Social Stream Ninja ввімкнене (зелена піктограма)

Налаштування (розширення браузера)

Параметри URL

Можна налаштувати панель і оверлей, додавши параметри до їхніх URL. Кілька прикладів:

Параметри панелі:

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

Параметри оверлею:

&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 шаблону на ID своєї сесії
  • Додайте URL шаблону як джерело браузера OBS

Приклад: https://socialstream.ninja/themes/pretty.html?session=YOURSESSIONID

Різні кольори для імен чату

Кольори імен потребують двох налаштувань: загального джерела кольору в Повідомлення — оформлення і перемикача відображення дока в Повідомлення — видимість.

Відкрити посібник із кольорів імен чату для знімків екрана, вибору кольорів, усунення несправностей і прикладів CSS.

Власний хостинг шрифтів і оформлення

Додайте власні шрифти до dock.html або featured.html без залежності від шрифтів Google/системи.

  • Розмістіть файли .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: Мінімальне споживання ресурсів, лише CPU — &ttsprovider=kitten
  • Власний сервер: Запускайте Kokoro-FastAPI або openedai-speech локально через Docker — &ttsprovider=openai&openaiendpoint=http://localhost:8880/v1/audio/speech

Преміальні хмарні варіанти озвучення:

  • Google Cloud TTS: Голоси професійної якості (потрібен ключ Google API)
  • 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 Chats, Bits, Tips) пересилаються автоматично незалежно від цього перемикача. Перемикач призначений переважно для сповіщень про підписників/платних підписників.

Події, що захоплюються за платформами:

YouTube

  • Нові членства й подаровані членства
  • Підвищення рівнів і віхи членства
  • Донати Super Chat і Super Sticker
  • Кількість підписників і глядачів

Twitch

  • Нові підписники, повторні й подаровані підписки
  • Підписники та їхня кількість
  • Bits/Cheers і використання балів каналу
  • Рейди з кількістю глядачів

TikTok, Kick та інші

  • Підписники й подарунки (TikTok)
  • Підписки й чайові (Kick)
  • Кількість глядачів на більшості платформ

Повний список даних подій і полів дивіться в Довідник подій документації.

Верхня смуга Hype Train

Показуйте прогрес Twitch Hype Train і Treasure Train як верхню смугу в стилі Twitch в OBS.

  • Скопіюйте окреме посилання Hype Train Top Bar зі спливного вікна.
  • Перевірте кнопкою Fake Hype Train перед виходом у прямий ефір.
  • Скористайтеся посібником для кроків налаштування, знімків екрана й усунення несправностей.

Відкрити посібник із верхньої смуги Hype Train

Нові учасники чату

Виділяйте зовсім нових учасників чату, додавайте необов’язковий значок листка або сигнал дока лише для нових учасників.

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

Відкрити посібник із нових учасників чату

Редактор потоків подій

Редактор Event Flow — потужна вузлова система автоматизації для створення власних процесів. Це рівень розширеної автоматизації, що дозволяє програмувати власну логіку маршрутизації.

Що можна робити:

  • Пересилання чату між платформами із розумними фільтрами (наприклад, віддзеркалювати Twitch у Discord, але блокувати команди)
  • Створюйте власні команди із логічними вузлами AND/OR/NOT
  • Запускайте оверлеї та аудіо за конкретними подіями або ключовими словами
  • Керування OBS сцени й джерела автоматично
  • Створюйте лотереї та розіграші із керуванням чергою

Початок роботи:

  1. Відкрийте редактор Event Flow з меню головної панелі
  2. Створіть новий потік і додайте вузли джерел (наприклад, «Twitch Message»)
  3. Підключіть логічні вузли для фільтрації повідомлень (Contains Keyword, User Role тощо)
  4. Додайте вузли дій для відповіді (Send Chat, Play Audio, Display Overlay)
  5. Перевірте вбудованим симулятором перед виходом у прямий ефір

Оверлей Flow Actions:

Щоб аудіо, медіаоверлеї та дії OBS працювали, потрібно додати сторінку Flow Actions як джерело браузера OBS:

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

Важливо: Поточні дії Relay Chat автоматично пропускають розпізнані віддзеркалення. Використовуйте Фільтр віддзеркалень (Reflection Filter) вузол, щоб керувати показом захоплених повторів у доку й оверлеях. Дивіться покроковий посібник із пересилання чату для налаштування. Докладну документацію дивіться в Посібник із потоків подій. Для звуків або медіа винагород 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. Відкрийте спливне вікно розширення й знайдіть розділ Bot/Auto-Response
  2. Увімкніть потрібні команди
  3. Для роботи відповідей залишайте вікно чату видимим (не згорнутим)
  4. Переконайтеся, що ви ввійшли на платформу з дозволом на публікацію

Створення власних команд:

Для складніших команд використовуйте редактор Event Flow:

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

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

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

Підключайте зовнішні платформи донатів для показу чайових і покупок в оверлеї трансляції.

Передумови:

  1. Занотуйте ID сесії зі спливного вікна розширення
  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. Перевірка підпису не потрібна (натомість зберігайте ID сесії в таємниці)

Перевірка: Використовуйте тестовий режим Stripe із карткою 4242 4242 4242 4242, будь-який майбутній термін дії та будь-який CVC.

Налаштування магазину автора

Використовуйте ілюстрований посібник із налаштування для Fourthwall, Ko-fi та Buy Me a Coffee, включно зі станом приймача, ізольованими переглядами й імпортом товарів.

Примітка щодо безпеки: Зберігайте ID сесії в таємниці. Будь-хто з вашим ID сесії може надсилати фальшиві події донатів у ваш оверлей.

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

Також можна експортувати дані чату до зовнішніх сервісів:

  • Налаштуйте 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 за участі спільноти.
Ми підтримуємо канонічний список усіх даних подій (підписники, членства, рейди, кількість глядачів, донати тощо) у Довідник подій. Там також пояснено, яким джерелам потрібні перемикач «Capture Stream Events», дозволи входу або додаткові області доступу для отримання даних.
Усі URL оверлеїв, API дока, команди WebSocket і засоби автоматизації задокументовані в Команди й API сторінці. Це найкраща відправна точка для програмування власної поведінки або інтеграції Social Stream Ninja з іншими інструментами.
Social Stream Ninja має активну спільноту Discord, де можна отримати допомогу безпосередньо від розробника та інших користувачів. Приєднуйтеся на discord.socialstream.ninja. Також можна повідомляти про проблеми на Репозиторій GitHub.

Потрібна ще допомога?

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