KPictureFrame

KDE Plasma 6 widget that displays a picture on your desktop.

KPictureFrame is a lightweight KDE Plasma 6 widget that displays a user-defined image directly on your desktop or panel — a photo, a logo, a QR code, whatever you drag onto it.

If KPictureFrame is useful to you, support continued KDE/Linux development through GitHub Sponsors.

What it does

• Display any local image (PNG, JPG, WebP, SVG, animated GIF).
• Slideshow mode — point it at a folder and it cycles through every image inside on a configurable interval. Click the left/right half of the picture to go back/forward manually.
• Drag & drop an image or a folder straight onto the widget to set it.
• Live reload — changing the picture in Settings updates immediately, no restart needed.
• Pure QML, no compiled plugin, no external daemons.

UI is translated into German, Spanish and French (falls back to English otherwise) — see translate/.

Requirements

Qt ≥ 6.7 and KDE Frameworks ≥ 6.10 (whatever your Plasma 6 install already has) — nothing else to install at runtime.

Install

Easiest: "Get New Widgets" in System Settings, or grab the .plasmoid from the latest release and:

kpackagetool6 --type Plasma/Applet --install kpictureframe-*.plasmoid

Also available as a proper package, if you'd rather have zypper/apt manage updates:

# openSUSE Tumbleweed
sudo zypper ar -f https://download.opensuse.org/repositories/home:/Agundur/openSUSE_Tumbleweed/home:Agundur.repo
sudo zypper --gpg-auto-import-keys ref
sudo zypper in kpictureframe

# Debian/Ubuntu — grab the .deb from the latest release above

Or straight from source, no build step needed:

git clone https://github.com/Agundur-KDE/KPictureFrame.git
kpackagetool6 --type Plasma/Applet --install KPictureFrame/package/

Support

Open an issue: KPictureFrame Issues

Contributing

Fork and adapt freely.

Credits

"Simba on wall" (KPictureFrame3.png) by Hadi A.

License

GPL-3.0-or-later