Помощь и информация

Установка и запуск

Stream.Box не требует установки — это один исполняемый файл.

1. Скачайте последнюю версию Stream.Box.exe
2. Положите файл в любую удобную папку.
3. Запустите Stream.Box.exe.
4. При первом запуске Windows может показать предупреждение — нажмите «Подробнее» → «Выполнить в любом случае».

Первый запуск

После запуска появится главное окно — лента событий. Пока она пустая, это нормально.

В окне вы увидите панель с иконками:

• Сервисы — подключение площадок и донат-сервисов.
• Уведомления — отправка в Discord и Telegram.
• Сейчас играет — виджет текущего трека для OBS.
• Таймер — донатный таймер для OBS.
• Озвучка — настройки голоса для TTS.
• Настройки — общие параметры приложения.

Настройки приложения

Откройте Настройки через иконку шестерёнки на панели управления.

Здесь можно:

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

Twitch и VK Видео Live

Обе платформы подключаются одинаково:

1. Откройте окно Сервисы на панели управления.
2. Нажмите «Войти» напротив нужной платформы.
3. В браузере разрешите доступ.
4. Вернитесь в Stream.Box — подключение произойдёт автоматически.

DonationAlerts

1. Откройте окно Сервисы.
2. Напротив DonationAlerts нажмите «Войти».
3. В браузере войдите в DonationAlerts и разрешите доступ.
4. Вернитесь в Stream.Box — подключение произойдёт автоматически.

DonatePay

DonatePay подключается через API-ключ.

1. Откройте окно Сервисы и найдите DonatePay.
2. Откройте ссылку рядом с полем.
3. В личном кабинете DonatePay перейдите в раздел «Основное» → страница «API».
4. Скопируйте значение из поля «Ваш API ключ».
5. Вставьте ключ в поле в окне Stream.Box и нажмите «Сохранить».

DonateStream

DonateStream подключается через токен.

1. Откройте окно Сервисы и найдите DonateStream.
2. Откройте ссылку рядом с полем.
3. В личном кабинете DonateStream перейдите на страницу «Оповещения».
4. Нажмите «Показать и скопировать» — скопируется ссылка вида https://donate.stream/widget-alert?uid=...&token=....
5. Из этой ссылки нужен только токен — часть после token=.
6. Вставьте токен в поле в окне Stream.Box и нажмите «Сохранить».

Trula Донат

Trula подключается через токен.

1. Откройте окно Сервисы и найдите Trula Донат.
2. Откройте ссылку рядом с полем.
3. В личном кабинете Trula перейдите на страницу «Уведомления о донатах».
4. В группе уведомлений нажмите кнопку «Токен» — скопируется ссылка вида https://trula.io/widgets/notification/?token=....
5. Из этой ссылки нужен только токен — часть после token=.
6. Вставьте токен в поле в окне Stream.Box и нажмите «Сохранить».

Donatty

Donatty подключается через полную ссылку виджета — не через токен.

1. Откройте окно Сервисы и найдите Donatty.
2. Откройте ссылку рядом с полем.
3. Перейдите на страницу «Виджеты», раздел «Оповещение».
4. Скопируйте всю ссылку виджета целиком.
5. Вставьте ссылку в поле в окне Stream.Box и нажмите «Сохранить».

1. Откройте окно Сервисы и найдите Яндекс.
2. Откройте ссылку рядом с полем.
3. Войдите в свой аккаунт Яндекса и разрешите доступ.
4. Дождитесь, пока загрузится Яндекс Музыка в браузере.
5. Скопируйте всю ссылку целиком из адресной строки.
6. Вставьте её в поле в окне Stream.Box и нажмите «Сохранить».

Мультичат

Объединённый чат Twitch и VK Видео Live с иконками платформ и цветами ников.

Ссылка для OBS:

Донатный таймер

Таймер, который пополняется от донатов. Настраивается в окне Таймер в Stream.Box.

В окне задаётся базовое время и стоимость: сколько рублей доната добавляют сколько минут. Когда приходит донат — таймер автоматически пополняется. Для оформления есть несколько готовых пресетов.

Ссылка для OBS:

Сейчас играет

Виджет с текущим треком — обложка, название и исполнитель. Работает с любой музыкой, которая играет в системе: Яндекс Музыка, Spotify, VK, плееры и браузеры.

Ссылка для OBS:

Как выбрать источник музыки

Настраивается в окне Сейчас играет на панели управления.

1. Откройте окно и нажмите «Обновить».
2. В списке появятся все приложения, которые сейчас играют музыку.
3. Выберите нужное приложение.

Внешний вид

• Структура — три варианта оформления: Карточка, Пластинка 1, Пластинка 2.
• Фон и Текст — цвета в HEX-формате (например, 1A1A1A).
• Ссылка «Подобрать цвет →» открывает палитру — там можно скопировать нужный код.
• Между полями показывается живое превью — как будет выглядеть виджет.

Заглушка

Показывается, если у трека нет обложки.

• «Выбрать файл» — своя картинка.
• «Очистить» — вернуть значок ♪ по умолчанию.

Streamer.Bot

Stream.Box передаёт события (донаты, подписки, рейды, награды) в Streamer.Bot.

Установка

1. Скачайте Stream.Box.Main.sb и StreamBoxBridge.dll с GitHub.
2. Положите StreamBoxBridge.dll в папку dlls внутри папки со Streamer.Bot. Если папки dlls нет - создайте её.
3. Импортируйте Stream.Box.Main.sb через меню Import в Streamer.Bot.
4. В настройках Streamer.Bot включите Auto Connect и Reconnect для клиента StreamBox Main.
5. Создайте экшены и добавьте триггеры из раздела Add → Custom → Stream.Box.

Как отправляются уведомления

Откройте окно Уведомления через иконку колокольчика на панели управления. Внутри — три вкладки.

Основное

• Превью — картинка, которая уйдёт вместе с уведомлением. Пока пусто — будет использовано превью стрима с Twitch, если стрим идёт.
• Клик по превью открывает окно обрезки — можно выбрать нужную часть картинки.
• «Сгенерировать» — создать картинку через AI. Кнопка активна, только если включена AI-генерация, введён API-ключ и доступен полный функционал.
• «Выбрать файл» — взять готовую картинку с компьютера.
• «Очистить» — удалить картинку и вернуть превью со стрима.
• «Использовать постоянно» — эта картинка будет отправляться со всеми уведомлениями, пока вы её не смените.
• «ОТПРАВИТЬ» — отправить уведомление вручную прямо сейчас. Удобно, чтобы проверить настройки.

Настройки

• Заголовок — первая строка уведомления (по умолчанию «Стрим онлайн»).
• Кнопки (до 3 шт) — текст и ссылка. Появятся как кнопки под уведомлением в Discord и Telegram.
• [DS] Webhook — ссылка вебхука Discord.
• [DS] Пинг — упоминание @here или @everyone в Discord.
• [DS] Аватар Twitch — показывать аватар стримера в уведомлении Discord.
• [TG] Bot Token, [TG] Channel ID — данные Telegram-бота.
• Автоотправка при старте стрима — если включена, уведомление уйдёт само при старте. Если выключена — только вручную кнопкой «ОТПРАВИТЬ».

AI Генерация

• Модель — вариант генерации картинки на выбор.
• API Key — ключ для генерации. Пока не введён — кнопка «Сгенерировать» неактивна.
• Контекст — сюжет, стиль или детали для картинки. Например, «тёмное фэнтези, дракон, ночь».
• «Использовать AI-генерацию» — временно отключить генерацию, не удаляя ключ.

Откуда берётся картинка

Если картинка не задана вручную, Stream.Box подставит её сам — по порядку:

1. Временная картинка — сгенерированная или выбранная вручную.
2. Постоянная картинка, если включена галочка.
3. AI-генерация, если включена.
4. Превью стрима с Twitch.

Уведомления в Discord

Stream.Box может отправлять уведомления о старте стрима в Discord через вебхук.

Как получить ссылку вебхука

1. Откройте Discord и перейдите на сервер, куда будут приходить уведомления.
2. Нажмите правой кнопкой на нужный канал — выберите «Настроить канал».
3. Перейдите в раздел «Интеграция» → «Вебхуки».
4. Нажмите «Новый вебхук». Задайте имя и аватар — канал уже выбран.
5. Нажмите «Копировать URL вебхука».

Как вставить в Stream.Box

1. Откройте окно Уведомления в Stream.Box.
2. Перейдите на вкладку «Настройки».
3. Вставьте ссылку в поле [DS] Webhook.
4. При необходимости настройте заголовок, пинг (@here / @everyone) и кнопки.
5. Нажмите «Сохранить».

Уведомления в Telegram

Stream.Box может отправлять уведомления в Telegram-канал через бота.

Шаг 1. Создайте бота и получите токен

1. Откройте Telegram и найдите @BotFather.
2. Отправьте команду /newbot.
3. Придумайте имя и username бота (username должен заканчиваться на bot).
4. BotFather пришлёт токен — длинную строку вида 123456789:ABC....
5. Скопируйте токен

Шаг 2. Добавьте бота в канал

1. Откройте ваш Telegram-канал.
2. Добавьте бота в администраторы канала с правом публикации.

Шаг 3. Узнайте ID канала

1. Откройте @userinfobot или @getmyid_bot.
2. Перешлите боту любое сообщение из вашего канала.
3. Бот пришлёт ID канала — число с минусом, например -1001234567890.
4. Скопируйте ID.

Шаг 4. Настройка в Stream.Box

1. Откройте окно Уведомления → вкладка «Настройки».
2. Вставьте токен бота в поле [TG] Bot Token.
3. Вставьте ID канала в поле [TG] Channel ID.
4. При необходимости измените заголовок уведомления.
5. Нажмите «Сохранить».

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

Для работы озвучки нужен токен Яндекс — см. раздел «Яндекс».

Откройте окно Озвучка через иконку микрофона на панели.

Что можно настроить

• Голос — Алиса или другие голоса Яндекса.
• Громкость и скорость речи.
• Что озвучивать — донаты, сообщения чата, события Streamer.Bot.
• Шаблоны — как именно проговаривать текст.
• Фильтры — минимальная сумма доната, игнорируемые пользователи.
• Горячая клавиша — для быстрого пропуска текущей озвучки.

Переменные в шаблонах

В шаблонах донатов и чата можно подставлять данные:

• {user} — имя отправителя.
• {amount} — сумма доната.
• {currency} — валюта.
• {message} — текст сообщения.

Проверка

Нажмите кнопку «Проверить озвучку» — должно прозвучать тестовое сообщение.

Приложение не запускается

Проверьте, что файл лежит не в архиве. Если Windows ругается — нажмите «Подробнее» → «Выполнить в любом случае».

Не подключается к сервису

Откройте окно Сервисы — если напротив нужного сервиса пусто - авторизуйтесь заново.

Не работает озвучка

Проверьте, что авторизован Яндекс в Сервисах, и нажмите «Проверить озвучку» в окне Озвучки.

Виджет в OBS не показывает данные

Убедитесь, что Stream.Box запущен и подключён к нужному сервису. Если чат пустой — проверьте авторизацию в Twitch или VK.

Не приходят уведомления в Telegram или Discord

Проверьте: Бот Telegram добавлен в канал как администратор. В настройках ID канала указан с минусом.
Важно: Необходимо помнить про ограничения в РФ. Настраивайте свой интернет.
Я работаю над системой отправки, чтобы она работала всегда. Следите за обновлениями.

Как обновить программу

Проверка обновлений встроена — при запуске появится окно с новой версией, если она есть. Там же список изменений и кнопка «Скачать».

После нажатия «Скачать» приложение закроется, а в браузере начнётся загрузка новой версии. Замените Stream.Box.exe скачанным файлом и запустите заново — настройки сохранятся.

Где посмотреть логи

В окне Помощь есть ссылка «Открыть логи» — откроется папка с файлами. Пригодится при обращении в поддержку.

Что с лицензией

Stream.Box бесплатен — большинство функций работает у всех, без ограничений.

Premium открывает:

• AI-генерацию картинок — картинка создаётся нейросетью по описанию стрима.
• Донатный таймер — виджет для OBS с автопополнением от донатов.
• Яндекс Станция в источниках "Сейчас играет". Виджет показывает играющий трек, если подключена Яндекс Станция.

Как получить Premium:

• Всем новым пользователям — 30 дней бесплатно.
• Тестировщикам проекта — навсегда, в знак благодарности.
• Подписчикам Boosty — на время подписки.

Работает у всех и без Premium:

• Мультичат VK и Twitch
• Донаты с 5 сервисов
• TTS-озвучка донатов и чата
• Уведомления в Discord и Telegram
• Виджет «Сейчас играет»
• Интеграция со Streamer.Bot