Commit 75657471 authored by birk's avatar birk
Browse files

complete installation insructions

parent 4d7ad5b3
......@@ -3,8 +3,68 @@ Sender Medienarchiv der Künste
## System installation
## Setting player up as a `systemd` service
Install Ubuntu 16.04 LTS.
In *Settings > System > Details* change the device name to `nipkow`. In *Settings > User* create a main admin user `itz` with automatic login enabled. In *Settings > Brightness & Lock* disable the screen saver.
In the Terminal update the system and change the keyboard layout.
sudo apt-get update
sudo apt-get install unattended-upgrades
setxkbmap ch
Install necessary software.
sudo apt-get install python3-pip pythin-pyglet virtualenvwrapper git supervisor openssh-server samba-common-bin
Add your own public key form remote access to `~/.ssh/authorized_keys`.
## Player installation
Create a virtual environment.
mkvirtualenv --python=/usr/bin/python3 broadcaster
echo "source /usr/share/virtualenvwrapper/" >> ~/.bashrc
echo "workon broadcaster" >> ~/.bashrc
Create a SSH key pair for the machine and add the public key here as a deploy key: [](
identityfile ~/.ssh/id_rsa
to `~/.ssh/config`.
Clone the repository and install python packages.
git clone
cd madek-broadcaster
pip3 install -r requirements.txt
Install `libav` from `dependencies/ubuntu/` or [](
Copy `monitors.xml` (the config file for the screens) to `~/.config/` and change the permissions to `755`.
Duplicate `player/` as `player/` and change the values of `user` and `password`.
Run the software manually via `python player/`.
## Setting player software up as a `systemd` service
This ensures that the player software starts automatically after startup and possible crashes.
Create directory `~/.config/systemd/user` and copy `service/player.service` there.
Enable the service: `systemctl --user enable player.service`
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment