Obscreen Docs

Appearance

Generic Smart TV ​

For any Smart TV without a dedicated Obscreen Player app. The TV runs the player through its built-in web browser.

Got a supported brand?

If your TV is one of the following, prefer the native app: better performance, kiosk mode, auto-recovery and no need for a working browser on the panel:

How it works ​

Smart TVs equipped with a web browser can act as a player by simply opening the playlist URL.

Browser limitations

Some Smart TV browsers are old WebKit forks and may not support all modern HTML5 features. You may experience reduced video codec compatibility, missing CSS features or autoplay restrictions. For best results, plug an external player (Fire TV Stick, Android TV box, Raspberry Pi…) into an HDMI input.

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 the TV's 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>