slide

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.
• Raspberry Pi 3 running Raspbian Buster.
• Raspberry Pi Zero running Raspbian Buster.

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

This project is maintained by myself during my spare time. If you like and use it, consider buying me a coffee.

Usage

slide [-t rotation_seconds] [-a aspect] [-o background_opacity(0..255)] [-b blur_radius] -p image_folder [-r] [-O overlay_string] [-v] [--verbose] [--stretch]

• image_folder: where to search for images (.jpg files)
• -r for recursive traversal of image_folder
• -s for shuffle instead of random image rotation
• -S for sorted rotation (files ordered by name, first images then subfolders)
• rotation_seconds(default=30): time until next random image is chosen from the given folder
• aspect(default=a): the required aspect ratio of the picture to display. Valid values are 'a' (all), 'l' (landscape) and 'p' (portrait)
• 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
• -v or --verbose: Verbose debug output when running, plus a thumbnail of the original image in the bottom left of the screen
• --stretch: When in aspect mode 'l' or 'p' crop the image rather than leaving a blurred background. For example, in landscape mode this will make images as wide as the screen and crop the top and bottom to fit.
• -O is used to create a overlay string.
  • It defines overlays for all four edges in the order top-left;top-right;bottom-left;bottom-right
  • All edges overlays are separated by ;
  • Each edge can either be just a test or contain formatting in the form margin|fontsize|text
  • the text can contain special strings which are replaced during rendering:
    • <time> current time
    • <date> current date
    • <datetime> current time and date
    • <exifdatetime> time stamp from the EXIF data of the image
    • <filename> filename of the current image
    • <basename> basename of the current image (without suffix)
    • <filepath> filename including the path of the current image
    • <dir>directory of the current image
    • <path>path to the current image without filename
  • Example: slide -p ./images -O "20|60|Time: <time>;;;Picture taken at <exifdatetime>"

To exit the application, press escape. If you're using a touch display, touch all 4 corners at the same time.

Dependencies

• qt5-qmake
• qt5
• qt5-image-formats-plugins
• libexif

Ubuntu/Raspbian:

sudo make install-deps-deb

Build

Install dependencies

make install-deps-deb

Build project

make

Install binaries

sudo make install

macOS

Prerequisite: brew

brew install qt5
brew install libexif
brew install libexif
make

Article on using slides

This article has more helpful ways that you could use this repo as a picture frame
https://opensource.com/article/19/2/wifi-picture-frame-raspberry-pi

Removing black border (Raspberry Pi)

if you find that you have a black border around your screen you can remove it by disabling overscan. This is done by editing /boot/config.txt and uncommenting disable_overscan=1