RouHim / chwp

Changes the wallpaper from the command line.

Changes the wallpaper from the command line.

Motivation

I love the command line, and I love eye candy, this tool combines both worlds by allowing me to change the background image from the command line.

Installation

Build from source

Use the cargo package manager to install the chwp crate:

cargo install chwp

Download latest binary

This bash snippet will download and install the latest chwp release:

LATEST_VERSION=$(curl -L -s -H 'Accept: application/json' https://github.com/RouHim/chwp/releases/latest | sed -e 's/.*"tag_name":"\([^"]*\)".*/\1/') && \
mkdir -p ~/.local/bin && \
curl -L -o ~/.local/bin/chwp https://github.com/RouHim/chwp/releases/download/$LATEST_VERSION/chwp-linux-x86-64 && \
chmod +x ~/.local/bin/chwp

Tip

Ensure ~/.local/bin is in your PATH. Add export PATH="$HOME/.local/bin:$PATH" to your shell's profile.

Arch Linux

Install chwp-bin AUR package:

yay -S chwp-bin

Usage

chwp [keywords]|[imageurl] span

Examples

Set a random wallpaper for the keyword ocean:

chwp ocean

Set a wallpaper from a specific image url:

chwp https://source.unsplash.com/1920x1080

Set a wallpaper from a local path. A random one will be chosen:

chwp /path/to/pictures/

Set a wallpaper from multiple keywords, a random one will be selected:

chwp water,sky,ocean

Combine multiple keywords with a +:

chwp night+city

The span parameter can be used to span the wallpaper over multiple screens:

chwp ocean span