chwp

KO | EN

gitlite — search

#hacktoberfest #react #llm #go #machine-learning #rust #deep-learning #java #awesome #cli #kubernetes #mcp #openai #open-source

(★ 8)

Changes the wallpaper from the command line.

chwp Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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](https://doc.rust-lang.org/cargo/getting-started/installation.html) package manager to install
the [chwp](https://crates.io/crates/chwp) crate:

```shell
cargo install chwp
```

### Download latest binary

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

```shell
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](https://aur.archlinux.org/packages/chwp-bin) [AUR](https://aur.archlinux.org/) package:

```shell
yay -S chwp-bin
```

## Usage

```shell
chwp [keywords]|[imageurl] span
```

### Examples

Set a random wallpaper for the keyword ocean:

```shell
chwp ocean
```

Set a wallpaper from a specific image url:

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

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

```shell
chwp /path/to/pictures/
```

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

```shell
chwp water,sky,ocean
```

Combine multiple keywords with a `+`:

```shell
chwp night+city
```

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

```shell
chwp ocean span
```

chwp

chwp Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

chwp

chwp Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README