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)

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 Resolution configuration

Screen resolution is set in file var/run/play under variable TARGET_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 TARGET_RESOLUTION=auto with your preferred resolution. (e.g. TARGET_RESOLUTION=1920x1080)

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://<your_studio_server_instance>:5000/use/<playlist_id>

Playgroup URL

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