WorshipHubGuide d'utilisation

Guide d'utilisation

Comment utiliser WorshipHub et ses applications compagnons — du premier lancement au streaming en direct avec OBS.

App documentation

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

Premiers Pas

Téléchargez l'installateur pour macOS ou Windows, ouvrez-le et vous y êtes — WorshipHub est une application native autonome sans dépendances, sans compte et sans connexion Internet requise pour ses fonctionnalités principales.

Résolution des erreurs d'ouverture sur macOS ("Application endommapée" ou bloquée)

Lors du téléchargement et de l'installation de l'une de nos applications de bureau (WorshipHub, WorshipHub Notes ou WorshipHub Songs) sur macOS depuis Internet, le système Gatekeeper de macOS peut bloquer l'application en affichant une alerte telle que "L'application est endommagée et ne peut pas être ouverte. Vous devriez la placer dans la Corbeille" ou "Développeur non identifié".

Cela est dû à l'attribut de quarantaine de macOS sur les fichiers téléchargés du Web. Pour y remédier rapidement et lancer l'application sans problème, ouvrez le Terminal de votre Mac et exécutez la commande correspondant à l'application installée :

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

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

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

(Le Terminal vous demandera le mot de passe de votre Mac lors de l'exécution de sudo. Saisissez-le et appuyez sur Entrée).

La fenêtre principale

L'application est organisée en trois zones :

  • Panneau gauche — vos bibliothèques : Chants, Bible et Médias (images, vidéos, liens YouTube).
  • Centre — la Liste du service (l'ordre du jour) et la grille de diapositives de l'élément sélectionné.
  • Panneau droit — l'Aperçu : ce qui est EN DIRECT, ce qui suit, le bouton Projeter et les commandes Noir/Logo.

Projeter

Connectez un second écran (projecteur ou TV), puis appuyez sur le bouton Projeter — ou ⌘P / Ctrl+P. La fenêtre de sortie s'ouvre sur l'écran secondaire, en plein écran réel et sans bordures. Appuyer à nouveau sur Projeter (ou Echap dans la fenêtre de sortie) la ferme.

  • Double-cliquez sur n'importe quelle diapositive pour l'envoyer en direct instantanément.
  • Les touches fléchées avancent/reculent les diapositives, en passant d'un élément du service au suivant.
  • B active un écran noir ; L affiche le logo de votre église sur fond noir. Les deux sont instantanés et se désactivent de la même façon.

Apparence du texte

La barre supérieure contient des commandes de taille de police (A- / A+), gras, italique et alignement — elles s'appliquent en direct à la sortie projetée. La taille de police est conservée entre les sessions.

Astuce : tout ce que ce guide mentionne sur les téléphones — Télécommande, Sous-titres, Notes de Prédication — ne nécessite aucune installation depuis un magasin d'applications. Ce sont des applications web accessibles en scannant un code QR depuis l'application de bureau.

Créer un Service

La Liste du service est le déroulé de votre événement : chants, passages bibliques, images, vidéos et clips YouTube, dans l'ordre où vous les présenterez.

Ajouter des éléments

  • Chants — appuyez sur le + sur n'importe quel chant de la bibliothèque. Si le chant comporte des traductions, toutes les langues sont incluses et modifiables en direct.
  • Versets bibliques — naviguez vers un chapitre, sélectionnez les versets souhaités et appuyez sur Ajouter les versets. Chaque verset devient sa propre diapositive, étiquetée V1, V2…
  • Images & vidéos — ajoutez des fichiers à la bibliothèque Média, puis intégrez-les au service.
  • YouTube — collez un lien. L'application récupère automatiquement le titre et la miniature réels, et lit la vidéo intégrée dans la fenêtre de sortie — sans fenêtre de navigateur.

Faites glisser les éléments pour les réorganiser. La ✕ supprime un élément.

Changer de langue en direct

Les chants avec traductions affichent un sélecteur de langue dans l'en-tête de la grille — le changer réaffiche toutes les diapositives dans cette langue. Chaque diapositive individuelle dispose également d'un bouton pour modifier temporairement sa langue. Les éléments bibliques fonctionnent de la même manière : si vous avez téléchargé plusieurs versions, un passage projeté peut basculer d'une version ou langue à une autre sans quitter la vue en direct.

Enregistrer et ouvrir des services

Fichier ▸ Enregistrer le service enregistre l'ensemble du déroulé dans un seul fichier portable :

  • Les chants sont inclus — ouvrir le fichier sur un autre ordinateur restaure tous les chants manquants dans la bibliothèque de cet appareil.
  • Les images et vidéos sont également incluses.
  • Les clips YouTube sont téléchargés dans le fichier lorsque c'est possible, pour être lus sans connexion Internet lors de la présentation.

Ouvrez le fichier sur l'ordinateur de l'église avec Fichier ▸ Ouvrir le service et tout reste exactement comme vous l'avez préparé chez vous.

Arrière-plans & Projection

Ce qui se trouve derrière vos paroles compte. WorshipHub rend les arrière-plans sur le GPU sous forme de vrais shaders GLSL — pas de fichiers vidéo en boucle — afin qu'ils fonctionnent de manière fluide même sur du matériel modeste.

Arrière-plans animés

Ouvrez le sélecteur d'arrière-plan dans la barre supérieure. Il existe 16 effets animés (Maillage liquide, Flux d'aurore, Pluie de grâce, Vitrail, Mer de cristal…), chacun avec des curseurs de vitesse et de complexité. Les effets prennent les couleurs de votre dégradé sélectionné.

Vos propres arrière-plans

Appuyez sur + Ajouter un arrière-plan dans le sélecteur pour créer un préréglage personnalisé : choisissez les deux couleurs du dégradé, forcez éventuellement une couleur d'accent, nommez-le et enregistrez. Les préréglages personnalisés persistent et peuvent être supprimés à tout moment. Vous pouvez également importer des images d'arrière-plan statiques et les afficher en plein écran depuis le panneau d'Aperçu.

Lecture de vidéo & YouTube

Lorsqu'une diapositive vidéo ou YouTube est en direct, le panneau d'Aperçu affiche une barre de transport : lecture/pause et une ligne de temps déplaçable avec la position et la durée actuelles. Les vidéos tournent en boucle à la fin.

Noir, Logo et remplacements

Noir (B) éteint la sortie ; Logo (L) affiche le logo de votre église sur fond noir. Les trois options sont mutuellement exclusives et instantanées. Les sous-titres se masquent automatiquement pendant que Noir ou Logo est actif.

Écrans

L'application sélectionne automatiquement le second écran et le redétecte lorsque vous branchez un projecteur après le démarrage. Vous pouvez également choisir l'écran de sortie manuellement dans l'en-tête.

La Bibliothèque Biblique

Le panneau Bible vous offre les Écritures hors ligne, la projection verset par verset et le changement de version en direct.

Télécharger des traductions

Ouvrez le panneau Bible et recherchez dans le catalogue — des centaines de traductions sont disponibles, filtrées par langue (Espagnol, English, Français, Italiano). Appuyez sur télécharger sur celles que vous souhaitez : le texte complet est stocké localement, de sorte que tout fonctionne hors ligne par la suite. Vous pouvez supprimer n'importe quelle traduction ultérieurement.

Naviguer et projeter

Choisissez une traduction, puis un livre, puis un chapitre. Appuyez sur des versets individuels pour les sélectionner et appuyez sur Ajouter les versets — le passage arrive dans la Liste du service avec une diapositive par verset (V1, V2…), intitulé comme "Jean 3:16-18". Double-cliquez sur n'importe quel verset pour le projeter ; les touches fléchées parcourent le passage verset par verset.

Changer de version ou de langue en direct

Si le livre et le chapitre d'un passage existent dans plus d'une traduction téléchargée, l'élément dispose du même sélecteur de langue que les chants — basculez l'ensemble du passage vers une autre version au milieu du service.

Versets depuis d'autres applications

Les versets peuvent également arriver dans le service depuis la Télécommande sur téléphone et depuis Notes de Prédication — ils apparaissent formatés de manière identique.

Télécommande

La Télécommande est une application web pour téléphones, tablettes et ordinateurs portables — rien à installer.

Activation et appairage

Activez Outils ▸ Activer la télécommande dans l'application de bureau. Un code QR et un code PIN à 6 chiffres apparaissent dans Réglages ▸ Accès distant. Sur le téléphone, ouvrez l'application Télécommande, scannez le code QR (ou tapez l'adresse affichée) et entrez le code PIN si demandé.

Après le premier appairage réussi, le téléphone reçoit un jeton d'appareil et reste mémorisé — il ne redemandera plus le code PIN. Gérez les appareils de confiance dans Réglages ▸ Appareils connectés.

Ce que vous pouvez faire depuis le téléphone

  • Onglet Contrôle — diapositive suivante/précédente, écran noir, logo et statut en direct.
  • Onglet Service — voir le déroulé, sauter à n'importe quelle diapositive, réorganiser les éléments.
  • Onglet Bibliothèque — ajouter des chants au service, parcourir la Bible et envoyer des versets, coller des liens YouTube et envoyer des photos/vidéos directement depuis la pellicule du téléphone.
  • Changement de langue — les mêmes sélecteurs de langue par élément et par diapositive que sur le bureau.

Un téléphone comme second projecteur

Dans Réglages ▸ Appareils connectés, marquez un appareil comme Sortie. La Télécommande de cet appareil affiche alors un bouton Projeter qui ouvre une fenêtre en plein écran sur un écran connecté à celui-ci.

Notes de Prédication & Podium

Notes de Prédication est une application séparée pour le pasteur — écrire pendant la semaine, prêcher le dimanche. Elle fonctionne comme application de bureau ou dans le navigateur.

Écrire

Un éditeur de texte enrichi propre : en-têtes, gras/italique, listes et blocs de citations bibliques. Insérez un passage depuis le navigateur biblique intégré et chaque verset apparaît avec son petit numéro de verset. Les sermons sont enregistrés localement et peuvent être synchronisés avec votre propre projet Supabase.

Connexion à l'application principale

Dans Notes ▸ Réglages ▸ Serveur de transcription, saisissez l'adresse de l'application de bureau (ou scannez son code QR). La première connexion demande une approbation sur l'écran du bureau. Le jeton survit aux redémarrages et aux changements d'adresse de tunnel.

Mode Podium

Podium transforme le sermon en un téléprompteur propre à grands caractères avec un minuteur de service. Deux super-pouvoirs en direct :

  • Touchez un verset, il est projeté. Chaque verset d'une citation biblique est individuellement cliquable — touchez le verset 2 et le verset 2 passe en direct sur le projecteur, ajouté automatiquement au service. Cela fonctionne même si le bureau n'a pas cette traduction téléchargée.
  • Envoyer tous les passages à l'avance. Un bouton pousse chaque passage cité dans le déroulé avant que le sermon ne commence.

Le microphone du pasteur

Podium peut également transmettre la voix du pasteur pour la Traduction en direct.

Traduction & Sous-titres en Direct

WorshipHub peut retranscrire le sermon au fur et à mesure qu'il est prêché et l'afficher à l'écran, sur le flux en direct et sur le téléphone de chaque auditeur.

Sur le projecteur

Activez Outils ▸ Traduction en direct (Présentation) et les sous-titres apparaissent dans une barre au bas de la sortie projetée. La reconnaissance vocale fonctionne entièrement sur votre ordinateur avec Whisper (deux tailles de modèle — Lite et Pro).

Style des sous-titres

Réglages ▸ Traduction en direct ▸ Sous-titres : choisissez la couleur du texte, la taille, la couleur de fond et l'opacité. Les sous-titres sont toujours limités à 3 lignes pour éviter d'encombrer l'écran.

Sous-titres pour la Congrégation

Activez Outils ▸ Application de sous-titres et partagez le code QR. Chaque membre ouvre une page web sur son propre téléphone et choisit sa langue de lecture (English, Español, Français, Deutsch, Italiano). Le modèle de traduction (~40 Mo, Opus-MT) se télécharge une fois dans son navigateur et fonctionne localement. La synthèse vocale peut lire la traduction à haute voix dans des écouteurs.

Streaming avec OBS

Si votre église diffuse en direct avec OBS (ou tout logiciel compatible avec les sources navigateur), WorshipHub vous propose deux superpositions prêtes à l'emploi.

Les deux sources

  1. Superposition de sous-titres en direct — le sous-titre actuel sur fond transparent, stylisé selon vos réglages.
  2. Code QR pour rejoindre — le code QR des sous-titres pour la congrégation sur fond transparent.

Les ajouter dans OBS

Ouvrez Réglages ▸ Traduction en direct ▸ Pour OBS. Copiez chaque URL avec son bouton de copie et collez-la dans une nouvelle Source Navigateur (Browser Source) dans OBS.

Utilisez l'adresse du tunnel. Le navigateur intégré d'OBS ne peut pas accepter un certificat LAN auto-signé. Activez d'abord un Tunnel Sécurisé et copiez les URL pendant qu'il est actif.

Contrôle en direct pendant la diffusion

Deux interrupteurs dans le menu Outils :

  • Afficher/Masquer les sous-titres (OBS)
  • Afficher/Masquer le QR d'accès (OBS)

Tunnels Sécurisés

Un Tunnel Sécurisé publie le serveur local du bureau sur une adresse HTTPS publique, sans configuration de routeur ni redirection de port.

Pourquoi l'utiliser

  • Les téléphones sur réseaux cellulaires peuvent utiliser la Télécommande, les Notes et les Sous-titres.
  • Les sources navigateur d'OBS obtiennent un certificat publiquement approuvé.
  • Les membres à la maison peuvent ouvrir la page de sous-titres de n'importe où.

Fournisseurs

Réglages ▸ Tunnel Sécurisé prend en charge quatre options : Cloudflare (recommandé), ngrok, Tailscale Funnel, localtunnel.

L'adresse n'est pas permanente

Avec les offres gratuites, l'URL publique change à chaque redémarrage du tunnel — c'est normal. WorshipHub gère cela automatiquement : tous les codes QR se régénèrent instantanément et les appareils appairés restent de confiance.

Synchronisation des Données

Votre bibliothèque de chants réside dans une base de données locale. Deux options de synchronisation sont intégrées.

Synchronisation LAN (ordinateur à ordinateur)

Réglages ▸ Synchronisation des données. Mettez un ordinateur en mode Serveur et l'autre en mode Client — ils se découvrent automatiquement sur le réseau local.

Synchronisation Cloud (Supabase)

Si vous souhaitez synchroniser par Internet, WorshipHub se connecte à votre propre projet Supabase gratuit — vous êtes propriétaire de la base de données.

  1. Créez un projet sur supabase.com.
  2. Copiez l'URL du projet et la clé anon/public dans Réglages ▸ Synchronisation Cloud.
  3. Appuyez sur Copier SQL et exécutez-le une fois dans l'éditeur SQL de Supabase.
  4. Synchronisez manuellement ou activez la synchronisation automatique.

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.