What is this

It might not be that worthy to write a QtWidget application for such a small feature, but I kind of enjoy the pain... So here it is.

How to build

1. Make sure you have Qt6 libraries, CMake and a C++ compiler installed.

   e.g. On Arch-based systems:

   sudo pacman -S --needed qt6-base cmake gcc
   

2. Clone the repository:

   git clone https://github.com/Uyanide/Wallpaper_Carousel.git --depth 1 && \
   cd Wallpaper_Carousel
   

3. Run build script:

   app/install.sh
   

   or if you prefer a prefix other than /usr/local, e.g. $HOME/.local:

   PREFIX=$HOME/.local ./app/install.sh
   

[Warning]

This script will ask for sudo permission if the prefix is set to a system directory like /usr/local. Please make sure you have read and trust the script before proceeding.

How to use

The config file should be placed in ~/.config/wallpaper-carousel/config.json. Refer to config.example.json and config.h for specific entries.

A minimum config should at least contain the path(s) to wallpapers, e.g.

{
  "wallpaper": {
    "dirs": ["/path/to/your/wallpapers"]
  }
}

By default, the path of the selected wallpaper will be output to stdout. If you want to apply the selected wallpaper automatically after selection, the action.confirm entry should be set, e.g.

{
  "wallpaper": {
    "dirs": ["/path/to/your/wallpapers"]
  },
  "action": {
    "confirm": "awww img \"%1\""
  }
}

action.confirm should be a executable followed by a couple of arguments, where %1 will be replaced by the path of the selected wallpaper.