randwall

Periodically fetch and set random wallpapers from Wallhaven's toplist.

Installation

Standalone executable

Download the latest release from https://github.com/arch-anes/randwall/releases.

Arch Linux

Install the randwall-bin AUR package.

Building from source

Clone the repo
Create a Python virtualenv (Optional)
Run pip install -r requirements.txt
Run python -m PyInstaller --onefile --noconsole randwall
A new file has been generated in the dist folder

Configuration

When you start randwall for the first time, a configuration file with default options will be created.

The configuration file contains the following settings:

api_key (empty by default): This is your Wallhaven API key. This is only needed when purity.nsfw is enabled.
max_page (default 500): The maximum Wallhaven page to go to when fetching wallpapers (the more restrictive the keywords are, the lower this number should be set to).
keep (default 10): The maximum number of wallpapers to keep in temporary folder. A value of 0 means keeping everything.
interval (default 30): Fetch interval in seconds.
categories (all enabled by default): These are the Wallhaven categories.
purity (sfw only enabled by default): These are the Wallhaven purity settings. nsfw needs an API key.
include (empty list by default): A list of keywords to use when searching for wallpapers. This is empty by default to get all keywords.
exclude: A list of keywords to exclude when searching for wallpapers. By default it contains a few entries.

Running

Standalone executable

Simply start the executable.

Arch Linux

Run systemctl enable --now --user randwall.