Obscreen Docs

Appearance

Browser ​

You can use any modern web browser to run the Obscreen Player. Simply open the player URL in your preferred browser—no extra software installation is required. Be aware that some browsers may not support all HTML5 features, so you may experience some issues with video playback for example.

Some browsers may require you to use specific flags to run the player. For example, Chromium requires you to use the --autoplay-policy=no-user-gesture-required flag to allow video autoplay. We provide some examples below for Chromium in a linux environment.

Chromium Browser (in a linux environment) ​

When you run the browser yourself, don't forget to use these flags for chromium browser:

Important

Sometimes chromium command is named chromium or chromium-browser.
Don't forget to replace <YOUR_STUDIO_URL> with your central Server Studio instance url.

bash
chromium \
  --disk-cache-size=2147483648 \
  --disable-features=Translate \
  --ignore-certificate-errors \
  --disable-web-security \
  --disable-restore-session-state \
  --autoplay-policy=no-user-gesture-required \
  --start-maximized \
  --allow-running-insecure-content \
  --remember-cert-error-decisions \
  --noerrdialogs \
  --single-process \
  --kiosk \
  --incognito \
  --window-position=0,0 \
  --window-size=1920,1080 \
  --display=:0 \
  <YOUR_STUDIO_URL>

Host Identification Configuration ​

To help you identify and locate your device, you can set the following metadata in url's query parameters

Example:

https://<STUDIO_PLAYLIST_URL>/?hostname=My%20Device&icon=auto&longitude=48.8566&latitude=2.3522`

Screen Flags ​

These are information about the screen resolution and rotation.

bash
rotate=normal # normal, left, right, inverted
resolution=auto # 1920x1080, 1920x1080, 1920x1080, 1920x1080

Name & Icon ​

bash
hostname="My Device"
icon=auto # any font-awesome icon name (i.e. fa-desktop, fa-laptop, fa-tablet, fa-mobile, fa-tablet-alt, fa-mobile-alt)

Search for icons

You can browse the free icon catalog here.

Positioning ​

Choose one of the following options from more precise to less precise location:

1. Precise positioning ​

bash
longitude=
latitude=

2. Structured address-based positioning ​

bash
street=
city=
state=
country=
postal_code=

3. Query address-based positioning ​

bash
address_query= # (e.g. "1600 Pennsylvania Avenue NW, Washington, DC 20500")

See more about customizing the player's URL here.

Playlist Configuration ​

Just open your web browser and either go to:

Playlist URL

To connect the player to a specific playlist using its ID
http://<STUDIO_URL>/use/<playlist_id>

Playgroup URL

To connect the player to a specific playgroup using its ID
http://<STUDIO_URL>/group/<playgroup_id>