Venus: For those that get bored of looking at their wallpaper

Venus aims to be a cross-platform tool to automatically change your desktop wallpaper using images from Unsplash. By default, all images are stored in the system's temporary directory, this way their disposal is handled by the operating system.

Venus also handles using images that work with your resolution.

Note for the adventurous -> set venus as a startup program. This way you can see what awaits you with each reboot :)

Installation

Install using pip3

Linux/OSX

pip3 install venuspy

Windows

py -m pip install venuspy

Usage

Just type venus!

Linux/OSX

venus

Windows

py -m venus

You can also supply search terms to the command:

venus landscape nature car

Config

Venus can be configured for specific search terms to get a category of images.

Edit the config file located in:

~/.config/venus/config

By default, the search terms are empty, which means the image selection will be random. To choose what kind of images you want, enter search terms separated by commas.

Here is an example:

SEARCH_TERMS = landscape,nature,car

Search terms in the command will overwrite those from the config.

To get images of a specific Unsplash collection, use its id:

COLLECTION_ID = 1053828

Note: If COLLECTION_ID is set, the SEARCH_TERMS is ignored.

By default all images are stored as temporary files in the temp directory of the operating system. To change the location where the images are stored, edit the OUTPUT_PATH option.

Here is an example:

OUTPUT_PATH = /home/user/Pictures

Venus has the option of using a timer to change your wallpaper given an interval in seconds.

Here is an example that changes the wallpaper every 60 seconds (1 minute):

WAIT_TIME = 60

By default a image is requested with the resoluton of your screen. If you need to change that for any reason (if your screen resolution is not available by Unsplash and you are getting a 404 image as your wallpaper), edit the SCREEN_RESOLUTION option. Here is an example:

SCREEN_RESOLUTION = 1920x1080

Venus supports using pywal as an addon. To use pywal first install it, then enable it in the config file:

USE_PYWAL = True

To limit the number of files stored locally and prevent filling your disk, set the CACHE_ITEMS option (0 is infinite)

CACHE_ITEMS = 10

Current Version 1.0.3 - verified working on

How to Contribute