SeenCast Setup guide

Setup guide

Get your screen playing in 60 seconds.

Every screen — a $30 Android box, a smart TV, a laptop, a SeenLabs LED display — runs the exact same player at one address. Open it, read off a six-character code, pair it in the studio. The sections below just cover how to make each type of device open that address by itself and never close it.

1

Open the player

On the screen, point any browser at:

https://play.seencast.app
2

Read the code

The player shows a six-character pairing code full-screen, with a QR code that links straight to the same pairing page.

3

Enter it in the studio

Add a screen in the studio and type the code — or scan the QR from a phone.

https://app.seencast.app

Landscape or portrait is set per screen in the studio, not on the device — the player rotates itself to match. There's nothing to configure locally for orientation.

By device

Configure the box, stick, or screen you're using.

Same player behind every tab — the difference is only how each device keeps a browser open and awake.

Android box / LedArt LED controller

For any unattended Android box — including LedArt LED controllers, which run stock Android under the hood — install the SeenCast Player app. It's a purpose-built kiosk shell: it opens the player fullscreen, keeps the screen awake, comes back by itself after a reboot or a crash, and can't be accidentally closed. The Fully Kiosk route below still works if you'd rather not install an app.

Recommended Install the SeenCast Player app

Download the app (.apk)

Or open play.seencast.app/downloads/seencast-player.apk directly on the box.

QR code linking to the SeenCast Player app download Scan to download
  1. On the box, allow app installs from outside the Play Store: Settings → Security → Install unknown apps (or the prompt that appears when you open the file), and turn it on for whatever downloaded the APK — the browser or file manager.
  2. Open the downloaded seencast-player.apk and tap Install, then Open. The player fills the screen and shows a pairing code.
  3. Enter that code in the studio, the same as any other device. Done — nothing else to configure for fullscreen, keep-awake, or crash recovery; the app handles all of it.
  4. Turn on autostart. Most stock boxes relaunch on boot automatically. Some vendor skins (Xiaomi, Oppo, Vivo, Huawei, and a few LedArt firmwares) also require a per-app toggle — find SeenCast Player under Settings → Apps → Autostart (or Battery → Auto-launch) and enable it.

To point a box at a staging build, long-press the top-left corner of the screen — a hidden dialog lets you change the player URL. Leave it on the default for production screens.

Fallback Fully Kiosk Browser (no app install)

Use this if you can't install the app — e.g. a locked-down box, or one where you prefer a general kiosk browser you already deploy. Fully Kiosk wraps the same URL.

  1. Install Fully Kiosk Browser (or any kiosk-mode browser app) from the Play Store. If the box has no Play Store, sideload the APK from a USB drive.
  2. Open Fully Kiosk Browser → Settings → Web Content Settings → Start URL → set it to:
    https://play.seencast.app
  3. Settings → Device Management → enable Autostart on Boot.
  4. Settings → Device Management → enable Keep Screen On (or, under Android's own Settings → Display → Sleep, set it to Never if Fully Kiosk doesn't expose the option).
  5. Reboot the box once to confirm it comes straight back to the player — no launcher, home screen, or remote control needed in between.

LedArt controllers use this exact flow — the vendor's Android skin doesn't change any of these five steps.

Android TV / Fire TV

TV operating systems are more locked down than a bare Android box — treat this as a fallback rather than the first choice for permanent installs.

  1. Install a browser app. On Fire TV, sideload one using the Downloader app if it isn't already in the Amazon Appstore; on Android TV, most browsers install directly from the Play Store.
  2. Open the browser and navigate to:
    https://play.seencast.app
  3. If the browser supports it, set this as its home page or default launch page so it reopens there after any restart.
  4. Disable the sleep / screen-saver timeout in the TV's system settings — look under Settings → Device Preferences → Sleep (Android TV) or Settings → Display & Sounds (Fire TV).

Neither platform ships a true kiosk mode — a stray remote press can back out to the home launcher. For anything unattended and permanent, prefer a dedicated Android box running Fully Kiosk (previous tab) over a TV's own OS.

Samsung / LG smart TV (built-in browser)

This is the least reliable option. Built-in browsers on Tizen (Samsung) and webOS (LG) generally can't be forced to autostart on power-on, and some restrict background playback after the input is switched.

  1. Open the TV's built-in browser — Samsung Internet on Tizen, or the webOS browser on LG.
  2. Navigate to:
    https://play.seencast.app
  3. Enter the code shown, the same as any other device.

Recommended instead: plug a small Android stick or box into the TV's HDMI port and follow the Android box setup — a five-minute swap that turns an unreliable TV browser into a self-recovering kiosk.

Any PC or Mac

Good for demos and short-term setups. For permanent signage, prefer a dedicated Android box — a general-purpose desktop OS updates and reboots itself without a login.

  1. Open Chrome, Edge, or Safari and navigate to:
    https://play.seencast.app
  2. Press F11 (Windows/Linux) for fullscreen. On a Mac, use the green fullscreen button or Cmd + Ctrl + F.
  3. Windows: add a shortcut with --kiosk https://play.seencast.app to the Startup folder so it launches straight into the player on boot.
  4. macOS: add the browser under System Settings → General → Login Items, then re-open the fullscreen tab after login — macOS doesn't restore fullscreen state automatically.

SeenLabs LED displays

Nothing to do here. Every SeenLabs LED display ships pre-configured — the player is already installed, paired, and set to autostart before it leaves the warehouse.

If a SeenLabs panel isn't showing content, it's not a setup issue — email [email protected] and we'll take a look remotely.

If something looks wrong

Troubleshooting.

The player is built to fail quietly and recover on its own — most of what looks like a problem is expected behavior.

The screen is just black.
Check the network connection first, but note that the player is built to keep playing its last cached content even while offline — stale beats black, by design. So a genuinely black screen on a device that's been running before usually means it never finished its first pairing or its first cache download, not a dropped connection. Power-cycle the device and double-check the start URL is exactly https://play.seencast.app, with no typos and nothing appended.
The pairing code says it's expired.
Pairing codes are short-lived on purpose. Refresh the page (or power-cycle the device) to get a fresh code, then enter that one in the studio.
The screen went back to a pairing code after running fine.
Its access token was revoked — usually because the screen was removed from the studio, or re-paired from somewhere else. Just pair it again with the new code; playback resumes as soon as it's bound.
The screen blinks or reloads once a day.
That's expected. Each player reloads itself once, during a quiet overnight window (around 4am local time, staggered per device so a whole fleet doesn't blink at once) to clear memory on weaker hardware — not a malfunction, and it resumes exactly where the schedule says it should.