Video player for artists by artists
VideoPi is a simple video player specifically designed for art installations. It is a Linux distribution for the Raspberry Pi mini computer.
Commonly used media players don’t accept all video formats, require configuration to turn on looping, and need to be manually switched on.
VideoPi solves these problems:
- it supports virtually any video format
- it plays all video files from a USB stick in a loop
- it turns on automatically when connected to power
- it supports both HDMI and S-Video output
- Raspberry Pi 2 Model B
- Raspberry Pi 3 Model B
- Raspberry Pi 1
- Raspberry Pi 3 Model B+
Latest version 2018-09-04
- partial Raspberry Pi 3 Model B+ support (audio only)
Stable version 2018-01-02
- Download and install Etcher.
- Open Etcher and write the downloaded VideoPi image to your SD card.
Support and getting involved
If you have an idea on how to improve VideoPi or if you need help using it, send us an email to:
Also please let us know if you’re in Berlin or Prague and have a Raspberry Pi 3 Model B+ to lend out. We would like to test VideoPi on it.
If you don’t feel like installing VideoPi yourself, we can
- lend you a VideoPi (or two, or a dozen) for a daily price for as long as you need,
- or we can sell it to you, so it will be yours and yours only forever.
In either case, we will help you with the initial setup.
Make sure the HDMI or S-Video cable is connected before you power on VideoPi.
When started for the first time, VideoPi will show a message that it’s resizing the root partition and then it will restart automatically. After that a login prompt will appear for a few seconds. Do nothing and wait for the desktop to appear.
Once VideoPi finishes the startup, it will show a white desktop with its red logo. You can find a configuration icon in the top left corner. It allows setting screen resolution, sound output (HDMI or 3.5mm jack) etc.
To start playing videos, connect a USB stick. VideoPi will play all video files on the USB stick one after another in an alphabetical order. Once it finishes the last file, it will start again with the first file without any break.
To enforce particular video order, name your files with numbers or lowercase letters. Non-latin characters (with diacritics, cyrillic etc) as well as special characters (punctuation etc) are discouraged.
If all files on the USB stick are JPEG or PNG images, the image slideshow mode will be used. The time between two images is set to 5 seconds.
Volume adjustment is not available. Adjust the volume on your speakers.
If HDMI is connected, the sound will play from HDMI not the 3.5mm jack. To change that, use the configuration icon mentioned above.
The loop (repeat all) function cannot be turned off.
How it’s done
- pi-gen to generate a Debian GNU/Linux image
- udevil to trigger an action when USB stick is inserted
- mpv as a video player
- omxiv as an image viewer
- raspi-config as a configuration tool
- Add slideshow feature.
- Raspberry Pi 3 Model B+ support: turns on, no video playback (audio only).
- Fix looping of all files