slideshow/README.md
2023-11-16 15:28:55 +01:00

30 lines
1.1 KiB
Markdown

# slideshow
a simple cli application to start a background image slideshow using 'feh'.
## requirements
- [feh](https://feh.finalrewind.org/)
- [ImageMagick](https://imagemagick.org/) (optional)
## configuration
configuration is entirely done via environment variables.
| variable | default | description |
| -------------------- | ----------------- | -----------------------------------------------------------|
| SLIDESHOW_INTERVAL | 60 | the interval of the slideshow in seconds |
| SLIDESHOW_DIRECTORY | "$HOME" | path to a directory containing images |
| SLIDESHOW_RESOLUTION | | the resolution to which images are scaled (i.e. 1920x1080) |
| SLIDESHOW_LOGLEVEL | "info" | the log level |
**note:**
if no resolution is set the images will be displayed as they are (without any scaling).
**available log levels:**
- `debug`
- `info`
- `warning`
- `error`
- `fatal`