WorshipHub사용자 가이드

사용자 가이드

WorshipHub 및 동반 앱 사용 방법 — 첫 실행부터 OBS 라이브 스트리밍까지.

App documentation

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

원격 제어
Open the main guide
실시간 자막
Open the main guide
설교 노트
Open the main guide
찬양 라이브러리
Open the main guide

시작하기

macOS 또는 Windows용 설치 프로그램을 다운로드하고 실행하면 바로 사용할 수 있습니다. WorshipHub는 별도의 종속성이나 계정, 인터넷 연결 없이도 기본 기능을 완벽하게 지원하는 단일 네이티브 앱입니다.

macOS 실행 오류 해결 방법 ("앱이 손상되었음" 또는 차단됨)

인터넷에서 데스크톱 앱(WorshipHub, WorshipHub Notes, WorshipHub Songs)을 다운로드하여 설치할 때, macOS Gatekeeper가 "앱이 손상되었기 때문에 열 수 없습니다. 휴지통으로 이동해야 합니다" 또는 *"확인되지 않은 개발자"*라는 경고 메시지를 표시할 수 있습니다.

이는 웹 다운로드 파일에 적용되는 macOS 격리(Quarantine) 속성 때문입니다. 터미널을 열고 설치한 앱에 해당하는 명령어를 실행하면 바로 해결됩니다:

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 링크).
  • 중앙 패널 — 예배 순서 목록 (오늘의 순서) 및 선택된 항목의 슬라이드 그리드.
  • 오른쪽 패널 — 미리보기: 현재 라이브 화면, 다음 슬라이드, 프로젝션 버튼 및 암전/로고 컨트롤.

프로젝션 (화면 송출)

보조 모니터(프로젝터 또는 TV)를 연결하고 프로젝트 버튼 — 또는 ⌘P / Ctrl+P를 누르세요.

팁: 스마트폰 관련 기능(리모컨, 자막, 설교 노트)은 앱스토어 설치가 필요 없는 웹 앱 형태이며 QR 코드를 스캔하여 바로 접속할 수 있습니다.

예배 순서 작성

예배 순서 목록은 찬양, 성경 구절, 이미지, 비디오, YouTube 클립을 원하는 순서대로 배치하는 공간입니다.

배경 및 투사

WorshipHub는 GPU 기반의 실시간 GLSL 셰이더 배경을 사용하여 저사양 컴퓨터에서도 부드럽게 작동합니다.

성경 라이브러리

오프라인 성경 검색, 구절별 슬라이드 생성 및 실시간 번역본 전환 기능을 제공합니다.

리모컨

리모컨은 스마트폰, 태블릿, 노트북에서 설치 없이 사용할 수 있는 웹 앱입니다.

설교 노트 및 포디움

설교자는 설교 노트를 통해 설교 작성 및 설교 단상(포디움) 모드를 활용할 수 있습니다.

실시간 번역 및 자막

음성 인식을 통해 설교 내용을 실시간으로 자막으로 생성하고 청중의 스마트폰으로 전송합니다.

OBS 스트리밍

OBS 브라우저 소스를 통해 자막 및 QR 코드를 방송 화면에 오버레이할 수 있습니다.

보안 터널

보안 터널을 통해 외부 네트워크에서도 리모컨 및 자막 기능에 안전하게 접속할 수 있습니다.

데이터 동기화

로컬 네트워크(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.