Kiosk and touch display hardening
Lock down Chromeboxes, Fire TVs, and Raspberry Pi displays so the public can't escape to the browser or OS.
Public-facing signage needs to survive curious visitors. Here are the configurations we recommend for each supported device.
Chrome OS (managed kiosk)
The cleanest option if you already manage Chromebooks through the Google Admin console.
VenueOS has no separate Chrome app to install — the player is a web page, https://venue-os.app/player, and Chrome OS can run a web page as a kiosk.
- In the Google Admin console, go to Devices → Chrome → Devices.
- Enroll the Chromebook or Chromebox into a dedicated Kiosk OU.
- Under Apps & extensions → Kiosks, add a kiosk web app by URL and enter
https://venue-os.app/player. - Set Auto-launch kiosk app to that web app.
- Reboot the device. It opens straight into the VenueOS player and shows a 6-character pairing code. Pair it from Screens → Pair Screen in the dashboard, once.
The pairing is kept in the device's browser storage, so the screen stays paired across restarts. Don't run the player in Guest or other wipe-on-exit modes — the screen would ask to be paired again after every restart.
Disable developer mode at the hardware level with a cr50 lock if possible.
Amazon Fire TV
- Install the Silk browser or Firefox.
- Navigate to
https://venue-os.app/playerand pair. - Use an Android kiosk app (e.g. Fully Kiosk Browser) to lock the home button.
- Disable the Alexa button on the remote.
Raspberry Pi (Chromium kiosk)
- Use Raspberry Pi OS Lite with Chromium installed.
- Set Chromium to autostart in
--kioskmode with--noerrdialogs --disable-infobars --app=https://venue-os.app/player. On first start the screen shows a pairing code — pair it from the dashboard once. Don't add--incognito: it wipes the pairing on every reboot. - Use
xset s off; xset -dpms; xset s noblankto disable screen blanking. - Put the Pi behind a locked enclosure — curious hands will unplug things.
Touch displays
VenueOS player respects touch input when the current template has tappable widgets (wayfinding, menus, directories). To allow or restrict touch:
- Set the Interactive flag per template in the builder
- Non-interactive templates ignore touch to prevent accidental navigation
For ADA: don't mount touch displays higher than 48" from the floor (reachable from wheelchair).
Network and content filtering
Allowlist in your network's content filter. Three of these are separate hosts — get all three, or you will hit failures that look like a broken screen rather than a blocked request:
- The dashboard and player —
venue-os.appand*.venue-os.app, port 443 - The VenueOS API, including its WebSocket — this is a different host from the dashboard. Its address is the API URL configured for your deployment — a Super Admin can read the exact value under Settings → Advanced → API keys & webhooks, in the About this workspace section, shown as API address. Allow both
https://andwss://on that host. A filter that permits the dashboard but blocks this host is the classic "screen sits on Connecting…" cause, and it also blocks the realtime emergency channel — alerts then arrive only on the slower HTTP polling path. - Uploaded assets — served from your VenueOS storage host, not from a
venue-os.appCDN. Copy the hostname out of any asset's URL in the Assets library; on standard deployments it is a*.supabase.coaddress. Miss this one and templates render with every image and video missing. - Any third-party widget sources you enable (RSS feeds, weather APIs)
Preventing easy takedowns
- Physical: mount displays 8+ feet up in public areas. Use VESA-compatible locking mounts.
- Power: PoE-powered devices can be remotely rebooted via your switch.
- Remote control: the dashboard's Screens → Actions → Restart pushes a reload signal to the screen over WebSocket. Faster than walking to each one.
More in Screens
How to pair a new screen
Turn an Android display, media player, Chromebook, or any browser-capable screen into a VenueOS display in a few minutes.
Organizing screens with screen groups
Target dozens of displays with one schedule by grouping them by location or purpose.
Playlists, schedules, and what plays where
Build a playlist, publish it to screens or groups, schedule it for certain days and times, and see what happens when two playlists want the same screen.