📦 Installation

Prerequisites

Before installing wallhaven-cli, make sure your system meets the following requirements:

• Supported platform:
  • Linux
  • FreeBSD
• Go:
  Required to build this project from the source.
• fzf:
  Used for the selection menu. This is required.
• chafa
  Used for displaying images in your terminal. This is required if you're not using the kitty terminal.
• kitty
  kitty is optional.

  Installing

Once all prerequisites are met, you can install wallhaven-cli using one of the following methods:

1. Install via go install

go install github.com/r3tr0ananas/wallhaven-cli/wallhaven@latest

2. AUR

You can install wallhaven-cli via the AUR:

yay -S wallhaven-cli

If you use a different AUR helper then replace yay.

3. Download the Latest Release

Alternatively, you can download the latest release and move the binary to your ~/.local/bin directory.

🚀 Usage

!showcase

View Available Options

To view all available commands and options, run:

wallhaven

Edit Configuration

You can customize the settings, such as specifying the folder where downloaded wallpapers will be saved. To edit the configuration, run:

wallhaven edit

This will open the configuration file, where you can set your preferred download directory.

Search Wallpapers

To search for wallpapers on Wallhaven, use the search command followed by your query:

wallhaven search [query]

For example:

wallhaven search mashiro shiina

Download Wallpapers

To download a specific wallpaper by its Wallhaven ID, use the following command:

wallhaven download [id]

For example, to download a wallpaper with the ID l35l5l:

wallhaven download l35l5l

[!Tip] You can download multiple images at once:

wallhaven download l35l5l zy759g

Download Collections

To download wallpapers from a user’s collection, use the following command:

wallhaven collection [username]

[!Tip] To download all wallpapers from the collection, add the -a flag:

wallhaven collection [username] -a