WorshipHubPrzewodnik Użytkownika

Przewodnik Użytkownika

Jak używać WorshipHub i aplikacji towarzyszących — od pierwszego uruchomienia po transmisję na żywo z OBS.

App documentation

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

Zdalne Sterowanie
Open the main guide
Napisy Na Żywo
Open the main guide
Notatki z Kazania
Open the main guide
Biblioteka Pieśni
Open the main guide

Pierwsze Kroki

Pobierz instalator dla macOS lub Windows, otwórz go i gotowe — WorshipHub to pojedyncza natywna aplikacja bez zależności, bez konta i bez konieczności dostępu do Internetu dla głównych funkcji.

Rozwiązywanie błędów uruchamiania na macOS ("Aplikacja uszkodzona" lub zablokowana)

Podczas pobierania i instalowania dowolnej z naszych aplikacji stacjonarnych (WorshipHub, WorshipHub Notes lub WorshipHub Songs) na systemie macOS z Internetu, system Gatekeeper może zablokować aplikację, wyświetlając komunikat "Aplikacja jest uszkodzona i nie można jej otworzyć. Powinieneś przenieść ją do Kosza" lub "Niezidentyfikowany deweloper".

Wynika to z atrybutu kwarantanny macOS nałożonego na pobrane pliki. Aby to szybko naprawić i uruchomić aplikację bez problemów, otwórz Terminal na Macu i wykonaj odpowiednie polecenie:

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

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

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

(Terminal poprosi o hasło do Maca podczas uruchamiania sudo. Wpisz je i naciśnij Enter).

Główne okno

Aplikacja jest podzielona na trzy obszary:

  • Lewy panel — Twoje biblioteki: Pieśni, Biblia i Media (obrazy, wideo, linki do YouTube).
  • Środek — Lista nabożeństwa (porządek na dziś) i siatka slajdów wybranego elementu.
  • Prawy panel — Podgląd: co jest NA ŻYWO, co będzie następne, przycisk Projektuj i sterowanie Czarnym Ekranem/Logo.

Projekcja

Podłącz drugi ekran (projektor lub TV) i naciśnij przycisk Projektuj — lub ⌘P / Ctrl+P. Okno wyjściowe otworzy się na drugim ekranie w pełnym ekranie.

Wskazówka: wszystko w tym przewodniku, co dotyczy telefonów — Zdalne Sterowanie, Napisy, Notatki — nie wymaga instalowania aplikacji ze sklepów. Są to aplikacje internetowe uruchamiane przez skanowanie kodu QR.

Tworzenie Nabożeństwa

Lista nabożeństwa to porządek Twojego wydarzenia: pieśni, wersety biblijne, obrazy, filmy i klipy z YouTube.

Tła & Projekcja

WorshipHub renderuje tła na karcie graficznej (GPU) jako prawdziwe shadery GLSL w czasie rzeczywistym.

Biblioteka Biblijna

Panel Biblii zapewnia dostęp do Pisma Świętego offline, projekcję werset po wersecie oraz zmianę przekładu na żywo.

Zdalne Sterowanie

Zdalne Sterowanie to aplikacja internetowa dla telefonów, tabletów i laptopów — bez konieczności instalacji.

Notatki z Kazania & Podium

Notatki z Kazania to osobna aplikacja dla kaznodziei — do pisania w tygodniu i głoszenia w niedzielę.

Tłumaczenie & Napisy na Żywo

WorshipHub może transkrybować kazanie w trakcie jego trwania i wyświetlać je na ekranie oraz w telefonach słuchaczy.

Transmisja z OBS

Jeśli Twój kościół prowadzi transmisję na żywo za pomocą OBS, WorshipHub oferuje dwie gotowe nakładki (Browser Sources).

Bezpieczne Tunele

Bezpieczny Tunel publikuje lokalny serwer aplikacji pod publicznym adresem HTTPS bez konfiguracji routera.

Synchronizacja Danych

Biblioteka pieśni znajduje się w lokalnej bazie danych. Wbudowano dwie opcje synchronizacji: LAN i Cloud (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.