## 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": "",
"name": "picframe",
"maintainer": "",
"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/ee/35/b62b222c9d46c5b5be0fcdd181332863b918b5ad4a21109b25027fd40d50/picframe-2024.2.19.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.2.19",
"project_urls": {
"Homepage": "https://github.com/helgeerbe/picframe"
},
"split_keywords": [
"picframe",
"viewer",
"raspberry",
"raspi",
"homeassistant",
"hass"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d975f14c375b7e48abe52b5b7c65d3782368b3598a4bcdf9448ea1ad13d97c23",
"md5": "39bab1a0cfe8536678bff8b02f338754",
"sha256": "273c24711a13306f93b43e3eff02c12b087441fd7d607e570d99fb9637681d42"
},
"downloads": -1,
"filename": "picframe-2024.2.19-py3-none-any.whl",
"has_sig": false,
"md5_digest": "39bab1a0cfe8536678bff8b02f338754",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 3248316,
"upload_time": "2024-02-19T11:49:12",
"upload_time_iso_8601": "2024-02-19T11:49:12.888660Z",
"url": "https://files.pythonhosted.org/packages/d9/75/f14c375b7e48abe52b5b7c65d3782368b3598a4bcdf9448ea1ad13d97c23/picframe-2024.2.19-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ee35b62b222c9d46c5b5be0fcdd181332863b918b5ad4a21109b25027fd40d50",
"md5": "8b852e2602065f019b8cfd489dd545a5",
"sha256": "4a617f3844475d4b621d5b66cc520a412ad58063b0652851938f96041d76424e"
},
"downloads": -1,
"filename": "picframe-2024.2.19.tar.gz",
"has_sig": false,
"md5_digest": "8b852e2602065f019b8cfd489dd545a5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 3265524,
"upload_time": "2024-02-19T11:49:15",
"upload_time_iso_8601": "2024-02-19T11:49:15.135884Z",
"url": "https://files.pythonhosted.org/packages/ee/35/b62b222c9d46c5b5be0fcdd181332863b918b5ad4a21109b25027fd40d50/picframe-2024.2.19.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-19 11:49:15",
"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"
}