Simple Linux Wallpaper Engine GUI

A modern, universal GUI for linux-wallpaperengine.

I encountered various problems on GNOME and KDE. I recommend using Linux Wallpaper Engine on tiling window managers such as i3, hyprland, and bspwm. For KDE, I recommend trying this plugin

Screenshots

Installation (Arch Linux / Manjaro)

The easiest way is to install via AUR. This will automatically install the backend (linux-wallpaperengine) and all dependencies.

yay -S simple-linux-wallpaperengine-gui-git

Installation (Nix)

Flake Install (Recommended)

Add to your flake inputs,

inputs = {
  simple-wallpaper-engine = {
    url = "github:Maxnights/simple-linux-wallpaperengine-gui";
    inputs = {
      nixpkgs.follows = "nixpkgs";
      home-manager.follows = "home-manager";
    };
  };
  # ...
}

Then in your home manager config, import the home manager module and enable the program.

{inputs, ...}: {
  imports = [inputs.simple-wallpaper-engine.homeManagerModules.default];
  # ...
  programs.simple-wallpaper-engine.enable = true;
}

Imperative Install

nix profile install github:Maxnights/simple-linux-wallpaperengine-gui

1. Prerequisites (The Backend)

This is just a GUI. You must install the core backend engine first. If you installed my GUI from AUR, then the main backend engine from Almamu(https://github.com/Almamu/linux-wallpaperengine) comes as a dependency. So you can skip this step.

Arch / Manjaro

yay -S linux-wallpaperengine

Debian / Ubuntu / Fedora (Build from Source)

Detailed instructions are here, but essentially:

# Install build tools (Debian/Ubuntu)
sudo apt install build-essential cmake libx11-dev libxrandr-dev liblz4-dev

# Install build tools (Fedora)
sudo dnf install cmake gcc-c++ libX11-devel libXrandr-devel lz4-devel

# Clone & Build
git clone https://github.com/Almamu/linux-wallpaperengine.git
cd linux-wallpaperengine && mkdir build && cd build
cmake ..
make
sudo make install

2. Installation (The GUI)

This one-step script installs Python dependencies, and sets up the app.

git clone https://github.com/Maxnights/simple-linux-wallpaperengine-gui.git
cd simple-linux-wallpaperengine-gui
chmod +x install.sh
./install.sh

3. Usage

Start the application:

./run_gui.sh

Troubleshooting

"linux-wallpaperengine not found" Ensure you completed Step 1. Run linux-wallpaperengine --help in a terminal to verify it's installed globally.

Wallpapers not showing? Go to the Library tab and click Scan Local Wallpapers. The app searches standard paths including ~/.local/share/Steam, ~/.var/app/com.valvesoftware.Steam, and ~/snap/steam.