Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tyler-tee/digital-photo-frame
This project is designed to populate photos displayed on digital picture frames powered by Raspberry Pi's for Christmas 2023.
https://github.com/tyler-tee/digital-photo-frame
christmas google-photos google-photos-api photos raspberry-pi
Last synced: 5 days ago
JSON representation
This project is designed to populate photos displayed on digital picture frames powered by Raspberry Pi's for Christmas 2023.
- Host: GitHub
- URL: https://github.com/tyler-tee/digital-photo-frame
- Owner: tyler-tee
- License: mit
- Created: 2023-12-02T22:23:49.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2024-11-02T20:23:16.000Z (12 days ago)
- Last Synced: 2024-11-02T21:20:45.710Z (12 days ago)
- Topics: christmas, google-photos, google-photos-api, photos, raspberry-pi
- Language: Python
- Homepage:
- Size: 34.2 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Digital Photo Frame
## Overview
Kivy-based application developed to run on a raspberry pi. Designed to display photos synced from a Google Photos album on a touchscreen display. Created for Christmas 2023 as a gift for my ~~fiance~~ wife and father.
## Key Features
- **Photo Synchronization**: Integrates with Google Photos API to sync photos.
- **Interactive UI**: Navigate through photos with touch gestures.
- **Weather and Time Display**: Fetches and shows current weather and time.
- **Automatic Updates**: Periodically syncs new photos and deletes old ones.
## Initial Setup
1. **Install Python**: Ensure Python >=3.9 is installed on your Raspberry Pi.
2. **Install Dependencies**:
```bash
pip install -r requirements.txt
```
3. **Configure API and Local Settings**:
- Create a `config.json` with keys like `api_service_name`, `api_version`, `scopes`, `local_folder`, and `album_id`.
- Save your Google API credentials in `client_secret.json`.
- [Get started w/ the Google API](https://developers.google.com/photos/library/guides/get-started)
## Running the Application
1. **Initial Photo Population**:
- Run `sync_photos.py` initially to populate your local folder with photos from the specified Google Photos album.
```bash
python sync_photos.py
```
2. **Start the Photo Display**:
- After the initial setup, use `run_photo_display.py` to handle photo synchronization and display.
```bash
python run_photo_display.py
```
## Notes
- The script uses the pickle module for saving and loading Google Photos client credentials.
- For new installations or invalid credentials, a login window will prompt you for authentication.
## Run as a Service
- A sample `.service` file is provided in `/services` for configuring the app to run with `systemctl`.
## License
This project is licensed under the MIT License.