WorshipHubРуководство пользователя

Руководство пользователя

Как использовать WorshipHub и сопутствующие приложения — от первого запуска до трансляции с OBS.

App documentation

Setup, troubleshooting, and release history for each WorshipHub app.

Первые шаги

Скачайте установочный файл для macOS или Windows, откройте его — и всё готово. WorshipHub является автономным приложением без внешних зависимостей, аккаунтов и требований к интернету для основных функций.

Устранение ошибок открытия на macOS («Приложение повреждено» или заблокировано)

При скачивании и установке любого из наших приложений (WorshipHub, WorshipHub Notes или WorshipHub Songs) на macOS из интернета система Gatekeeper может заблокировать запуск и показать предупреждение: «Приложение повреждено и его не удается открыть. Вам следует переместить его в Корзину» или «Неудавшийся разработчик».

Это связано с атрибутом карантина macOS для файлов из интернета. Чтобы быстро исправить это, откройте Терминал на вашем Mac и выполните соответствующую команду:

bash
# Для WorshipHub:
sudo xattr -rd com.apple.quarantine /Applications/"WorshipHub.app"

# Для WorshipHub Notes:
sudo xattr -rd com.apple.quarantine /Applications/"WorshipHub Notes.app"

# Для WorshipHub Songs:
sudo xattr -rd com.apple.quarantine /Applications/"WorshipHub Songs.app"

(Терминал запросит пароль вашего Mac при выполнении sudo. Введите его и нажмите Enter).

Главное окно

Приложение разделено на три области:

  • Левая панель — ваши библиотеки: Песни, Библия и Медиа (изображения, видео, ссылки YouTube).
  • Центр — Список служения (порядок на сегодня) и сетка слайдов выбранного элемента.
  • Правая панель — Предпросмотр: что СЕЙЧАС В ЭФИРЕ, что далее, кнопка «Проецировать» и управление Черным экраном/Логотипом.

Проекция

Подключите второй экран (проект или ТВ) и нажмите кнопку Проецировать — или ⌘P / Ctrl+P. Окно вывода откроется на втором экране в полноэкранном режиме.

Совет: все функции для смартфонов — Пульт, Субтитры, Заметки проповеди — не требуют установки из магазинов приложений. Это веб-приложения, открываемые по сканированию QR-кода.

Составление служения

Список служения — это порядок вашего мероприятия: песни, библейские отрывки, изображения, видео и ролик YouTube.

Фоны и проекция

WorshipHub рендерит фоны на видеокарте (GPU) в виде реальных GLSL-шейдеров в реальном времени.

Библейская библиотека

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

Пульт управления

Пульт управления — это веб-приложение для телефонов, планшетов и ноутбуков без необходимости установки.

Заметки проповеди и Подиум

Заметки проповеди — отдельное приложение для пастора для подготовки и проведения проповеди.

Живой перевод и субтитры

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

Трансляция с OBS

Если ваша церковь ведет прямые трансляции через OBS, WorshipHub предоставляет готовые оверлеи (Browser Sources).

Защищенные туннели

Защищенный туннель публикует локальный сервер на публичном HTTPS-адресе без настройки роутера.

Синхронизация данных

Ваша библиотека песен хранится в локальной базе данных. Встроены варианты синхронизации по локальной сети и через облако (Supabase).

Release history

What each version of this app can actually do.

v1.3.0

Live Translation — audio input

  • A microphone plugged into this computer can now feed Live Translation directly, alongside the existing WorshipHub Notes phone source.
  • Live level meter in the header confirms the microphone is actually picking up the speaker.
  • Adaptive noise floor and hallucination filtering stop Whisper inventing sentences during silence.

Narrated voice

  • Kokoro-82M text-to-speech runs on-device and speaks the translation aloud, with voices for English, Spanish, French, Italian, and Chinese.
  • Route the narration to this computer's own audio output for a monitor feed or sanctuary PA, stream it to WorshipHub Captions, or both at once.
  • One playout schedule keeps voice and subtitles saying the same words at the same moment, with a configurable 2–60 second delay behind the speaker.

Voice cloning (experimental)

  • Record your own voice and have the narration speak in your timbre, via OpenVoice v2 running entirely on-device.
  • Dedicated microphone selection for recording, a script to read aloud, and playback with pause and a waveform playhead.
  • Save multiple named voice profiles and preview any of them with Test Voice before the service.

Media and presentation

  • MP3, WAV, M4A, FLAC, OGG, and AAC audio files can be added to the media library and dropped into the running order.
  • Animated backgrounds now move to the beat of whatever audio or video is playing.
  • The Preview panel matches the selected projector's real shape, relative text size, and effects; plus a toolbar text-color picker, a slide-grid zoom slider, and toolbar tooltips.
  • YouTube playback fixed and clips cached on first play so they start instantly afterwards.

Songs and localization

  • Online lyrics search in Add Song across LRCLIB and iTunes/lyrics.ovh, with previews to tell versions apart before choosing one.
  • Japanese added, bringing the app to 9 languages with every interface string translated in all of them.
  • File ▸ Update to… offers an available update even after the notification toast has been dismissed.

v1.2.0

Media library — PDF and PowerPoint import

  • Native PDF import converting every page to a high-resolution slide in the background via bundled PDFium.
  • Native PowerPoint (.pptx) conversion and slide rendering via pure-Rust pipeline (no Microsoft Office or Keynote required).
  • Page-count badges and first-page thumbnails in the media library grid with live processing indicators.

Appearance and theming

  • Custom theme editor with draggable color pickers, live preview, and restart persistence.
  • Multi-stop gradient background editor allowing adding, dragging, and recoloring stops.
  • 4 new built-in dark themes (12 total) with persistent theme selection across app restarts.

Toasts and remote integration

  • Pairing request and content received toasts display the sending device's profile avatar.
  • Songs sent from paired Notes and Songs companion apps land directly in the active service running order.

Developer tools and sync

  • New Developer menu in debug builds for testing connection toasts and tunnel error states.
  • Supabase cloud sync removed in favor of direct, zero-configuration LAN Data Sync.

v1.1.0

Auto-updates and CI/CD

  • Secure in-place binary auto-updates powered by cargo-packager-updater.
  • Automated multi-platform CI/CD release builds.

User interface and theming

  • Overhauled Settings layout with category separators and unified native Slint modals.
  • Unified dynamic Light/Dark mode with adaptive design tokens.
  • Smoother scrolling behavior with ScrollView transitions across all views.
  • Text Shadow toggle for improved lyric readability on bright animated backgrounds.
  • Maximum lyric font size increased from 120 to 300 for large auditoriums.

Connected devices and tunnel

  • Redesigned Connected Devices management view with modern glassmorphism and stats bento boxes.
  • Tunnel settings automatically disable when provider binaries are missing.

v1.0.0

Song library and service

  • Local SQLite song library with full-text search across title, artist, and lyrics.
  • Multi-language song translations switchable mid-service per slide or item.
  • Drag-and-drop service builder with live reordering during presentations.
  • Save and reopen complete services as standalone portable files.

Bible integration

  • Download Bible translations for fully offline use.
  • Browse book, chapter, and verse, or search scripture directly.
  • Multi-translation simultaneous verse display.
  • One-tap verse insertion into the active running service.

Projection and visuals

  • Dual-monitor output with projector targeting to any connected display.
  • 7 GPU-accelerated animated backgrounds rendered as real GLSL shaders.
  • Adaptive quality scaling for smooth 60fps performance on hybrid and low-power GPUs.
  • Image, video, and YouTube playback with operator preview scrubbers.
  • Logo and black output transition buttons.

Live translation and captions

  • Real-time speech-to-text powered by Whisper (Metal-accelerated on Apple Silicon).
  • Choice of Lite (~60 MB) and Pro (~539 MB) models.
  • Adjustable on-screen subtitles and independent OBS capture toggle.
  • Browser-based Congregation Captions stream with client-side translation into 7 languages.

Companion devices and reach

  • Phone remote control with QR pairing and one-time PIN.
  • Approval-gated pairing for Notes and Songs companion apps.
  • Microphone audio streaming from mobile devices for remote preaching transcription.
  • LAN data sync and Secure Tunnels via Cloudflare, ngrok, Tailscale, and localtunnel.