## PictureFrame powered by pi3d
![picframe logo](https://github.com/helgeerbe/picframe/wiki/images/Picframe_Logo.png)
- [PictureFrame powered by pi3d](#pictureframe-powered-by-pi3d)
- [What Is PictureFrame?](#what-is-pictureframe)
- [History of PictureFrame](#history-of-pictureframe)
- [Highlights of PictureFrame](#highlights-of-pictureframe)
- [Documentation](#documentation)
- [Acknowledgement](#acknowledgement)
## What Is PictureFrame?
This is a viewer for a raspberry powered picture frame. For remote control it provides an automatic integration into [Home Assistant](https://www.home-assistant.io/) via MQTT discovery.
- https://github.com/helgeerbe/picframe
- Paddy Gaunt, Jeff Godfrey, Helge Erbe
- Licence: MIT
- Tested on rasberry 3B+/4, Ubuntu 20.10 and Python 3.7
## History of PictureFrame
When I started 2019 my DIY project building a raspberry powered digital picture frame I came across Wolfgang's website [www.thedigitalpictureframe.com](https://www.thedigitalpictureframe.com/). I ran my frame with the [pi3d PictureFrame2020.py](https://github.com/pi3d/pi3d_demos) viewer, but always missed a more deeply integration to my smart home server running [Home Assistant](https://www.home-assistant.io/).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)
## Documentation
[Full documentation can be found at the project's wiki](https://github.com/helgeerbe/picframe/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](https://github.com/helgeerbe/picframe/wiki/Changelog).
## Acknowledgement
[glenvorel](https://github.com/glenvorel) Thanks for the new keyboard, mouse and touch screen support.
Many Thanks to Wolfgang [www.thedigitalpictureframe.com](https://www.thedigitalpictureframe.com/) for your inspiring work.
A special Thank to Paddy Gaunt one of the authors of the [pi3d](https://github.com/pi3d/pi3d_demos) 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.
Raw data
{
"_id": null,
"home_page": null,
"name": "picframe",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "Helge Erbe <helge@erbehome.de>",
"keywords": "picframe, viewer, raspberry, raspi, homeassistant, hass",
"author": "Paddy Gaunt, Jeff Godfrey",
"author_email": "Helge Erbe <helge@erbehome.de>",
"download_url": "https://files.pythonhosted.org/packages/23/ba/0916a8b6ad00a337d901cf6c5f46862e3e996338b05f46f69536509d4013/picframe-2024.11.1.tar.gz",
"platform": null,
"description": "## PictureFrame powered by pi3d\n\n![picframe logo](https://github.com/helgeerbe/picframe/wiki/images/Picframe_Logo.png)\n\n- [PictureFrame powered by pi3d](#pictureframe-powered-by-pi3d)\n- [What Is PictureFrame?](#what-is-pictureframe)\n- [History of PictureFrame](#history-of-pictureframe)\n- [Highlights of PictureFrame](#highlights-of-pictureframe)\n- [Documentation](#documentation)\n- [Acknowledgement](#acknowledgement)\n\n## What Is PictureFrame?\n\nThis is a viewer for a raspberry powered picture frame. For remote control it provides an automatic integration into [Home Assistant](https://www.home-assistant.io/) via MQTT discovery.\n\n- https://github.com/helgeerbe/picframe\n- Paddy Gaunt, Jeff Godfrey, Helge Erbe\n- Licence: MIT\n- Tested on rasberry 3B+/4, Ubuntu 20.10 and Python 3.7\n\n## History of PictureFrame\n\nWhen I started 2019 my DIY project building a raspberry powered digital picture frame I came across Wolfgang's website [www.thedigitalpictureframe.com](https://www.thedigitalpictureframe.com/). I ran my frame with the [pi3d PictureFrame2020.py](https://github.com/pi3d/pi3d_demos) viewer, but always missed a more deeply integration to my smart home server running [Home Assistant](https://www.home-assistant.io/).As my personel corona project I decided to rewrite the viewer to my needs. Hoping someone can make use of it.\n\n\n## Highlights of PictureFrame\n\n- Viewer\n - blend effects\n - auto mat generation\n - photo metadata overlays (title, location, date, ...)\n - live clock\n - automatic pairing of portrait images\n - keyboard, mouse and touch screen support\n- Filter by\n - IPTC tags\n - location\n - directories\n - date\n- Remote Control\n - control interface for mqtt, http(s)\n - tun on/off display\n - next/prev/pause image\n - shuffle play\n - toggle metadata overlays\n - toggle clock visibility\n - retrieve image meta info (exif, IPTC)\n\n## Documentation\n\n[Full documentation can be found at the project's wiki](https://github.com/helgeerbe/picframe/wiki).\n\nPlease note that PictureFrame may change significantly during its development.\nBug reports, comments, feature requests and fixes are most welcome!\n\nTo find out what's new or improved have a look at the [changelog](https://github.com/helgeerbe/picframe/wiki/Changelog).\n\n## Acknowledgement\n\n[glenvorel](https://github.com/glenvorel) Thanks for the new keyboard, mouse and touch screen support.\n\nMany Thanks to Wolfgang [www.thedigitalpictureframe.com](https://www.thedigitalpictureframe.com/) for your inspiring work. \n\nA special Thank to Paddy Gaunt one of the authors of the [pi3d](https://github.com/pi3d/pi3d_demos) project. You are doing a great job!\n\nLast but no least a big Thank You to Jeff Godfrey. Your auto mat feature and database driven cache is an outstanding piece of code.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Picture frame viewer powered by raspberry with homeassistant integration",
"version": "2024.11.1",
"project_urls": {
"Homepage": "https://github.com/helgeerbe/picframe"
},
"split_keywords": [
"picframe",
" viewer",
" raspberry",
" raspi",
" homeassistant",
" hass"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c6452e06db3667086a006beb2233356ce80b528a68812a39594bc87b555bd386",
"md5": "c6fbe5299f13e5146b91b85c84639a27",
"sha256": "d68a4260f125d19b9dff1d01281a3cf3cb533c391f6c4ecb8c96b9cbb68def29"
},
"downloads": -1,
"filename": "picframe-2024.11.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c6fbe5299f13e5146b91b85c84639a27",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 3251018,
"upload_time": "2024-11-01T12:02:49",
"upload_time_iso_8601": "2024-11-01T12:02:49.272929Z",
"url": "https://files.pythonhosted.org/packages/c6/45/2e06db3667086a006beb2233356ce80b528a68812a39594bc87b555bd386/picframe-2024.11.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "23ba0916a8b6ad00a337d901cf6c5f46862e3e996338b05f46f69536509d4013",
"md5": "e0100126817ca51cd2306dca42471e60",
"sha256": "60e109369206fe802bf2525cee38501c644329a90c13e6bf8bbb7e905ff30ea5"
},
"downloads": -1,
"filename": "picframe-2024.11.1.tar.gz",
"has_sig": false,
"md5_digest": "e0100126817ca51cd2306dca42471e60",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 3268461,
"upload_time": "2024-11-01T12:02:51",
"upload_time_iso_8601": "2024-11-01T12:02:51.765908Z",
"url": "https://files.pythonhosted.org/packages/23/ba/0916a8b6ad00a337d901cf6c5f46862e3e996338b05f46f69536509d4013/picframe-2024.11.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-01 12:02:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "helgeerbe",
"github_project": "picframe",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "picframe"
}