# [`background`][]

Set [X Window System][] [background][] image/video.

[`background`]: https://git.rcrnstn.net/rcrnstn/background
[X Window System]: https://en.wikipedia.org/wiki/X_Window_System
[background]: https://en.wikipedia.org/wiki/Wallpaper_(computing)

## Usage

`background --help`:

```
background 1.0

Set X Window System background image/video.

usage:
  background [-v|--video] [--] [<path>]
  background -h|--help
  background --version

options:
  -v, --video
    Changes the default <path> to
    ${XDG_DATA_HOME:-$HOME/.local/share}/backgrounds-video.
arguments:
  <path>
    If not a directory, set it as background. If a directory, search
    recursively in it (resolving symlinks) and set a random file as
    background.
    [default: ${XDG_DATA_HOME:-$HOME/.local/share}/backgrounds]
```

## License

Licensed under the [ISC License][] unless otherwise noted, see the
[`LICENSE`][] file.

[ISC License]: https://choosealicense.com/licenses/isc/
[`LICENSE`]: LICENSE
