It's an experimental Nushell module for managing wallpapers from the terminal.
All relevant documentation is provided in the module itself. I recommend to read the huge comment at the top, which serves as the help for the module in general.
The module is mostly complete and should be fully usable right now. Though the command's signatures are not considered stable and breaking changes should be expected.
If you want to try it yourself, after you have acquired the module file (either
by cloning the repository or just copying wp.nu), add this to your
configuration:
use /path/to/wp.nuwhere you should replace /path/to/ with the path to the downloaded file.
If you copied the repository, delete the .gitignore file. If you copied the
file manually (for example, to add to the Nushell configuration directory), you
should configure these variables
$env.WP_DIR = '/path/to/wallpapers'
$env.WP_FILE = '/path/to/wallpapers.toml'as well, to not create the directory and the file in the same directory as
wp.nu. For the Git integration, it is expected that these paths are located in
a single repository.
After that, restart the shell and you should have the wp commands available.
Unless otherwise noted, the source files are distributed under the BSD-3-Clause license.