Guides

Using the Mobile Stream Deck

Control your VMSC setup, monitor chat, and view stats from your phone or tablet using the built-in mobile web interface.

Overview

The Mobile Stream Deck is a lightweight web app served by VMSC that lets you trigger rules, read chat, and check session stats from any device with a browser. It works over your local network or remotely via a Cloudflare tunnel.

Setting Up the PIN

Access to the Mobile Stream Deck is protected by a numeric PIN to prevent unauthorized control.

  1. Open Settings > General > Mobile Stream Deck.
  2. Enter a 4–8 digit PIN in the Access PIN field.
  3. Click Save.
Set a PIN before sharing the URL

If no PIN is configured, the Mobile Stream Deck is open to anyone who has the URL. Always set a PIN before enabling remote access.

Accessing from the Dashboard Popout

The quickest way to open the Mobile Stream Deck on your PC is from the Dashboard.

  1. On the Dashboard, click the Mobile Stream Deck popout button in the top-right toolbar (phone icon).
  2. A new browser window opens with the Mobile Stream Deck UI.
  3. This is useful for testing the interface before opening it on a mobile device.

Accessing from Your Phone

To open the Mobile Stream Deck on your phone or tablet:

  1. Make sure your phone is on the same Wi-Fi network as the PC running VMSC (for local access).
  2. Open a browser on your phone and navigate to the HTTPS URL shown in Settings > General > Mobile Stream Deck. The URL follows the format: https://<local-ip>:7891.
  3. Enter your PIN when prompted.
  4. The interface loads and connects to VMSC over WebSocket for real-time updates.
HTTPS is required

The Mobile Stream Deck uses a self-signed HTTPS certificate. Your browser may warn you the first time — accept the certificate to proceed. This is safe on your local network.

Sharing the URL

You can share the Mobile Stream Deck URL with trusted moderators or co-streamers so they can trigger rules on your behalf.

  • Click the Copy URL button in Settings to copy the link to your clipboard.
  • A QR code is also displayed — scan it with a phone camera for quick access.
  • Anyone with the URL and PIN can access the Stream Deck. Change the PIN if you need to revoke access.

Controls Tab — Triggering Rules

The Controls tab displays a grid of buttons, one for each rule that has been marked as Mobile Trigger Enabled in the rule editor.

  • Tap a button to fire the associated rule immediately.
  • Buttons show the rule name and icon. Long-press to see the rule description.
  • Rules execute with the same actions as if a stream event had triggered them.
  • You can reorder buttons by dragging them in the VMSC desktop rule list and enabling Sort > Mobile Order.

Chat Tab — Live Monitoring

The Chat tab shows a real-time feed of chat messages from all connected platforms.

  • Messages are color-coded by platform (e.g., pink for TikTok, purple for Twitch).
  • Tap a message to see user details (username, follow status, subscriber status).
  • Use the filter bar at the top to show messages from a single platform or search by keyword.
  • Chat is read-only from the mobile interface — you cannot send messages.

Stats Tab — Session Data

The Stats tab provides a summary of the current streaming session.

  • Viewer count — current and peak viewers (per platform and total).
  • Event counters — total gifts, follows, subscriptions, and cheers received since the session started.
  • Revenue estimate — approximate monetary value of gifts and donations across all platforms.
  • Session duration — how long each platform connection has been active.
  • Stats update in real time over the WebSocket connection.

Cloudflare Tunnel Auto-Provisioning

For remote access (when your phone is not on the same network as your PC), VMSC can automatically provision a Cloudflare tunnel.

  1. In Settings > General > Mobile Stream Deck, toggle Enable Remote Access.
  2. VMSC starts a cloudflared tunnel in the background. No Cloudflare account is required — it uses a quick tunnel.
  3. A public URL appears (e.g., https://random-words.trycloudflare.com). Use this URL from any network.
  4. The PIN is still required for authentication.
Tunnel lifecycle

The tunnel starts when VMSC launches and stops when VMSC closes. The public URL changes each time a new tunnel is provisioned. For a stable URL, configure a custom Cloudflare tunnel with your own domain in Cloudflare Tunnel Setup.

Tips for Mobile Use

  • Add to Home Screen: In your mobile browser, use the "Add to Home Screen" option for a full-screen, app-like experience.
  • Keep the screen on: Enable your phone's "Stay Awake" or "Screen Always On" setting during streams so you don't have to unlock to trigger rules.
  • Use a phone stand: Mount your phone next to your streaming setup for quick access to controls without picking it up.
  • Limit buttons: Only enable Mobile Trigger on the rules you actually need during a stream. Too many buttons make it hard to find the right one quickly.
  • Test the PIN flow: Before going live, open the URL on your phone and confirm the PIN entry works smoothly.
  • Battery saver: The WebSocket connection uses minimal data and battery, but closing the browser tab disconnects the session. Reopen and re-enter the PIN to reconnect.