WorshipHubGid Itilizatè

Gid Itilizatè

Kòman pou w sèvi ak WorshipHub ak aplikasyon konpayon l yo — depi premye lansman jiska difizyon an dirèk ak OBS.

App documentation

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

Premye Etap

Telechaje enstalatè pou macOS oswa Windows, louvri l epi w pare — WorshipHub se yon sèl aplikasyon natif ki pa bezwen okenn lòt pwogram, pa bezwen kont epi li pa bezwen entènèt pou fonksyon prensipal li yo.

Rezolisyon erè pou louvri sou macOS ("Aplikasyon endomaje" oswa blòke)

Lè w telechaje ak enstale nenpòt nan aplikasyon biwo nou yo (WorshipHub, WorshipHub Notes oswa WorshipHub Songs) sou macOS depi sou entènèt, sistèm Gatekeeper macOS ka bloke aplikasyon an ak yon mesaj tankou "Aplikasyon an endomaje epi li pa ka louvri. Ou ta dwe mete l nan korbèy" oswa "Devlopè enkoni".

Sa rive poutèt mak karantèn macOS mete sou fichye ki telechaje sou web la. Pou rezoud sa rapidman epi lanse aplikasyon an san pwoblèm, louvri Terminal sou Mac ou epi konsilte kòmand sa a:

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

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

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

(Terminal ap mande w mo de pas Mac ou lè w ap ekri sudo. Tape l epi peye Antre).

Fenèt prensipal la

Aplikasyon an gen twa zòn prensipal:

  • Panèl agoch — bibliyotèk ou yo: Chante, Labib ak Medya (imaj, videyo, lyen YouTube).
  • Sant — Lis Sèvis la (òd sèvis jodi a) ak grèy diapozitiv pou eleman ki chwazi a.
  • Panèl adwat — Aperçu: sa ki AN DIRÈK kounye a, sa k ap vini apre a, bouton Pwojte ak kontwòl Nwa/Logo.

Pwojte

Konekte yon dezyèm ekran (pwojektè oswa TV), epi peze bouton Pwojte — oswa ⌘P / Ctrl+P. Fenèt pwojeksyon an ap louvri sou dezyèm ekran an nèt ale. Peze Pwojte ankò (oswa peze Esc) pou fèmen l.

Aparans tèks la

Bà ki anwo a gen kontwòl pou gwosè ekriti (A- / A+), gra, italik ak aliyman.

Konsèy: tout sa gid sa a di sou telefòn — Kòmand a Distans, Sijè, Nòt Predikasyon — pa bezwen enstale nan okenn magazen aplikasyon. Se aplikasyon web yo ye ki louvri lè w skane yon kòd QR.

Prepare yon Sèvis

Lis Sèvis la se òd pwogram ou an: chante, pasaj biblik, imaj, videyo ak clips YouTube.

Ajoute eleman

  • Chante — peze + sou nenpòt chante nan bibliyotèk la.
  • Vèsè biblik — chwazi vèsè ou vle epi peze Ajoute Vèsè.
  • Imaj ak videyo — ajoute yo nan bibliyotèk Medya a.

Fond ak Pwojeksyon

Sa ki dèyè tèks ou an enpòtan. WorshipHub sèvi ak GPU pou kreye efè animasyon an dirèk.

Bibliyotèk Labib

Panèl Labib la ba ou aksè ak vèsè san entènèt ak pwojeksyon vèsè pa vèsè.

Kòmand a Distans

Kòmand a Distans se yon aplikasyon web pou telefòn, tablèt ak òdinatè — pa gen anyen pou enstale.

Nòt Predikasyon ak Podyòm

Nòt Predikasyon se yon aplikasyon separe pou pastè a ekri ak preche.

Tradiksyon ak Sijè an Dirèk

WorshipHub ka tradui predikasyon an epi afiche l sou ekran an ak sou telefòn moun yo.

Difizyon ak OBS

WorshipHub bay de kouch overlay pou dwe itilize sou OBS an dirèk.

Tinèl Sekirize

Yon Tinèl Sekirize pèmèt aparèy ki pa sou menm Wi-Fi a konekte ak aplikasyon prensipal la.

Senkronizasyon Done

Tout done chante ak predikasyon ou yo ka senkronize ant plizyè òdinatè oswa sou nwaj 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.