WorshipHub用戶指南

用戶指南

如何使用 WorshipHub 及其附屬應用程式 — 從首次啟動到使用 OBS 進行直播。

App documentation

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

快速入門

下載適用於 macOS 或 Windows 的安裝程式,開啟即可使用 — WorshipHub 是一款單一原生應用程式,無需任何依賴項、無需帳號,核心功能亦無需網路連線。

解除 macOS 開啟錯誤(「應用程式已損毀」或被阻擋)

從網路下載並安裝我們的桌面應用程式(WorshipHubWorshipHub NotesWorshipHub Songs)時,macOS 的 Gatekeeper 可能會阻擋開啟,並顯示警告訊息如 「應用程式已損毀,無法開啟。您應該將其丟到垃圾桶」「未識別的開發者」

這是由於 macOS 對網路下載檔案設置的隔離屬性。要快速解決此問題,請開啟 Mac 的 終端機(Terminal),並執行相應的命令:

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"

(執行 sudo 時終端機會要求輸入您的 Mac 密碼,輸入後按 Enter 即可)。

主視窗介紹

應用程式分為三個主要區域:

  • 左側面板 — 您的圖書館:詩歌、聖經和媒體(圖片、影片、YouTube 連結)。
  • 中間區域 — 流程列表(今天的節目順序)和所選項目的投影片網格。
  • 右側面板 — 預覽區:即時直播內容、下一個投影片、投影按鈕以及黑屏/標誌控制。

投影功能

連接第二個顯示器(投影機或電視),然後按下 投影 按鈕 — 或快捷鍵 ⌘P / Ctrl+P

提示: 本指南中提到的所有手機功能(遙控器、字幕、講道筆記)均無需從應用商店下載,只要掃描桌面端的 QR Code 即可直接開啟網頁版使用。

建立流程

流程列表是您聚會活動的播放順序:詩歌、聖經章節、圖片、影片和 YouTube 影片。

背景與投影

WorshipHub 在 GPU 上利用 GLSL 著色器即時繪製動態背景,保證流暢運行。

聖經圖書館

提供離線聖經閱讀、逐節投影以及即時切換聖經譯本功能。

遙控器

遙控器是一款適用於手機、平板與筆電的 Web 應用程式,無需安裝任何軟體。

講道筆記與講台

講道筆記是專為牧師設計的工具,可在主日講道時作為讀稿機(講台模式)使用。

即時翻譯與字幕

WorshipHub 可即時轉錄講道內容,並將字幕顯示在投影幕、直播畫面以及每位會眾的手機上。

使用 OBS 直播

提供 OBS 瀏覽器來源(Browser Source)遮罩圖層,輕鬆嵌入直播串流。

安全隧道

安全隧道可將本機伺服器發布至公網 HTTPS 位址,無需設定路由器。

資料同步

支援局域網 (LAN) 同步及 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.