Getting Started

Power on, get on WiFi, open the web UI, and walk through a recommended setup order. Everything you do beyond this point is configuration that survives reboots and is portable between boards via JSON export/import.

First Boot & Initial WiFi Setup

On first power-on (or after a factory reset), Venue Commander has no WiFi credentials. It automatically starts in Access Point (AP) mode so you can configure WiFi from any device with a browser.

What the display shows

Captive portal WiFi setup on the touchscreen
Captive portal WiFi setup — shown on the touchscreen and served to connected clients at http://192.168.4.1/wifi

The touchscreen shows a setup page with:

Connecting to the setup network

  1. On your phone or laptop, look for an open WiFi network named venue (or the device's custom hostname if previously set).
  2. Connect to it. There is no password on the AP network.
  3. A captive portal should automatically open. If it doesn't, navigate to http://192.168.4.1/wifi in your browser.

Configuring WiFi

  1. The portal shows the same WiFi setup page as the touchscreen. Select your target network from the scan results, or type the SSID manually.
  2. Enter the WiFi password.
  3. Click Save & Restart.
  4. The device reboots and attempts to connect to the specified network. If successful, the touchscreen shows the assigned IP address in the status bar.

If WiFi connection fails

If the device can't connect to the saved network (wrong password, out of range, etc.), it falls back to AP mode again after the timeout period. Reconnect to the AP network and try again.

The IP address shown on the touchscreen status bar is the easiest way to find the device on your network. You can also use http://venue.local if your network supports name lookups for local devices. If you've changed the hostname in the Device tab, replace venue with your new name (e.g. http://studio-a.local).
On the Waveshare 7″ (P4) board with a connected Ethernet cable, the device prefers Ethernet first. If the wired Ethernet port gets a network address within 8 seconds, the WiFi radio stays idle and AP mode is not started.

Accessing the Web UI

Once your device is connected to WiFi (or Ethernet on the 7″ board), you can access the full web UI from any other device on the same network.

  1. Open a browser and go to http://venue.local, or http://<device-ip>. The IP address is shown on the touchscreen status bar. If you've renamed the device, use the new hostname (e.g. http://studio-a.local).
  2. If a web password has been configured, enter your credentials when prompted (username: admin).

The web UI has these tabs: Status, WiFi, Devices, HA (Home Assistant connection + bindings), Layout, Theme, Gangs, Device (the touchscreen's own settings), Audio (when an audio board is attached), and Update.

The web UI is only reachable from devices on your local network. The touchscreen ignores connections from the wider internet, so even if your router accidentally exposes the device, no one outside your network can open the web UI.
Until you set a web password (Device tab), the default is venue123 with username admin. Change it before the device is on a network with anyone you don't trust.

Tab Status

Status tab in the web UI
Status tab — device info, endpoint health, and Live Preview

The Status tab is the landing page when you open the web UI. It provides:

Device Status

Connection info, IP address, firmware version, free memory, and endpoint health (OSC, Shelly, Home Assistant, and the optional audio board) at a glance.

Live Preview

A real-time screenshot of the touchscreen display, rendered as an image in your browser. Use the Refresh button to manually update, or tick Auto (2s) to auto-refresh every two seconds.

Use the live preview to verify your layout looks correct without physically being near the display.

Quick Start: Setting Up From Scratch

Recommended order for configuring a new Venue Commander:

Once configured, the touchscreen is ready to use as a remote control. Use the Status tab's Live Preview to verify your layout remotely at any time.

Export your layout as a backup before making changes or updating firmware. Layout exports are portable between boards — you can move a layout from a 4.3″ touchscreen to a 7″ one (or vice versa) and everything works the same way.
Want to see a complete real-world configuration? See the Working Example — a 3-page QLab + Behringer Wing layout you can import.