68 lines
1.8 KiB
Markdown
68 lines
1.8 KiB
Markdown
## 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.
|
|
|
|
<img src="https://github.com/Uyanide/backgrounds/blob/master/screenshots/desktop-alt.jpg?raw=true"/>
|
|
|
|
## How to build
|
|
|
|
1. Make sure you have Qt6 libraries, CMake and a C++ compiler installed.
|
|
|
|
e.g. On Arch-based systems:
|
|
|
|
```bash
|
|
sudo pacman -S --needed qt6-base cmake gcc
|
|
```
|
|
|
|
2. Clone the repository:
|
|
|
|
```bash
|
|
git clone https://github.com/Uyanide/Wallpaper_Carousel.git --depth 1 && \
|
|
cd Wallpaper_Carousel
|
|
```
|
|
|
|
3. Run [build script](app/install.sh):
|
|
|
|
```bash
|
|
app/install.sh
|
|
```
|
|
|
|
or if you prefer a prefix other than `/usr/local`, e.g. `$HOME/.local`:
|
|
|
|
```bash
|
|
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](config.example.json) and [config.h](src/config.h) for specific entries.
|
|
|
|
A minimum config should at least contain the path(s) to wallpapers, e.g.
|
|
|
|
```json
|
|
{
|
|
"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.
|
|
|
|
```json
|
|
{
|
|
"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.
|