This guide will assist in the initial setup of both OBPlayer and OBServer backend application infrastructure. Once these applications are setup and running, proceed to the Quick Start for provisioning instructions.
|Processor||1GHz 64 bit CPU. ARM, Intel or Pi|
|Memory||4GB of RAM|
|Display||No display is required for the web server|
|Framework||PHP, MySQL, Nginx and Gstreamer|
Recommended. Should be a *nix system. Debian 10 or Ubuntu 20.04 LTS. Runs as a process on CLI in a VM. The exact requirements will depend on the specific way OBServer is used, and the load from users.
|Processor||1GHz 64 bit CPU. ARM, Intel or Pi|
|Display||None required unless displaying Video or Images|
|Audio||Analog Input\Output, USB Interfaces or Digital HDMI\DisplayPort|
|Video||Minimum 640x480 screen resolution|
|Framework||Python and Gstreamer|
Recommended. Should be a *nix system. Debian 10 or Ubuntu 20.04 LTS. Runs as a process on CLI in a VM. Desktop is optional.
OpenBroadcaster - OBServer Installation Instructions These instructions are an alternative to using ob.installer.sh Note: When using special characters in the password, they need to use single quotes instead of double quotes when they echo the string. 1. See dependencies.txt for server dependencies. Mostly PHP/MySQL related, but a few things to support transcoding and media identification. 2. Copy server files to a web environment (web document root). 3. Import db/dbclean.sql to a database. 4. Copy config.sample.php to config.php, Edit as necessary. 5. Ensure media storage directories are writable by the web server. 6. In the web document root, create 'assets' and 'assets/uploads' directories writable by the web server. 7. The database import includes one user. username is admin. The password must be updated. /var/www/observer/tools/cli/ob passwd <username> 8. Check for available updates to verify your installation and apply any required updates. /var/www/observer/tools/cli/ob updates run OpenBroadcaster CLI Tool. Run ob <command>. Commands: check check installation for errors cron run run scheduled tasks updates list list available updates updates run run available updates passwd <username> change password for user For advanced instructions see https://support.openbroadcaster.com/install Pre 5.3 Branch Instructions *** After install, set OB_UPDATES_USER and OB_UPDATES_PW in config.php and then run https://YOUR_IP/updates ***
apache2 apg festival imagemagick libav-tools libavcodec-extra libavfilter-extra mysql-server php7.0 php7.0-mysql php7.0-mbstring php7.0-xml php7.0-gd php7.0-curl php7.0-imagick vorbis-tools
** If libav-tools package is not available, install ffmpeg package instead, and symlink the following:
ln -s /usr/bin/ffmpeg /usr/local/bin/avconv ln -s /usr/bin/ffprobe /usr/local/bin/avprobe
CLI Running Updates
CLI Check without errors
CHECK FOR UPDATES Prior to reporting issues to ensure the most current version is running
Assuming your DNS is configured, you should be able adjust ob.apache.conf to your system and copy it to the appropriate spot for your machine, restart apache, and browse to //Your_IP/ to access your server. Login in with username admin and the password you set for the Admin user.
OBPlayer Installation Instructions 1. See dependencies.txt for player dependencies (Debian 10/Ubuntu 20.04 & above) 2. Run "bash obplayer_check" or "bash obplayer_loop" or "bash obplayer_check -h" for help 3. Config files settings.db generated on first run in ~/.openbroadcaster 4. Admin panel http://<IP_of_Player>:23233 default user = admin default password = admin 5. Configure tabbed menus 6. Restart the player NOTE:User required to change login passwords on first login using the defaults. Connect RJ45 to a network with a router handing out DHCP IP addresses. For advanced instructions see https://support.openbroadcaster.com/install
ntp python3 python3-pycurl python3-openssl python3-apsw python3-magic python3-dateutil python3-requests python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-gdkpixbuf-2.0 gir1.2-pango-1.0 python3-gst-1.0 gir1.2-gstreamer-1.0 gir1.2-gst-plugins-base-1.0 gir1.2-gst-rtsp-server-1.0 gstreamer1.0-tools gstreamer1.0-libav gstreamer1.0-alsa gstreamer1.0-pulseaudio gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly ffmpeg
Extras (not installed with Apt)
Needed for SSL dashboard
pip3 install passlib[bcrypt]
Needed in case it wasn’t installed with Apt
pip3 install apsw
Recommended for CATV Video Playout
CAP Alerting onboard TTS
espeak mbrola mbrola-en1 mbrola-us1 mbrola-us2 mbrola-us3 mbrola-fr1 mbrola-fr4
POLLY AWS Voices in the alerts module
pip3 install boto3
RS-232 trigger option in the alerts module
Sharing multiple OBPlayers with a local media library
Command Line tool for PulseAudio
pip3 install pulsectl
Off-air audio log and SDR FM Receiver USB Dongle
pip3 install pyrtlsdr
Include if using the news feed override
pip3 install inotify
Note: pip3 pkg not included in apt-get; must be installed using pip3
NOTE Utilities for displaying current version and updating the Player are on the Admin Page of the Dashboard.
Updating the software ensures the most current version of the application is running. To obtain and install updates, click the Update button in the dashboard Admin menu. After updating the Player, restart the Player to the load changes to the Dashboard.
Player is up to date
Open Terminal and from your home directory run:
Then go to this directory
In the empty target/installation directory run
sudo git clone https://github.com/openbroadcaster/obplayer.git ./
Defaults to Main Branch
Change Branch during install
sudo git clone -b develop https://github.com/openbroadcaster/obplayer.git ./
Example using -b (develop branch)
2FA (2 Factor Authentication)
You’ll need to have a key setup on target machine and run
git clone firstname.lastname@example.org:openbroadcaster/obplayer.git
git clone -b develop email@example.com:openbroadcaster/obplayer.git
OBPlayer is now setup with latest code ready to use
From the install directory EG
bash obplayer_loop -d
using -d (debug) displays useful start up info
TechTip Resetting Lost or Admin passwords cannot be retrieved easily. Config files containing user and machine settings are located in the hidden ~/.openbroadcaster folder within the users home directory. To reset admin or lost passwords may be recovered by editing the sqlite DB file
settings.db or simply deleting it and restarting obplayer. On restart obplayer will recreate this DB with default values and prompts for new passwords.
Find a bug? Want to request a feature? Submit your issue to OBServer or OBPlayer
Have some Gstreamer, PHP or Python coding skills? Help Contribute and Sponsor to make the OpenBroadcaster community even better
We really appreciate your feedback!