https://github.com/daspartho/dynamic-wallpaper
automatically change desktop wallpaper based on weather conditions
https://github.com/daspartho/dynamic-wallpaper
openweathermap openweathermap-api python python3 requests unsplash unsplash-api wallpaper wallpaper-changer
Last synced: 12 days ago
JSON representation
automatically change desktop wallpaper based on weather conditions
- Host: GitHub
- URL: https://github.com/daspartho/dynamic-wallpaper
- Owner: daspartho
- License: gpl-3.0
- Created: 2022-08-15T18:11:35.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-07-06T00:51:13.000Z (over 1 year ago)
- Last Synced: 2025-04-03T02:21:46.591Z (7 months ago)
- Topics: openweathermap, openweathermap-api, python, python3, requests, unsplash, unsplash-api, wallpaper, wallpaper-changer
- Language: Python
- Homepage:
- Size: 36.1 KB
- Stars: 3
- Watchers: 3
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Dynamic Wallpaper
Dynamic Wallpaper automatically changes your desktop wallpaper based on your weather!
# How it works
Dynamic Wallpaper fetches weather condition details using OpenWeatherMap API.
Then searches for wallpaper images related to the weather condition through Unsplash API, downloads an image and applies it as wallpaper.
It checks for weather updates every 5 minutes.
# Requirements
- Python 3
- Pip (Python's Package Manager)
# Installation
- First, clone the repository.
```
git clone https://github.com/daspartho/dynamic-wallpaper.git
```
- Then, change your current directory into the dynamic-wallpaper repository.
```
cd dynamic-wallpaper
```
- Finally, install the requirements in the requirements file.
```
pip install -r requirements.txt
```
- From here, dynamic-wallpaper is installed. Continue to the Setting Up section in order to connect dynamic-wallpaper to the APIs.
# Setting up
You need to do these only the first time.
- Create a `.env` file.
- OpenWeatherMap API setup
1. Go to https://home.openweathermap.org/users/sign_up and sign up.
2. Now on the dashboard click on API keys option and copy the key given.
3. Go to the `.env` file and paste the key like this `WEATHER_API_KEY=`
- Unsplash API setup
1. Go to https://unsplash.com/join and sign up. Then go to Application dashboard from here https://unsplash.com/oauth/applications.
2. Now on the dashboard click on 'New Application', accept the terms, fill in a cool name and description for the application (it doesn't matter what you put) and create an application.
3. Then go to the keys section on the application dashboard and copy the Access Key (no need for secret key).
4. Go to the `.env` file and paste the key like this
`UNSPLASH_CLIENT_ID=`
- ⚠️ **Please remember to never share your keys with anyone.**
# Usage
Run the script from a terminal using `python main.py` in the local repository's directory (or probably by double-cliking on the `main` python script from your file explorer on Windows).
Congratulations! You will now have beautiful wallpapers that changes according to weather.
# Contributing
If you want to contribute code, just write a quick pull request and the developers will take a look at it.
If you want to suggest an idea, just write an issue and the developers will check it out!