Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alexwohlbruck/google-photos-wallpaper
Sets your wallpaper each day from your Google Photos albums.
https://github.com/alexwohlbruck/google-photos-wallpaper
automation desktop-app google-photos photography python vue wallpaper
Last synced: 19 days ago
JSON representation
Sets your wallpaper each day from your Google Photos albums.
- Host: GitHub
- URL: https://github.com/alexwohlbruck/google-photos-wallpaper
- Owner: alexwohlbruck
- License: mit
- Created: 2020-03-09T01:37:12.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-12-12T06:20:01.000Z (almost 2 years ago)
- Last Synced: 2024-10-12T08:15:56.889Z (about 1 month ago)
- Topics: automation, desktop-app, google-photos, photography, python, vue, wallpaper
- Language: Python
- Homepage:
- Size: 130 MB
- Stars: 14
- Watchers: 2
- Forks: 2
- Open Issues: 44
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Google Photos Wallpaper
This is a utility that will update your desktop wallpaper from your Google Photos library on a custom schedule.
## Features
- Select the photo albums that you'd like to use, and your wallpaper will change automatically either in sequence or random order.
- Filter photos that are too small, have a poor aspect ratio, or create a custom blacklist.
- Previous, next, and random buttons to quickly change the wallpaper, or select one from the album list.
## Installation
### Production version
There are no executable available for installation yet. They will be available soon on the [releases](https://github.com/alexwohlbruck/google-photos-wallpaper/releases) page.
### Development version
1. To compile the app, first clone the repository in the desired location on your computer.
```sh
git clone https://github.com/alexwohlbruck/google-photos-wallpaper.git
cd google-photos-wallpaper
```
2. Create and activate a python virtual environment.
```sh
python3 -m venv env
source env/Scripts/activate
```
3. Install packages using pip.
```sh
pip3 install -r requirements.txt
```
4. Create a [Google Cloud Platform](https://console.cloud.google.com/) project.
- Enable the `Photos Library API`.
- In the credentials tab, create an OAuth 2.0 client ID and download the secrets file
- Name the file `client_secrets.json` and place in your /src directory.
5. Run the python app.
```sh
python3 main.py
```
### Build and distribute
Build the executable using pyupdater.
```sh
pyupdater build win.spec --app-version=X.X.X
```
Pass the flag `--pyinstaller-log-info` to see pyinstaller build logs.
The app will be built to `/pyu-data/new/gpwallpaper-win-X.X.X.zip`.
## FAQ
### How do I sign in?
The app will automatically open a browser tab with a Google sign in prompt. You may have to manually switch to your browser. After you have signed in, the your album library will be displayed.
### Can I select individual photos?
You can pick photo albums to be used, but I will add an option to add a custom search as a photo source.
### Why does it take so long to load albums?
When you select an album to use for your wallpaper, the app will download the metadata for every photo in the album, and can only do so in intervals of 50 photos. If the album is very large, it will take some time to download all of the data.
### What operating systems are supported?
I am currently developing the app for Windows. Support for Linux and MacOS is possible in the future, but after a full Windows release is done.
## Support
To get support, report a bug, or request features, go to the Issues page of this repository.
## Contribute
If you would like to contribute to the project, I will gladly look over any pull requests. Thank you!
## License
[MIT](https://github.com/alexwohlbruck/google-photos-wallpaper/blob/master/LICENSE)