https://github.com/kevinhowbrook/i3-backgrounds
A python script to download a searched image from unsplash and set it as a background using feh
https://github.com/kevinhowbrook/i3-backgrounds
background background-image i3 python ricing
Last synced: 6 days ago
JSON representation
A python script to download a searched image from unsplash and set it as a background using feh
- Host: GitHub
- URL: https://github.com/kevinhowbrook/i3-backgrounds
- Owner: kevinhowbrook
- Created: 2023-09-17T08:41:43.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-10-16T11:40:52.000Z (over 2 years ago)
- Last Synced: 2025-03-01T16:22:49.428Z (over 1 year ago)
- Topics: background, background-image, i3, python, ricing
- Language: Python
- Homepage:
- Size: 14 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# i3 Backgrounds
## Description
This is a simple script that downloads a random image from [Unsplash](https://unsplash.com/) and sets it as the desktop background. The idea is to do this for i3 with a key binding so you can change your background with a keypress.

## Requirements
- Unsplash API key
## Running
1. Clone the repository into ~/shared/i3-backgrounds
1. Copy local.config.py to config.py
1. Add your Unsplash API key to config.py
1. Run with `python main.py`
You can clone it to another location but you'll have to adjust a few paths
in main.py for the download image location.
## Setup to run with an i3 binding
Add this to your i3 config file, this would configure `mod+i` to run the script. Now `mod_i` will change your background. :)
```python
bindsym $mod+i exec --no-startup-id ~/shared/i3-backgrounds/main.py
```