WorshipHubユーザーガイド

ユーザーガイド

WorshipHubとその補完アプリの使い方 — 初回起動からOBSでのライブ配信まで。

App documentation

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

はじめに

macOSまたはWindows用のインストーラーをダウンロードして開くだけで、すぐに利用可能です。WorshipHubはアカウント登録やインターネット接続を必要としない単一のネイティブアプリです。

macOSでの起動エラー解決方法(「アプリが破損しています」またはブロックされる場合)

インターネットからデスクトップアプリ(WorshipHubWorshipHub 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"

( sudo 実行時にMacのパスワードを要求されます。入力してEnterを押してください)

メインウィンドウの構成

アプリは3つのエリアで構成されています:

  • 左パネル — ライブラリ:楽曲、聖書、メディア(画像、動画、YouTube)。
  • 中央 — 礼拝リスト(本日の進行順)およびスライド一覧。
  • 右パネル — プレビュー:現在のライブ画面、次のスライド、プロジェクションボタン、暗転/ロゴ制御。

投影(プロジェクション)

2台目のディスプレイ(プロジェクターやTV)を接続し、投影ボタン(または ⌘P / Ctrl+P)を押します。全画面表示で出力ウィンドウが開きます。

  • スライドをダブルクリックすると即座にライブ出力されます。
  • 矢印キーでスライドを進めたり戻したりできます。
  • B キーで画面を暗転、L キーでロゴを表示します。

ヒント: スマホ用アプリ(リモコン、字幕、説教ノート)はアプリストアからのインストールが不要です。デスクトップアプリに表示されるQRコードをスキャンしてWebブラウザで直接開くことができます。

礼拝リストの作成

礼拝リストは本日の進行順(楽曲、聖書箇所、画像、動画、YouTube)を管理する場所です。

要素の追加

  • 楽曲 — ライブラリ内の楽曲の + を押します。翻訳が含まれている場合は全言語が追加され、ライブ中に切り替え可能です。
  • 聖書節 — 章を選択し、必要な節をタップして節を追加を押します。各節が個別のスライドになります。
  • 画像・動画 — メディアライブラリに追加してサービスへ押し込みます。
  • YouTube — リンクを貼り付けるとタイトルとサムネイルが自動取得され、出力ウィンドウ内で再生されます。

ドラッグして順番を並べ替えることができます。✕ で削除します。

背景と投影

歌詞の背景はリアルタイムのGLSLシェーダーでGPU描画されるため、低スペックなPCでも滑らかに動作します。

アニメーション背景

ヘッダーの背景選択を開くと、16種類のアニメーション効果を選択できます。速度や複雑さ、カラーをカスタマイズ可能です。

暗転、ロゴ、オーバーライド

B(暗転)で画面をブラックアウト、L(ロゴ)で教会ロゴを表示します。字幕は暗転中自動的に非表示になります。

聖書ライブラリ

オフラインでの聖書検索、節ごとのスライド生成、ライブ中の訳本切り替えに対応しています。

訳本のダウンロード

カタログから数百の訳本を検索してダウンロードできます。ダウンロード後は完全にオフラインで動作します。

リモートコントロール

スマホやタブレット、ノートPCからインストール不要でアクセスできるWebアプリです。

有効化とペアリング

デスクトップアプリで ツール ▸ リモートコントロールを有効化 をオンにし、QRコードをスキャンまたはPINコードを入力します。

説教ノートとポディウム

牧師のための説教執筆・配信ツールです。

ポディウムモード

説教テキストを読みやすいプロンプター表示に変換します。タップした聖書節を直接プロジェクターへ投影可能です。

リアルタイム翻訳と字幕

説教の声をリアルタイムで文字起こしし、プロジェクター、配信、会衆のスマホ画面へ表示します。

OBSでの配信

OBSのブラウザソース(Browser Source)として追加できる透明な字幕用およびQRコード用のオーバーレイを提供します。

セキュアトンネル

セキュアトンネルを使用すると、ローカルサーバーをパブリックなHTTPSアドレスとして公開でき、同一Wi-Fi外のスマホからも接続可能です。

データ同期

LAN内でのPC間直接同期、または独自の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.