All documentation

Télécommande

Turn any phone, tablet, or laptop into the control surface for your service.

Version 1.0.0Released 4 août 2026

What it is

WorshipHub Remote runs entirely in a browser — there is nothing to install on the phone. Whoever is running the service opens the page, scans the QR code shown on the WorshipHub desktop, and gets full control: slides, black screen, logo, the running order, the song and Bible library, and media uploads.

It is the same control the desktop operator has, which means the person at the sound desk and the person on stage can both drive the service without one shouting at the other.

Opening the app

There is no installation. Open control.worshiphub.live in any modern browser on the device you want to use. Add it to your home screen if you want it to open like an app.

Connecting it to WorshipHub

  1. 1On the WorshipHub desktop, open Tools ▸ Enable Remote Control.
  2. 2Go to Settings ▸ Remote Access. A QR code and a PIN appear there.
  3. 3On the phone, open control.worshiphub.live and scan that QR code with the in-page scanner.
  4. 4Type the PIN once. The device receives a token and stays trusted — you will not be asked again, even after the desktop restarts or its IP address changes.

Both devices need to be on the same Wi-Fi. If they are not — a phone on mobile data, or a second building — turn on a Secure Tunnel in the desktop settings and scan the tunnel QR instead.

If something goes wrong

The scanner opens but never reads the code

Camera access needs a secure connection. control.worshiphub.live is served over HTTPS, so this normally works — if it does not, check that the browser has camera permission for the site, and that the QR is fully inside the frame and in focus.

It says "Trust this device" and will not connect

The desktop uses a self-signed certificate — there is no way to get a real one for a private IP address on a church network. Tap Trust, accept the browser's warning in the tab that opens, then come back and retry. You only do this once per phone.

It connected before, but today it cannot find the desktop

The desktop's address is never cached on purpose, because it changes — a new IP from the router, or a different tunnel URL. Scan the QR again; it takes a couple of seconds.

The remote is not accepting the PIN

The PIN rotates when Remote Control is toggled off and on. Re-check the current PIN under Settings ▸ Remote Access on the desktop.

Works together with

These apps are commonly used alongside this one during the same service.

Setting up WorshipHub itself

Every companion app talks to the WorshipHub desktop app. If that is not set up yet, start with the main guide.

Open the main guide

Release history

What each version of this app can actually do.

v1.0.0

Slide control

  • Next and previous navigation with live haptic feedback on supported devices.
  • Black screen and logo output transitions.
  • Tap any slide in the running order to jump straight to it.
  • Live preview of the active projection slide plus the upcoming slide.
  • Optimistic UI — interface responds instantly on tap without waiting for server round-trips.

Service and library

  • Full running order with drag-and-drop reordering, live during a service.
  • Search the desktop's song library and add songs directly to the service.
  • Browse downloaded Bible translations and send scriptures to the screen.
  • Upload photos and videos straight from the phone; paste YouTube links for live playback.

Connection and pairing

  • QR code scanner and manual address entry for instant connection.
  • One-time 6-digit PIN pairing with auto-reconnecting device tokens in localStorage.
  • Guided certificate trust flow for local network HTTPS connections.
  • Works over local Wi-Fi or through secure Cloudflare, ngrok, and Tailscale tunnels.

Layout and audio streaming

  • Responsive UI adapting from mobile bottom tabs to tablet and desktop multi-column panels.
  • Predicador mode: stream microphone audio directly to WorshipHub's live AI transcription engine.
  • Independent second-screen projector window for browser-based monitoring.