LAN Remote Control & Mobile Dashboard

Unilighter Desktop includes a built-in, local Client-Server Remote Control engine. It transforms any smartphone, tablet, or secondary laptop on your venue's local Wi-Fi into an untethered, tactile lighting controller—with zero cloud lag and without requiring an active internet connection.

Whether you are walking the stage to focus moving heads, fine-tuning audience blinders from the back of the auditorium, or handing a stage manager a tablet for worklight cues, remote control keeps you in full command from anywhere in the venue.

⚡ Architecture: Desktop LAN Host vs. Browser WebRTC

Unilighter offers two different ways to connect remote mobile devices, depending on whether you run the native desktop workstation or the web browser console:

Feature Browser Console (WebRTC) Unilighter Desktop (LAN Host)
Architecture Peer-to-Peer WebRTC DataChannels Dedicated Client-Server (HTTP & WebSocket)
Internet Requirement Requires internet initially to load both apps & exchange SDP 100% Offline (operates entirely on local Wi-Fi)
Connection Method Manual SDP offer/answer or signaling Instant QR Code Scan or direct local IP link
Device Approval Pre-shared connection offer 4-Digit PIN Confirmation on operator screen
Device Memory Session-based Permanent Device Authorization (reconnects instantly)
Network Footprint External STUN/TURN traffic 100% Local Traffic (never leaves the venue router)

Note

Browser Console Remote: The web browser edition at console.unilighter.cc still supports WebRTC remote control, but setup is more complex and both devices must have internet access to initiate the session. Unilighter Desktop provides the true, offline client-server experience.

🚀 Quick Start: Setting Up Remote Control

Connecting a phone or tablet to Unilighter Desktop takes less than 30 seconds:

Step 1: Enable the Server in Desktop Settings

  1. Open the console navigation menu and navigate to Settings (⚙️).
  2. Scroll to the Remote control section.
  3. Click Enable remote control.
  4. The server starts immediately and displays:
    • Server status: Marked as Server running.
    • Network address: Dropdown showing your computer's local IP address and port (e.g. http://192.168.1.100:3848).
    • Live QR Code: A scannable code generated directly on your screen.

Step 2: Scan the QR Code on Mobile

  1. Connect your smartphone or tablet to the same local Wi-Fi network as your lighting computer.
  2. Open the camera or QR scanner on your mobile device and scan the QR code.
  3. Tap the link to open the remote interface in Safari, Chrome, or Firefox.
  4. (Alternative): Type the displayed network address directly into your mobile browser's address bar.

Step 3: Approve the Connection via PIN Code

To prevent unauthorized guests or audience members on the venue Wi-Fi from tampering with your lighting:

  1. When your phone opens the page, it displays a 4-digit confirmation code (e.g. 4812).
  2. An interactive notification card (Remote access request) appears in the top-right corner of Unilighter Desktop:
    • Shows the device name (e.g. Phone), local IP address, and the confirmation code.
  3. Compare the PIN code with the code on your phone, then click Allow in the desktop console.
  4. Your mobile screen unlocks immediately and displays the live dashboard controls!

Tip

Device Memory: Once you approve a device, Unilighter Desktop remembers it via a secure local session cookie. When you reconnect the same phone later during soundcheck or showtime, it connects instantly without prompting for confirmation again.

🔒 Security & Device Authorization

Unilighter Desktop implements robust operator safety boundaries:

  • 2-Minute Request Expiry: Unapproved pairing requests automatically expire after 2 minutes.
  • Allowed Browsers List: In Settings \(\rightarrow\) Remote control, you can view all authorized devices under Allowed browsers, including their device name, IP address, and real-time status (Connected or Offline).
  • Revoke Access in 1 Click: Click Revoke access next to any device in the list to immediately disconnect that device and delete its authorization token.
  • Isolated Control Surface: Remote devices only receive dashboard widgets. Remote browsers have zero access to your operating system, show files, software updates, or terminal commands.

🛡️ Port Configuration & Firewall Troubleshooting

The remote control server uses TCP port 3848 by default.

Changing the Port

If port 3848 is already used by another service on your workstation:

  1. Click Disable remote control in Settings.
  2. Enter a new port number in the Port field (between 1 and 65535).
  3. Click Enable remote control to restart on the new port.

Firewall Troubleshooting

If your mobile browser shows "Could not reach Desktop", "Connection lost", or times out when scanning the QR code:

  1. Verify Same Wi-Fi Network: Ensure both your desktop computer and your mobile device are connected to the exact same router/subnet. (Guest Wi-Fi networks often isolate client devices from communicating with each other).
  2. Allow Port in Firewall: Your computer's operating system firewall may be blocking incoming connections on port 3848:
    • Windows: Open Windows Defender Firewall with Advanced Security \(\rightarrow\) Inbound Rules \(\rightarrow\) Add New Rule \(\rightarrow\) Port \(\rightarrow\) TCP 3848 \(\rightarrow\) Allow the connection.
    • macOS: Open System Settings \(\rightarrow\) Network \(\rightarrow\) Firewall \(\rightarrow\) Ensure Unilighter Desktop is allowed to receive incoming connections.
    • Linux: Run sudo ufw allow 3848/tcp in your terminal.

🎛️ Capabilities on the Remote Dashboard

The mobile remote interface is built specifically for responsive touch gestures:

  • Device Control Widgets: Full tactile touch control over multi-parameter faders, high-contrast RGB/RGBW color pickers, dimmer masters, and 2D Pan/Tilt XY pads for moving heads.
  • Node Graph Macro Widgets: Twist macro rotary dials and toggle procedural generator switches wired directly into your node graphs.
  • Ultra-Fast 50ms State Synchronization: Parameter updates are coalesced and broadcast at 50ms intervals, ensuring butter-smooth visual feedback without flooding local Wi-Fi bandwidth.
  • Multi-Operator Support: Multiple technicians can connect separate phones or tablets simultaneously. All connected devices share authoritative state in real time.
  • Project Switch Safety: If the desktop operator switches to another project or closes the workspace, remote screens update immediately without phantom commands or stuck cues.