Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

88 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wallrus

Wallrus icon

A user-friendly GNOME (GTK4) application for generating colorful abstract wallpapers based on different patterns and effects.

For those who prefer minimalist, colorful wallpapers and like changing colors once in a while to keep things fresh.

Screenshot From 2026-02-22 15-04-59

Example wallpapers

wallrus_bars_1771764551 wallrus_bars_1771764536 wallrus_waves_1771764682 wallrus_terrain_1771764802 wallrus_terrain_1771764772 wallrus_circle_1771764645

Features

  • 5 shader presets — Bars, Circle, Plasma, Waves, and Terrain, each with dedicated parameters (angle, scale, time scrub, center position)
  • Hundreds of bundled palette images across several categories (cold, dark, fall, gradient, light, pastel, retro, sunset, warm, winter, etc.)
  • Custom palettes — tweak individual colors with the color pickers, then save your palette for later. Saved palettes appear in a "Custom" category and can be deleted at any time.
  • Blend control — go from hard flag-like stripes to fully smooth gradients
  • Effects — Distortion, lighting, and noise
  • Export — PNG or JPEG at 1080p, 1440p, or 4K via a native save dialog (defaults to your Pictures folder; resolution auto-detected from your display)
  • Set as wallpaper — uses the XDG Desktop Portal to set your GNOME wallpaper
  • Keyboard shortcuts — Ctrl+E (export), Ctrl+Shift+W (set as wallpaper)

Requirements

  • GTK 4 (≥ 4.10)
  • libadwaita (≥ 1.4)
  • OpenGL 3.3+ capable GPU
  • Rust 1.70+

System packages (Fedora):

sudo dnf install gtk4-devel libadwaita-devel

System packages (Ubuntu/Debian):

sudo apt install libgtk-4-dev libadwaita-1-dev

Building

cargo build --release

The binary is at target/release/wallrus.

Installing

The included install script builds a release binary and copies everything to ~/.local (binary, desktop file, icon, metainfo, and bundled palettes):

./install.sh

To install to a different prefix:

PREFIX=/usr/local ./install.sh

You may need to log out and back in for the application icon to appear in your launcher.

Nix

A Nix flake is provided. You can run Wallrus directly without installing:

nix run github:megakode/wallrus

To add it to a NixOS configuration:

# flake.nix
{
  inputs.wallrus.url = "github:megakode/wallrus";
  # ...
}

# configuration.nix
environment.systemPackages = [
  inputs.wallrus.packages.${pkgs.system}.default
];

A development shell with all native dependencies, rust-analyzer, clippy, and rustfmt is also available:

nix develop

License

GPL-3.0-or-later. See LICENSE for details.

About

Gnome (GTK4) application to generate colorful wallpapers based on gradients and different effects.

Resources

Stars

63 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages