Remote Control

Remote Control lets a phone or tablet operate the live desktop app through a temporary approved session.

What the remote can control

  • Browse Bible books, chapters, and verses with a mobile-first search flow.
  • Type a full scripture reference such as John 3:16 and present it directly.
  • View detected scripture, move previous or next, jump to a verse, present, or clear the detected queue.
  • Search the Bible by idea or context and present matching verses.
  • Choose saved lyrics, switch line, section, or trail mode, and move through lyrics.
  • Turn Auto Present on or off from the remote header.

Start a remote session

  1. Open Remote Control from the desktop profile area or the native Tools menu on macOS.
  2. Choose Enable remote.
  3. Scan the QR code from the phone or tablet, or open the remote link and enter the session code.
  4. Approve the remote request on the desktop.
  5. Use Trust if this is a controlled team device that should reconnect faster in future sessions.

Startup and email options

  • Start remote when app opens creates a fresh remote session automatically after authenticated startup.
  • Email session details sends the current remote link and code to your account email when remote starts.
  • Email details can resend the active session details while the remote session is running.

Security model

  • The desktop app remains the source of truth and executes all remote actions.
  • Remote access is session-based and stops when the desktop disables remote control, exits, disconnects, or rotates the code.
  • Trusted devices store a local trusted token and can be forgotten from the remote page.
  • Only trust devices your team controls. Do not share remote session codes publicly.

Troubleshooting

  • If pairing fails, confirm the phone and desktop are using the same server environment.
  • If Trust fails, make sure the server database migrations have been applied.
  • If the remote says the session is unavailable, enable remote again on desktop and use the newest code.
  • Refreshing the remote page should reconnect during the same approved session, and trusted devices can reconnect without another approval while the desktop session is active.