OBS-плагин и виджет

Алерты TipBit — это обычная веб-страница /w/<токен> с прозрачным фоном. Она ставится в OBS как источник «Браузер» (Browser Source) — это одна кнопка в плагине: он сам создаёт источник, задаёт размеры и прозрачность. Звук алертов проигрывает сам виджет через WebAudio, а громкость источника в микшере плагин не меняет — донаты слышно в эфире сразу после установки.

OBS Studio 28+ Lua-скрипт без зависимостей Python-версия — опционально Прозрачный фон 1920×1080 и 800×450 Звук донатов в эфире по умолчанию Работает без сети

Установка за три шага

Скачайте плагин

Один файл TipBit.lua (ничего доустанавливать не нужно). В архиве — ещё и Python-вариант TipBit.py для тех, у кого в OBS подключён Python.

Положите файл в любую папку, например C:\TipBit\.

Подключите скрипт в OBS

Инструменты → Скрипты → «+» → TipBit.lua. Слева появится блок «TipBit» с полями настроек.

Для Python-версии сначала укажите путь к python3x.dll на вкладке «Python-настройки».

Вставьте ссылку виджета

Скопируйте ссылку в кабинете (раздел «Алерты и виджет») и вставьте её в поле «Ссылка виджета» — целиком или только токен. Нажмите «Проверить / обновить источник».

Повторные нажатия обновляют источник, дубликатов не появляется.

⬇️ Скачать плагин

версия 1.0.0

Скачать tipbit-obs.zip Скачать TipBit.lua ZIP: TipBit.lua, TipBit.py и README.md с инструкцией.

Что делает плагин: создаёт в выбранной сцене источник «Браузер» с адресом https://ваш-домен/w/<токен>, размерами 1920×1080 (или 800×450), прозрачным CSS и позицией (0,0). Настройка «Перезапускать при активации сцены» включена по умолчанию, а громкость источника в микшере не меняется — звук донатов идёт в эфир.

Работает безотказно: через 3 секунды после запуска OBS плагин сам проверяет источник, а поле «Профилактическая перезагрузка виджета, минут» (рекомендуем 180 для эфиров длиннее 4–6 часов) перезапускает страницу, если браузерный движок подвис. Сами алерты доставляются двумя каналами: WebSocket (мгновенно) и очередь на сервере — если OBS был выключен во время доната, алерт доиграется после запуска, с текстом и эмодзи без искажений.

Как это выглядит

Новый донат

0.025 BTC

@crypto_fan

Спасибо за стрим! Держи на кофе ☕

Демонстрация анимации виджета (зациклено). В OBS этот же кадр лежит поверх геймплея — фон виджета полностью прозрачный.

🎬 Что происходит на алерте

Появлениекарточка всплывает снизу с лёгким масштабированием и свечением в цвете темы

Вспышкапо контуру проходит блик, от карточки расходится мягкая волна (радиальный «взрыв»)

Содержимоесумма в крипте (крупно), ник донатера, сообщение, монетка сети

Звукпроигрывает сам виджет через WebAudio — отдельный файл в OBS не нужен; громкость источника не меняется, поэтому звук идёт в эфир

Удержаниекарточка висит заданное в кабинете время, затем плавно уходит

Размер полотна1920×1080 по умолчанию, на 800×450 контент остаётся по центру

Внешний вид (тема, звук, длительность, TTS) настраивается в кабинете — в разделе «Алерты и виджет». Плагину достаточно одной ссылки.

Поля плагина в OBS

Ссылка виджета (или токен)ссылка из кабинета или только токен

Базовый URL сервераhttps://tipbit.local — используется, если вставлен только токен

Имя источникаTipBit Alert — по нему плагин находит существующий источник

Ширина / Высота1920 × 1080 (или 800 × 450)

Сценасписок сцен OBS + пункт «Текущая сцена (программная)»

Добавить в конец сценыположить источник ниже остальных источников сцены

Перезапускать при активации сценывключено: страница обновляется при переключении на сцену

Отключить звук в микшеревыключено: громкость источника не меняется, звук донатов идёт в эфир (галочка нужна только для особых случаев)

Проверить / обновить источниксоздаёт или обновляет источник и кладёт его в сцену

Проверить подключениеперезагружает страницу виджета (нужно после правок в кабинете)

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

🖤 Чёрный фон вместо прозрачности

Значит источник показывает не виджет. Проверьте, что в адресе есть /w/: https://ваш-домен/w/<токен>, а не /widget.html. Возьмите ссылку заново в кабинете — плагин дополнительно прописывает источнику прозрачный CSS, который убирает чёрный прямоугольник.

🔇 Нет звука алерта

Звук донатов включён «из коробки»: громкость источника плагин не меняет, звук играет виджет через WebAudio. Если звука нет — нажмите кнопку «Включить звук» в самом виджете (браузеры блокируют автовоспроизведение до первого действия) или в браузере-превью, если открывали ссылку там.

Галочка «Отключить звук источника в микшере» по умолчанию выключена. Не включайте её без необходимости: она ставит громкость источника в 0.0, и звук донатов в трансляцию не попадёт. Галочка нужна только тем, у кого звук алертов идёт другим путём.

🔁 Алерт не появляется / не обновляется

Алерт не приходит: проверьте, что токен совпадает с кабинетом, источник лежит в текущей сцене и не скрыт. Кнопка «Тестовый донат» в кабинете показывает, что именно уходит в виджет.

Автообновление: включена настройка «Перезапускать при активации сцены», а вручную страницу перезагружает кнопка «Проверить подключение (перезагрузить виджет)». Сообщения плагина видны в логе OBS («Инструменты → Журналы») с префиксом [TipBit].

📐 Размеры 1920×1080 и 800×450

По умолчанию плагин ставит 1920×1080 — это полотно браузера, а не размер карточки: сам алерт центрирован и выглядит одинаково на любом фоне.

Вариант 800×450 — компактный, его предлагает кабинет; на нём алерт тоже остаётся по центру и никуда не смещается.

🗂 Несколько виджетов и несколько сцен

Для нескольких сцен просто повторите нажатие кнопки, выбрав другую сцену, либо добавьте готовый источник вручную: «Источники» → «+» → «Добавить существующий» → TipBit Alert.

Для разных виджетов (разные токены) скопируйте файл скрипта и подключите его вторым скриптом с другим «Именем источника» — у каждого будут свои настройки.

🔑 Где взять ссылку виджета

В личном кабинете, раздел «Алерты и виджет»: там кнопки «Виджет (OBS)» и «Открыть OBS-виджет (Browser Source)», предпросмотр алерта и кнопка «Тестовый донат» для проверки.

Вставлять в плагин можно и полную ссылку, и только токен — часть после /w/.

Ещё не принимали донаты?

Откройте кабинет — адреса для всех сетей и ссылка на виджет появятся автоматически.

Открыть кабинет Скачать плагин