Skip to main content

Picture frame viewer powered by raspberry with homeassistant integration

Project description

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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

picframe-2023.7.26.post1.tar.gz (3.3 MB view hashes)

Uploaded source

Built Distribution

picframe-2023.7.26.post1-py3-none-any.whl (3.2 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page