Skip to content
Simple slideshow showing random images from specified directory
Branch: master
Clone or download
Latest commit 178dc6b Jan 31, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc screenshot Jan 24, 2019
sbin add package script and install howto Jan 31, 2019
src screenshot Jan 24, 2019
.gitignore init Jan 21, 2019 fix install readme Jan 31, 2019
LICENSE Initial commit Jan 21, 2019 update readme Jan 24, 2019


Simple, lightweight slideshow selecting random images from specified directory. This slideshow is designed to compile and run also on a Raspberry Pi, for example to turn it into a digital picture frame.

Tested versions:

  • Raspberry Pi 3 running Raspbian Stretch.

Screen background is filled with a scaled version of the image to prevent pure black background.



slide [-t rotation_seconds] [-o background_opacity(0..255)] [-b blur_radius] -p image_folder
  • image_folder: where to search for images (.jpg files), currently non-recursively
  • rotation_seconds(default=30): time until next random image is chosen from the given folder
  • background_opacity(default=150): opacity of the background filling image between 0 (black background) and 255
  • blur_radius(default=20): blur radius of the background filling image


  • libexif
  • qt5
sudo apt install libexif-dev qtdeclarative5-dev-tools


mkdir -p make
cd make
qmake ../src/
sudo make install
You can’t perform that action at this time.