wallrus
Wallrus
is a simple and blazing-fast wallpaper manager for linux.
It wraps around feh
to provide a simple, fast, feature-rich and user-friendly experience.
Quick links:
Features
- Fetching wallpapers online.
- Supports multiple monitor.
- Automatically change wallpapers using
cron
expressions (wallpaper slideshow). - Supports multiple modes [center, fill, scale, tile]
- Saving fetched wallpapers to a file.
- Aquiring currently applied wallpaper and saving it to a file.
Demo
Usage
$ wallrus --help
wallrus x.x.x
TheHamkerCat <[email protected]>
A simple wallpaper manager for X11
USAGE:
wallrus <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
-V, --version Print version information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
set Set wallpaper by giving an image path or a query to search online.
$ wallrus set --help
Set wallpaper by giving an image path or a query to search online.
USAGE:
wallrus set [OPTIONS]
OPTIONS:
-c, --cron <cron> Add current wallpaper command to crontab to change wallpaper
automatically. (Only works with --query)
-h, --help Print help information
-m, --mode <mode> The mode to set the wallpaper. [default: fill] [possible values: center,
fill, scale, tile]
-p, --path <path> Path to the wallpaper. Use $HOME instead of ~/
-q, --query <query> The query to search for. Pass `trending` for trending wallpapers
-s, --save <save> Save the newly fetched wallpaper in a new file. (Only works with --query)
-x, --noxinerama Disables Xinerama support, Making the wallpaper span across all monitors.
Examples
Set a local wallpaper
$ wallrus set --path=/path/to/wallpaper.jpg
Fetch & Set a wallpaper online
$ wallrus set --query=batman
Get trending ones instead
$ wallrus set --query=trending
Save wallpaper after setting
$ wallrus set --query=batman --save=a.png
Change wallpaper every hour
$ wallrus set --query=avengers --cron="0 * * * *"
Get current wallpaper and save it to a file
$ wallrus get --file=wall.png
Installation
$ git clone https://github.com/TheHamkerCat/wallrus
$ cd wallrus
$ bash ./install.sh
make sure .cargo/bin/
is in $PATH