Waywallen

Wallpaper Manager for Linux

中文 README · Discord

---

Waywallen is a dynamic wallpaper solution for Linux desktops.
It started life as a Wallpaper Engine plugin for KDE.

---

Screenshots

Quick Start

Install

Prebuilt binaries — grab the latest appimage from the Releases page.

Flatpak

From source — see BUILD.md.

Desktop integration

Desktop	Integration	Mouse input	Auto pause
KDE Plasma	waywallen-display	✅	✅
GNOME	waywallen-display	✅	✅
Hyprland	waywallen-display/layer_shell	✅	✅
Niri	waywallen-display/layer_shell	✅	❌
Sway	waywallen-display/layer_shell	✅	❌
COSMIC	waywallen-display/layer_shell	✅	❌

Known issue

• Web wallpapers on nvidia gpu require to set shared_texture_enabled OFF in web renderer setting.

Wallpaper plugins

• image plugin
• video plugin
  • hwdec by vulkan,vaapi
• wallhaven plugin

Third plugins

• open-wallpaper-engine
  • scene support
  • web support

Note

For third plugins:
You need to mannually download plugin zip and install in the ui's plugins page.
After installed, this plugin's update will be notified and handled by waywallen.

FAQ

• How to get logs
  You must exit the pre-launched waywallen daemon.

  export RSTD_LOG=debug RUST_LOG=debug,zbus=warn
  ./waywallen

• How to debug in flatpak

  flatpak install org.waywallen.waywallen.Debug
  flatpak run --devel --command=bash org.waywallen.waywallen
  # 1. run directly
  [📦 org.waywallen.waywallen ~]$ gdb waywallen
  (gdb) run
  Enable debuginfod for this session? (y or [n]) n
  ...
  # get the stacktrace
  (gdb) bt
  
  # 2. or use coredump file
  coredumpctl dump <id> -o core.save
  flatpak run --devel --filesystem=host --command=bash org.waywallen.waywallen
  [📦 org.waywallen.waywallen ~]$ gdb waywallen core.save
  ...