150 stable releases

new 1.239.5 Apr 16, 2024
1.239.4 Mar 31, 2024
1.238.20 Jan 5, 2024
1.238.16 Dec 31, 2023
1.125.0 Jul 30, 2022

#78 in Command line utilities

Download history 4/week @ 2023-12-19 6/week @ 2023-12-26 16/week @ 2024-01-02 6/week @ 2024-02-13 39/week @ 2024-02-20 19/week @ 2024-02-27 2/week @ 2024-03-05 216/week @ 2024-03-12 178/week @ 2024-03-19 257/week @ 2024-03-26 71/week @ 2024-04-02

724 downloads per month

MIT license

758 lines

CI GitHub release (latest by date) GitHub Release Date Donate me

Changes the wallpaper from the command line.


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.


Build from source

Use the cargo package manager to install the chwp crate:

cargo install chwp

Download latest binary

This 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/') && \
sudo curl -L -o /usr/bin/chwp https://github.com/RouHim/chwp/releases/download/$LATEST_VERSION/chwp-linux-x86-64 && \
sudo chmod +x /usr/bin/chwp

Arch Linux

Install chwp-bin AUR package:

yay -S chwp-bin


chwp [keywords]|[imageurl] span


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


~366K SLoC