sway-wallpaper/README.md

# 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`