Skip to content


Repository files navigation

PictureFrame powered by pi3d

picframe logo

What Is PictureFrame?

This is a viewer for a raspberry powered picture frame. For remote control it provides an automatic integration into Home Assistant via MQTT discovery.

History of PictureFrame

When I started 2019 my DIY project building a raspberry powered digital picture frame I came across Wolfgang's website I ran my frame with the pi3d viewer, but always missed a more deeply integration to my smart home server running Home Assistant.As my personel corona project I decided to rewrite the viewer to my needs. Hoping someone can make use of it.

Highlights of PictureFrame

  • Viewer
    • blend effects
    • auto mat generation
    • photo metadata overlays (title, location, date, ...)
    • live clock
    • automatic pairing of portrait images
    • keyboard, mouse and touch screen support
  • Filter by
    • IPTC tags
    • location
    • directories
    • date
  • Remote Control
    • control interface for mqtt, http(s)
    • tun on/off display
    • next/prev/pause image
    • shuffle play
    • toggle metadata overlays
    • toggle clock visibility
    • retrieve image meta info (exif, IPTC)


Full documentation can be found at the project's wiki.

Please note that PictureFrame may change significantly during its development. Bug reports, comments, feature requests and fixes are most welcome!

To find out what's new or improved have a look at the changelog.


glenvorel Thanks for the new keyboard, mouse and touch screen support.

Many Thanks to Wolfgang for your inspiring work.

A special Thank to Paddy Gaunt one of the authors of the pi3d project. You are doing a great job!

Last but no least a big Thank You to Jeff Godfrey. Your auto mat feature and database driven cache is an outstanding piece of code.


Picture frame viewer for raspi, controlled via mqtt and automatticly integrated as mqtt device in homeassistant.







No packages published