An application to turn your Raspberry Pi into a dedicated looping video playback device. Can be used in art installations, fairs, theatre, events, infoscreens, advertisements etc...
Works right out of the box, but also has a lot of customisation options to make it fit your use case. See the video_looper.ini configuration file for an overview of options.
If you miss a feature just post an issue here on Github. (https://github.com/adafruit/pi_video_looper)
Currently only the Legacy version of Raspberry Pi OS Lite is supported.
The last working image is this one:
https://downloads.raspberrypi.com/raspios_oldstable_lite_armhf/images/raspios_oldstable_lite_armhf-2022-01-28/2022-01-28-raspios-buster-armhf-lite.zip
For a detailed tutorial visit: https://learn.adafruit.com/raspberry-pi-video-looper/installation
There are also pre-compiled images available from https://videolooper.de (but they might not always contain the latest version of pi_video_looper)
alsa in video_looper.ini. A new config key alsa.hw_device can be used to specify a non-default output device.alsa.hw_vol_file and alsa.hw_vol_control can be used to set the output device volume in a text file provided with the videos.sound_vol_file functionality can now be disabled by leaving the config value empty.playlist.path. It can be absolute, or relative to the file_reader's search directories (directory: path given, usb_drive: all USB drives' root).#EXTINF directive); see next point.
If something goes wrong with the playlist (file not found etc.) it will fall back to just play all files in the file_reader directory. (enable console_output for more info)Support for video titles (omxplayer only).
Can display a text on top of the videos.
To be enabled by config key omxplayer.show_titles.
Without a playlist file, titles are simply the videos' filename (without extension).
If an M3U playlist is used, then titles come from the playlist instead.
An easy way to create M3U files is e.g. VLC. For an example M3U file see assets/example.m3u
major new feature: copymode
files will be copied from the usb stick to the player (with fancy progress bar)
you can choose if the current files should be deleted beforehand (replace mode is default)
or if files from the stick should be added (add mode)
the copymode is protected with a "password" which is represented with a file on the drive (set it via the video_looper.ini
for more infos see "copymode explained below"
advanced playlist feature: add _repeat_Nx to any filename (N is a positive integer) and file will be looped that many times (additional infos see below)
added reload.sh to restart the looper and reload the settings from the ini
sudo apt-get install git
cd ~
git clone https://github.com/adafruit/pi_video_looper
cd pi_video_looper
sudo ./install.sh
Default player is omxplayer. Use the no_hello_video flag to install without the hello_video player (a bit faster to install):
sudo ./install.sh no_hello_video
An update is always like a fresh installation so you will loose custom changes made to the /boot/video_looper.ini
For backing up the current ini:
sudo cp /boot/video_looper.ini /boot/video_looper.ini_backup
For the update:
cd ~
sudo rm -rf pi_video_looper
git clone https://github.com/adafruit/pi_video_looper
cd pi_video_looper
sudo ./install.sh
To change the settings of the video looper (e.g. random playback, copy mode, GPIO control, advanced features) edit the /boot/video_looper.ini file, i.e. by quitting the player with 'ESC' and logging in to the Raspberry with an attached keyboard, or remotely via ssh. Then edit the configuration file with sudo nano /boot/video_looper.ini.
Alternatively insert the SD card into your computer and edit it with your preferred text editor.
By default, the looper plays any video files from a USB drive in alphabetical order. With copymode, you only need a USB drive once, to copy the video files directly onto the RPi's SD card. Once enabled in the video_looper.ini, all files from an attached USB drive are copied onto the RPi. A progress bar shows you, well, the progress of the operation.
To protect the player from unauthorised access you need to create a file on the drive called "videopi". The extension doesn't matter. This file acts as a password. (The wording of this "password" can be changed in the video_looper.ini)
You might also want to decide if new files on the drive should replace existing files or get added. "Replace" means that any existing videofiles on the RPi get deleted, and only the new files remain.
This setting can be overruled by placing a file named "replace" or "add" on the drive.
The default mode is "replace".
Note: files with the same name always get overwritten.
you can have one video repeated X times before playing the next by adding _repeat_Nx to the filename of a video, where N is a positive number
if you have only one video then omxplayer will also loop seamlessly (and with audio)
to reduce the wear of the SD card and potentially extend the lifespan of the player, you could enable the overlay filesystem via raspi-config and select Performance Options->Overlay Filesystem
The video looper can be controlled via keyboard input or via configured GPIO pins.
Keyboard control is enabled by default via the keyboard_control setting in the video_looper.ini file.
The following keyboard commands are active by default (can be disabled in the video_looper.ini):
To enable GPIO control you need to set a GPIO pin mapping via the gpio_pin_map in the control section of the video_looper.ini.
Pins numbers are in "BOARD" numbering - see: https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#gpio. Bridge a mapped pin with a Ground pin to trigger it.
The pin mapping has the form: "pinnumber" : "action”. The action can be one of the following:
+n or -n (with n being an integer) for a relative jumpHere are some examples that can be set:
"11" : 1 -> pin 11 will start the second file in the playlist"13" : "4" -> pin 13 starts the 5th video"16" : "+2" -> pin 16 jumps 2 videos ahead"18" : "-1" -> pin 18 jumps one video back"15" : "video.mp4" -> pin 15 plays a file with name "video.mp4" (if it exists)"19" : "K_SPACE" -> pin 19 sends the "space" keyboard command, pausing the current video"21" : "K_p" -> pin 21 sends "p" keyboard command and thus triggers the shutdown of the Raspberry PiFor your convenience, these exact mappings can be easily enabled by uncommenting the example line in the video_looper.ini. You can also define your own mappings.
Note: to be used as an absolute index the action needs to be an integer not a string. Note 2: "keyboard_control" needs to be enabled in the ini for gpio to utilise keyboard commands.
/var/log/supervisor/. Enable detailed logging in the video_looper.ini with console_output = true.sudo tail -f /var/log/supervisor/video_looper-stdout* and sudo tail -f /var/log/supervisor/video_looper-stderr* to view the logs.