Raspberry Pi Augmented TV Show player

Note:

• This is meant to be used with my gui controller !

Hardware prerequisites:

• Raspberry Pi
• SD Card
• SD Card Reader

Preparation

1. OS Installation

• Download the latest Berry OS image here : https://github.com/0rax/BerryOS/releases

• Flash the OS Image using tools like Rufus/Raspberry pi Imager/Custom imager

  • Rufus: https://rufus.ie/en/
  • Raspberry Pi Imager https://www.raspberrypi.com/software/
  • XZcat + dd on linux : Please may attention to the name of the file and the dev node of the sd card

2. Configuration

• Download raw configuration files into the "boot" partition ( or detected as "boot" drive on Windows) of the SD Card. Remember to save the files raw without any extension

  • network-config
  • user-data

• Modify the contents of user-data as needed

  1. Device hostname (user-data)

  

  2. Password for user pi (user-data)

  

  3. Modify ssid for wireless connection (network-config)

  

3. IP Address / DNS Hostname (Optional)

• The MAC Address (which is needed for fixed local ip) can be obtained on first boot or via the network admin control panel. (Please refer to someone in the know)

Initial boot

• It is strongly recommended to use ethernet connection to reduce the hassle when setting up the device.
• Internet connection is required to set up the device on initial boot, either whitelist the device on wireless connection, or use ethernet to bypass the network restrictions. Should there be any problems, you may reset the initial setup by doing :

  sudo cloud-init clean --logs
  sudo reboot

Notes

• Video File Location folder: /opt/tv_video/videos
• Default remote connection :
  • ssh :
    • user : pi
• VLC Playback control
  • To access the CLI Interface, kindly ssh into the machine then perform screen -r. This will attach the current terminal into a GNU Screen session.
  • To exit/detach (without killing) the the gnu screen session and return to the bash terminal, press and hold <ctrl> + a, then d

Limitations

• Video encoding : 1080p/H.264 encoding (raspberry pi's do not have that much support for other encodings)
• To work around the blocking of system-networkd waiting for network to be online run systemctl mask systemd-networkd-wait-online

Used software

• VLC Media player
• GNU Screen
• cec-utils
• rsync