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.

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

go install github.com/ananasmoe/wallhaven-cli/v2/wallhaven@latest

You can install wallhaven-cli via the AUR:

yay -S wallhaven-cli

If you use a different AUR helper then replace yay.

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

To view all available commands and options, run:

wallhaven

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.

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

wallhaven search [query]

For example:

wallhaven search mashiro shiina

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

wallhaven download l35l5l zy759g

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

wallhaven collection [username]

wallhaven collection [username] -a