wallhaven-sync is a command-line tool for syncing wallpapers from a Wallhaven collection to a local directory on your computer. wallhaven-sync can also detect wallpapers in your local sync directory that are not a part of the collection anymore and delete them.

Prebuilt binaries are provided on Github Releases for Linux and MacOS platforms. Download the relevant binary for your platform from the Releases page and they should be ready for use.

Follow the steps below to build wallhaven-sync from source. You will need a working cabal tool with GHC 9.2.4 for the build.

1. Download the source from one of the releases.
2. Inside the source directory, invoke cabal install.
3. wallhaven-sync will be installed in your .cabal/bin directory.

wallhaven-sync requires your Wallhaven API Key.

1. Log into your Wallhaven account and then open the Account Settings page.
2. Your API key will be shown under "API Key" section as shown in the image below.

Usage instructions can be printed by invoking wallhaven-sync --help. The help output is reproduced below.

wallhaven-sync

Usage: wallhaven-sync [--wallpaper-dir DIRECTORY] [--delete-unliked]
                      --wallhaven-username USERNAME --wallhaven-api-key API_KEY
                      [--collection-label LABEL] [--debug]

  Sync wallpapers from a Wallhaven collection

Available options:
  --wallpaper-dir DIRECTORY
                           Directory where wallpapers will be saved
                           (default: "/Users/home/wallpapers")
  --delete-unliked         Delete unliked wallpapers
  --wallhaven-username USERNAME
                           Wallhaven username
  --wallhaven-api-key API_KEY
                           Wallhaven API key
  --collection-label LABEL Label of the collection to sync (default: "Default")
  --debug                  Debug mode
  -h,--help                Show this help text

For downloading your Wallhaven favorites to default directory -
wallhaven-sync --wallhaven-username USERNAME --wallhaven-api-key API_KEY

For downloading your wallhaven favorites to ~/wallhaven directory -
wallhaven-sync --wallhaven-username USERNAME --wallhaven-api-key API_KEY --wallpaper-dir ~/wallhaven

For syncing (deleting unliked wallpapers from local directory and downloading wallpapers from the collection) Wallhaven favorites to default directory -
wallhaven-sync --wallhaven-username USERNAME --wallhaven-api-key API_KEY --delete-unliked

For downloading a collection named "nature" under account "my-account" to default directory -
wallhaven-sync --wallhaven-username my-account --collection-label nature --wallhaven-api-key API_KEY