This project provides an aesthetic-first wallpaper selector for Wayland environments, supporting images, videos, and Wallpaper Engine scenes. It offers automatic theme generation using Matugen, integrated browsing of Wallhaven.cc and Steam, and advanced filtering, catering to users who manage large wallpaper collections and desire a visually rich desktop experience.

How It Works

Skwd-wall employs a two-part architecture: a background daemon for tasks like optimization and database caching, and a GUI for user interaction. It unifies various media types, automatically sorting them by hue and saturation into color groups. A key feature is its ability to extract color palettes from any wallpaper (including videos and WE scenes) to generate Matugen themes, ensuring a cohesive UI. The system supports executing custom scripts post-wallpaper application for theming integration and offers Ollama integration for AI-driven automatic tagging. Aggressive caching is utilized to ensure smooth navigation through extensive wallpaper libraries.

Quick Start & Requirements

• Primary install/run: Clone the repository (git clone https://github.com/liixini/skwd-wall && cd skwd-wall), then run the daemon (quickshell -p daemon.qml) and bind a key to toggle the selector (quickshell ipc -p daemon.qml call wallpaper toggle).
• Prerequisites: Requires a Linux system with a wlr-layer-shell capable Wayland compositor (e.g., KDE Plasma, Hyprland, Sway, Niri; not compatible with GNOME). Core dependencies include quickshell, Qt6 Multimedia, awww, matugen, ffmpeg, ImageMagick, curl, sqlite3, inotify-tools, and specific fonts (Nerd Fonts Symbols, Roboto, Material Design Icons). Optional dependencies for enhanced functionality include mpvpaper, ollama, steamcmd, and linux-wallpaperengine.
• KDE Plasma: Requires the Smart Video Wallpaper Reborn Plasma plugin for video wallpaper support.
• Setup: Installation involves dependency management (via package managers, AUR, or Nix), cloning, and configuring compositor keybinds. Daemon PSS is ~100MB, GUI ~175MB for 1000 wallpapers.

Highlighted Details

• Unified support for static images, videos, and Wallpaper Engine scenes.
• Automatic color sorting and Matugen theme generation from any wallpaper source.
• Integrated browsing and selection from Wallhaven.cc and Steam Workshop.
• Ollama integration for AI-powered automatic wallpaper tagging.
• Multiple visual presentation styles (parallelogram, grid, hexagon) with animations.
• Optional image optimization (WebP conversion, downscaling) and video optimization (WIP).

Maintenance & Community

The project appears to be a standalone component extracted from the author's personal shell, Skwd. No specific community channels (Discord/Slack), notable contributors, or sponsorships are mentioned in the README.

Licensing & Compatibility

The project is released under the MIT license, permitting commercial use and modification. It is designed for Wayland compositors but explicitly does not support GNOME.

Limitations & Caveats

Support for subdirectories within wallpaper collections is currently under development. Keybind customization is being investigated. Video optimization features are marked as Work In Progress (WIP). NixOS installation instructions are experimental and noted with a "proceed at your own risk" warning.