sway-wallpaper/README.md
2024-06-03 09:35:53 +02:00

46 lines
1.2 KiB
Markdown

# Sway Wallpaper
Display wallpapers on Sway, this is essentially a wrapper for `swaybg`.
## Features
- Specify a directory containing all your wallpapers
- Specify for which display
- Set interval to automatically change wallpaper after some time
- Wallpapers can be chosen randomly
- Wallpapers can be chosen in alphabetical order
- No "grey" flash when switching wallpapers
## Usage
```
usage: sway-wallpaper [options] <path> <output>
required:
output The outputs as shown with the command `swaymsg -t get_outputs`
path The path to the directory containing the wallpapers
options:
-h, --help Show help
-i, --interval Specify the interval between wallpapers in seconds
--never-random if set, wallpapers order is based on the names of the files
```
Example:
`./sway-wallpaper /path/to/wallpapers -i 3600 DP-1`
## Installation
First, clone this repository `git clone https://codeberg.org/vyn/sway-wallpaper.git` (or download it the way you prefer).
You only need **gcc** and **cmake**, run these commands in the project directory:
```
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make
```
The executable should be located in `build/sway-wallpaper`