Slideshow

Fullscreen image slideshow viewer.

Two versions available: C and Python.

---

C Version

Dependencies

Debian/Ubuntu:

sudo apt update
sudo apt install libsdl3-dev libsdl3-image-dev build-essential

Arch Linux:

sudo pacman -S sdl3 sdl3_image

Compile

make

Install

sudo make install

Installs to /usr/local/bin/slideshow.

Uninstall

sudo rm /usr/local/bin/slideshow

Configuration

Create slideshow.ini in the working directory:

[Settings]
folder = /home/user/Pictures
interval = 5

• folder: path to image directory
• interval: seconds between images (default: 5)

Supported formats: jpg, jpeg, png, gif, bmp

Usage

./slideshow

Press ESC to exit.

Systemd Service

Create ~/.config/systemd/user/slideshow.service:

[Unit]
Description=Fullscreen Slideshow

[Service]
Type=simple
WorkingDirectory=%h
ExecStart=/usr/local/bin/slideshow
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

Enable and start:

systemctl --user daemon-reload
systemctl --user enable slideshow
systemctl --user start slideshow

Check status:

systemctl --user status slideshow

Stop:

systemctl --user stop slideshow

Disable (prevent auto-start):

systemctl --user disable slideshow

---

Python Version

Dependencies

sudo apt update
sudo apt install python3 python3-pygame

Usage

python slideshow.py

Press ESC to exit.

Systemd Service (Python)

Create ~/.config/systemd/user/slideshow.service:

[Unit]
Description=Fullscreen Slideshow (Python)

[Service]
Type=simple
WorkingDirectory=%h
ExecStart=/usr/bin/python3 %h/slideshow.py
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

Enable and start:

systemctl --user daemon-reload
systemctl --user enable slideshow
systemctl --user start slideshow