Direct dependencies
| dependency | crate | docs |
|-------------------|------------------------------------|---------------------------------------|
| serde | |
|
| serde_derive | |
|
| rand | |
|
| chrono | |
|
| delaunator | |
|
| toml | |
|
| resvg | |
|
| usvg | |
|
| wallpaper_rs | |
|
This project aims to provide a utility for generating random abstract wallpapers.
Until recently it could only generate the images, not actually set them as wallpapers. This limitation is being addressed.
A bash script to automatically change wallpaper is provided, and has been tested on Ubuntu 20.04 (Focal Fossa). Portability of this script is outside of the scope of this project (the image generator however should be portable to any OS), but scripts that work for other shells/distros are welcome.
diff
! Warning: Breaking change
! Since the addition of command line options, your launch script may be broken for the latest version
! You can either download a version of wallrnd earlier than Jul 15, 2020, or see the new format
! in setup/set-wallpaper (previous script moved to setup/set-wallpaper-obsolete)
! To update your script, all you need is to replace
- wallrnd /path/to/image.svg /path/to/config.toml
! with
+ wallrnd --image /path/to/image.svg --config /path/to/config.toml
diff
! Warning: Breaking change
! Format for themes weight has changed to be more versatile
! Old format:
- theme = [["<C1>", <W1>], ["<C2>", <W2>], ...]
! New format:
+ theme = ["<C1> x<W1>", "<C2> x<W2>", ...]
! To update your configuration file, run
@@ perl -pi -e 's/\[\"([a-zA-Z0-9_]*)\", *([0-9]+)\]/\"$1 x$2\"/g' setup/wallrnd.toml @@
While the code in this crate is licensed under the MIT license, the binary target includes (purely for user convenience) dependencies that have more restrictive licenses.
resvg and usvg require the MPL 2.0 license and pull in some other dependencies under the BSD 3-clause.
wallpaper_rs is licensed under GPL 3.0
The features provided by these crates are purely optional. The different features available are explained in more detail in the Advanced setup section.
Using the make-png feature requires MPL 2.0 or a compatible license.
Using the set-wallpaper feature requires GPL 3.0 or a compatible license.
Using both requires GPL 3.0 at least.
The inclusion of MPL- and GPL-licensed crates as dependencies of this crate licensed under MIT does not grant to anyone the right to distribute executables that were compiled using the corresponding feature flags under non-GPL-compatible licenses. Any derivative work that does not include these flags can safely be provided under the MIT license.
It is not recommended for any crates dependent on this one to use the feature flags, as the functionality obtained from the GPL dependencies is not reexported by wallrnd and thus adds needless dependencies.
wallrnd)cargo install wallrnd --features set-wallpaper
Make a copy of setup/wallrnd.toml and adjust the settings to your liking
Make a new Crontab entry: * * * * * nice -n 20 -- wallrnd --config /path/to/wallrnd.toml --image /tmp/wallpaper.svg --set
Thanks to nice giving the program a very low priority, it can run in the background without issue.
It will soon be possible to achieve the same without nice.
prototype/prototype.py)wallrnd is a more developed product than this, but if you still want to use the prototype it is possible.
Be warned that performance is a lot worse and that this version is far less configurable.
Edit prototype/set-wallpaper to your liking, make it executable, and add it to your $PATH.
Make a new Crontab entry: * * * * * set-wallpaper
psutil is used to abort the process if CPU usage is already high.
You may be interested in these other setup methods if - your OS does not support setting an SVG image as wallpaper - you do not wish to use GPL- or MPL-licensed products - your OS is not included in this list of supported environments - you want custom functionality such as aborting the script when running on battery - you want to build from source
If you do not need wallrnd to set wallpapers, then do not use the feature set-wallaper: cargo install wallrnd
If you want to be able to create png images, then you should add the make-png feature: cargo install wallrnd --features make-png
To have both features, you can use cargo install wallrnd --features all
You can also build from source:
git clone https://github.com/Vanille-N/wallrnd
cd wallrnd
cargo build --release
cp target/release/wallrnd ~/bin/wallrnd
setup/wallrnd.toml includes examples and explanations on how to setup options. Feel free to ask for more explanations.
The configuration file doesn't have to be named wallrnd.toml, but it has to be formatted like a TOML file.
setup/set-wallpaper-* are examples of how to set wallrnd to be executed.
The appropriate version should be put in your path and executed whenever necessary by adding an entry to your Crontab. * * * * * set-wallpaper
Note that the file path does not have to be absolute. wallrnd resolves paths before writing the wallpaper configuration.
As a random generator of wallpaper ought to provide images of consistent quality, the following sample of images is unfiltered*. All were created with a configuration file similar to the one provided under setup/wallrnd.toml.
* To provide a variety of patterns, tilings, and themes, the six were created in succession by altering the configuration file slightly so that only one pattern, tiling, and theme was available. This method guarantees variability without biasing quality. Hence the above sample can be considered representative of the general quality of generated wallpapers.