REVELation Documentation

Wrapper Troubleshooting

Table of Contents

Linux Wayland and X11

On some Ubuntu/Wayland setups, Electron rendering works more reliably when forced to X11:

revelation-electron --ozone-platform=x11

If you launch from the desktop, you can use a .desktop entry like this:

[Desktop Entry]
Name=REVELation Snapshot Presenter
Exec=revelation-electron --ozone-platform=x11
Terminal=false
Type=Application
Categories=Utility;

Enable DevTools at Runtime

If you need to debug UI behavior in any app window, start the app with:

revelation-electron --enable-devtools

or in development environment:

npm start -- --enable-devtools

With this flag enabled, pressing F12 in any BrowserWindow opens DevTools in a separate (detached) window.

Peering and mDNS Issues

If peer control is not working, these are the most common causes:

  • mDNS discovery blocked by firewall/network policy.
  • Master is not actually publishing (Networking is not network mode).
  • Follower is not allowed to browse peers (mDNS Browse disabled).
  • Wrong host/port or pairing PIN when pairing manually.
  • Peer command link not established yet (pressing Z appears to do nothing).

Quick checks first

On the machine that should act as the master:

  1. Open Settings....
  2. Set Networking to network.
  3. Enable Enable Master Mode (mDNS Publish and Peering Endpoints).
  4. Verify Vite Server Port (default is commonly 8000).
  5. Confirm the Pairing PIN.

On the machine that should act as the follower:

  1. Open Settings....
  2. Enable Enable Peering as Follower (mDNS Browse).
  3. Confirm it can reach the master machine on the same LAN/subnet.

Then open Peer Presenter Pairing... and verify the master appears in Discovered Peers.

When mDNS discovery is broken

Some environments block multicast/broadcast discovery (guest Wi-Fi, VLANs, strict firewalls, managed corporate networks).
If discovery does not work, use manual pairing by IP:

  1. Open Peer Presenter Pairing... on the follower.
  2. Click Manual Pairing....
  3. In Pair by IP Address, enter the master IP (example 192.168.1.50).
  4. Enter Pairing Port (usually the master's Vite Server Port, commonly 8000).
  5. Click Pair and enter the master's Pairing PIN.

If this succeeds, mDNS can remain unreliable; manual pairing still works as a fallback.

If pairing works but send-to-peer does not

If peers are paired but pressing Z does nothing:

  1. Start a presentation on the master first.
  2. Ensure Reveal Remote is available/initialized in that session.
  3. Press Z again, or use presentation context menu Send Presentation to Peers (z).
  4. Check Peer Presenter Pairing... for currently paired masters and host/port hints.

Also verify both machines are still on the same reachable network and no host firewall rule changed mid-session.

Firewall and network notes

  • mDNS uses multicast DNS on local networks and is commonly blocked by firewall policies.
  • Peer pairing/commands require TCP connectivity to the master's Vite Server Port (often 8000).
  • If you're using routed/VLAN networks, expect discovery to fail and prefer manual pairing by IP.

Where to go next

Reset Settings and Plugins

Use the built-in reset action:

  1. Open the app.
  2. Go to Revelation (or app menu on macOS).
  3. Click Reset All Settings and Plugins....
  4. Confirm reset.

This resets local app settings and removes local overridden plugin/framework resources so the app can return to defaults.

Open the Debug Log

From the app menu:

  1. Open Help.
  2. Open Debug.
  3. Click Open Log.

The log file is stored in the app user-data folder as debug.log.

Common default user-data locations:

  • Windows: %APPDATA%/revelation-electron/
  • macOS: ~/Library/Application Support/revelation-electron/
  • Linux: ~/.config/revelation-electron/

Uninstall and Remove Local Data

If you want a full clean removal, do both:

  1. Uninstall the app.
  2. Remove local user data and caches.

1) Uninstall app

Typical install locations (vary by installer/package manager):

  • Windows (NSIS): uninstall from Apps/Programs, usually installed under C:\Program Files\REVELation Snapshot Presenter\
  • macOS: remove app from /Applications
  • Linux (.deb/.rpm): remove package with your package manager

2) Remove local user data and caches

Remove the app user-data folder:

  • Windows: %APPDATA%/revelation-electron/
  • macOS: ~/Library/Application Support/revelation-electron/
  • Linux: ~/.config/revelation-electron/

Optional: if you also want to remove your presentation library created by default, delete:

  • ~/Documents/REVELation Presentations/

Only delete that folder if you no longer need your local presentations and media.

Documentation Hub

Back to Documentation Hub

Created with REVELation Snapshot Presenter