Obscreen Docs

Appearance

Browser ​

Browser is the core of any Obscreen Player and you only need a web browser to run it. Be aware that some browser doesn't support all HTML5 features, so you may experience some issues with video playback.

Chromium browser ​

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:

<STUDIO_URL>?hostname=My%20Device&icon=auto&longitude=48.8566&latitude=2.3522`

Screen Flags ​

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)

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")

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>