Obscreen Docs

Appearance

Linux ​

Hardware ​

Anything with enough RAM (cause chromium is not so lightweight) will be ok.

Software installation ​

We're about to install obscreen-player on your Linux device. It consists of a long running systemd service and a script that will install chromium, x11, pulseaudio on your device.

Log into your Linux device locally or via ssh (by default it's ssh your_user_name@your_host_name)

Install player autorun by executing following script (will install chromium, x11, pulseaudio and obscreen-player systemd service)

bash
curl -fsSL https://raw.githubusercontent.com/obscreen/obscreen/master/system/client/install-client-player.sh -o /tmp/install-client-player.sh && chmod +x /tmp/install-client-player.sh && sudo /bin/bash /tmp/install-client-player.sh $USER $HOME

If previous script successfully finished, then restart your device by executing sudo reboot

How to restart ​

Just use systemctl by executing sudo systemctl restart obscreen-player.service

Screen configuration ​

Screen configuration is set in file [obscreen-player-dir]/var/run/play under these variables:

SCREEN_RESOLUTION ​

You can change it by editing the file and fill it with a supported resolution To get the list of supported resolutions just run: DISPLAY=:0 xrandr Then replace SCREEN_RESOLUTION=auto with your preferred resolution. (e.g. SCREEN_RESOLUTION=1920x1080)

SCREEN_ROTATE ​

Possible values are:

  • For 0° set: normal
  • For 90° set: left
  • For 180° set: right
  • For 270° set: inverted

Host Identification configuration ​

To help you identify and locate your device, you can set the following metadata in [obscreen-player-dir]/var/run/play file:

Name & Icon ​

bash
CLIENT_HOSTNAME="My Device"
CLIENT_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
CLIENT_LONGITUDE=
CLIENT_LATITUDE=

2. Structured address-based positioning ​

bash
CLIENT_STREET=
CLIENT_CITY=
CLIENT_STATE=
CLIENT_COUNTRY=
CLIENT_POSTAL_CODE=

3. Query address-based positioning ​

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

Playlist configuration ​

Playlist URL is set in file var/run/play under variable STUDIO_URL. You can change it by editing the file and fill it with either:

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>