WorshipHubGuida Utente

Guida Utente

Come usare WorshipHub e le sue app complementari — dal primo avvio alla trasmissione in streaming con OBS.

App documentation

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

Primi Passi

Scarica l'installer per macOS o Windows, aprilo e sei pronto — WorshipHub è un'unica app nativa senza dipendenze, senza account e senza necessità di internet per le sue funzioni principali.

Risoluzione errori di apertura su macOS ("Applicazione danneggiata" o bloccata)

Quando scarichi e installi una delle nostre app desktop (WorshipHub, WorshipHub Notes o WorshipHub Songs) su macOS da internet, il sistema Gatekeeper di macOS potrebbe bloccare l'app mostrando un avviso come "L'applicazione è danneggiata e non può essere aperta. Dovresti spostarla nel Cestino" o "Sviluppatore non identificato".

Questo è dovuto all'attributo di quarantena di macOS sui download web. Per risolverlo rapidamente e avviare l'app senza problemi, apri il Terminal del tuo Mac ed esegui il comando corrispondente all'app installata:

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

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

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

(Il Terminale chiederà la password del tuo Mac quando esegui sudo. Digitala e premi Invio).

La finestra principale

L'app è organizzata in tre aree:

  • Pannello sinistro — le tue biblioteche: Canti, Bibbia e Media (immagini, video, link YouTube).
  • Centro — la Lista del Servizio (l'ordine del giorno) e la griglia delle diapositive dell'elemento selezionato.
  • Pannello destro — l'Anteprima: ciò che è IN ONDA, cosa segue, il pulsante Proietta e i controlli Nero/Logo.

Proiettare

Connetti un secondo schermo (proiettore o TV), quindi premi il pulsante Proietta — o ⌘P / Ctrl+P. La finestra di uscita si apre sullo schermo secondario a schermo intero reale. Premere di nuovo Proietta (o Esc nella finestra di uscita) la chiude.

  • Doppio clic su qualsiasi diapositiva per inviarla in onda all'istante.
  • I tasti freccia avanzano/retrocedono le diapositive.
  • B attiva lo schermo nero; L mostra il logo della chiesa su fondo nero.

Aspetto del testo

La barra superiore ha controlli per dimensione carattere (A- / A+), grassetto, corsivo e allineamento — si applicano dal vivo alla proiezione.

Suggerimento: tutto ciò che questa guida menziona per smartphone — Controllo Remoto, Sottotitoli, Note — non richiede installazioni dagli store. Sono web app accessibili scansionando un codice QR.

Creare un Servizio

La Lista del Servizio è la scaletta del tuo evento: canti, brani biblici, immagini, video e clip YouTube, nell'ordine di presentazione.

Aggiungere elementi

  • Canti — premi il + su qualsiasi canto della biblioteca. Se il canto ha traduzioni, tutte le lingue sono incluse e modificabili dal vivo.
  • Vetti biblici — naviga in un capitolo, seleziona i versi desiderati e premi Aggiungi Versi. Ogni verso diventa una diapositiva (V1, V2…).
  • Immagini & video — aggiungi file alla biblioteca Media, poi inseriscili nel servizio.
  • YouTube — incolla un link. L'app recupera automaticamente titolo e miniatura, e riproduce il video integrato.

Trascina gli elementi per riordinarli. La ✕ rimuove un elemento.

Cambiare lingua dal vivo

I canti con traduzioni mostrano un selettore di lingua nell'intestazione della griglia. Ogni singola diapositiva ha anche un pulsante per cambiare temporaneamente la sua lingua. I brani biblici funzionano allo stesso modo.

Sfondi & Proiezione

Ciò che c'è dietro il testo è importante. WorshipHub renderizza gli sfondi sulla GPU come veri shader GLSL dal vivo.

Sfondi animati

Apri il selettore di sfondi. Ci sono 16 effetti animati (Mesh Liquida, Flusso d'Aurora, Pioggia di Grazia, Vetrata, Mare di Cristallo…).

I tuoi sfondi

Premi + Aggiungi sfondo per creare un preset personalizzato.

Schermo nero, Logo e controlli

Nero (B) spegne l'uscita; Logo (L) mostra il logo della chiesa su fondo nero. I sottotitoli si nascondono automaticamente quando Nero o Logo sono attivi.

La Biblioteca Biblica

Il pannello Bibbia ti offre le Scritture offline, la proiezione verso per verso e il cambio versione dal vivo.

Scaricare traduzioni

Cerca nel catalogo tra centinaia di traduzioni disponibili. Scarica quelle che desideri: il testo completo è salvato localmente e tutto funziona offline dopo il download.

Controllo Remoto

Il Controllo Remoto è una web app per smartphone, tablet e laptop — niente da installare.

Attivazione e abbinamento

Attiva Strumenti ▸ Attiva Controllo Remoto nell'app desktop. Scansiona il codice QR o inserisci il PIN a 6 cifre.

Note del Sermone & Podio

Note del Sermone è un'app separata per il pastore — per scrivere durante la settimana e predicare la domenica.

Modalità Podio

Podio trasforma il sermone in un teleprompter pulito a caratteri grandi con timer del servizio.

Traduzione & Sottotitoli dal Vivo

WorshipHub può trascrivere il sermone mentre viene predicato e mostrarlo sullo schermo, in streaming e sullo smartphone dei fedeli.

Streaming con OBS

Se la tua chiesa trasmette dal vivo con OBS, WorshipHub offre due overlay pronti all'uso (Browser Sources).

Tunnel Sicuri

Un Tunnel Sicuro pubblica il server locale del computer su un indirizzo HTTPS pubblico senza configurare il router.

Sincronizzazione Dati

La tua biblioteca di canti risiede in un database locale. Sono integrate due opzioni di sincronizzazione: LAN e 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.