wally-rs

Crates.iowally-rs
lib.rswally-rs
version0.5.3
created_at2025-11-30 18:01:14.521537+00
updated_at2025-11-30 18:01:14.521537+00
descriptionElegant, minimal, and sleek wallpaper generator.
homepagehttps://github.com/jp-zuniga/wally
repositoryhttps://github.com/jp-zuniga/wally
max_upload_size
id1958569
size140,119
Joaquín Zúñiga (jp-zuniga)

documentation

README

wally

Elegant, minimal, and sleek wallpaper generator.

Example wallpaper generated by wally.

Take a look at the samples to see more of what wally can do.

Installation

Currently, the only way to install wally is to download the latest release on Github. cargo and nix installations are planned.

Usage

Usage: wally [OPTIONS] <COMMAND>

Commands:
  dots    Create a wallpaper of randomly-generated dots
  themes  List available color palettes
  help    Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

CLI Options:
      --color     Force color output
      --no-color  Disable color output

dots

Usage: wally dots [OPTIONS]

Options:
  -h, --help  Print help

Wallpaper Options:
  -d, --dot-size <DOT_SIZE>  Radius of generated dots.             [default: 40]
  -s, --steps    <STEPS>     Density of generated dots.            [default: 80]
  -n, --name     <NAME>      Name of generated wallpaper.          [default: wally]
  -f, --format   <FORMAT>    Output format of generated wallpaper. [default: png]
  -p, --palette  <PALETTE>   Color palette of generated wallpaper. [default: rose-pine-moon]
  -W, --width    <WIDTH>     Width of generated wallpaper.         [default: 1920]
  -H, --height   <HEIGHT>    Height of generated wallpaper.        [default: 1080]
  -P, --padding  <PADDING>   Padding around wallpaper borders.     [default: 200]
      --swap                 Swap width and height.
      --seed     <SEED>      Optional seed for reproducibility.

CLI Options:
      --color     Force color output
      --no-color  Disable color output

Color Palettes

wally fully supports Catppuccin, Dracula, Gruvbox, Rosé Pine, and many more popular color palettes!

If your favorite one isn't available yet, it can be easily added to the themes module. You can find the relevant documentation here. PRs with your favorite color palettes are welcome!

Development

If you're interested in extending, fixing, or improving wally, you'll need to clone this repository and install the packages listed in shell.nix. For nix users, this is as simple as running nix-shell shell.nix.

For everyone else, make sure you've installed the latest version of Rust using rustup.

Acknowledgements

This project is a rewrite and extension of Oliver Thurley's p5.js scripts: dots and cubes.

License

wally is licensed under the GPLv3.

Commit count: 0

cargo fmt