wallpaper-engine (kde-/plasma-plugin)

arch (+ SteamOS) + Debian (+ Ubuntu, Kali, Deepin, Elementary, Mint etc.), Fedora / Nobara, other (f.e. hyprland)

• use wallpaper-engine-files natively (linux, precompiled
• KDE-Plasma Plugin (Desktop-Mode: right-click, background ...)

_{** precompiled for simple use (f.e. through limits of steam-decks-compilation-capabilities, see}

installation

no need to install the plugin through discover, everything gets installed system-wide through packages here

Arch

plasma 6.5.4+

sudo wget https://github.com/slynobody/SteamOS-wallpaper-engine-kde-plugin/releases/download/0.55d_arch/WallpaperEngine_kde6-1.1e-1-x86_64.pkg.tar.zst

sudo pacman -U ./WallpaperEngine_kde6-1.1e-1-x86_64.pkg.tar.zst --overwrite '*'

plasma 6.3 (-6.5.4)

sudo wget https://github.com/slynobody/SteamOS-wallpaper-engine-kde-plugin/releases/download/0.5.5c_arch/WallpaperEngine_kde6-3_1c-1-x86_64.pkg.tar.zst

sudo pacman -U ./WallpaperEngine_kde6-3_1c-1-x86_64.pkg.tar.zst --overwrite '*'

Legacy: plasma 6 (-6.2)

sudo wget https://github.com/slynobody/SteamOS-wallpaper-engine-kde-plugin/releases/download/0.5.5_qt6_arch/WallpaperEngine_kde6-1.1a-1-x86_64.pkg.tar.zst

sudo pacman -U ./WallpaperEngine_kde6-1.1a-1-x86_64.pkg.tar.zst --overwrite '*'

Legacy: plasma 5

sudo wget https://github.com/slynobody/SteamOS-wallpaper-engine-kde-plugin/releases/download/0.5.5_arch/WallpaperEngine_kde-1_1-1-x86_64.pkg.tar.zst

sudo pacman -U ./WallpaperEngine_kde-1_1-1-x86_64.pkg.tar.zst --overwrite '*'

SteamOS

SteamOS 3.8 (stable / beta)

sudo steamos-devmode enable --no-prompt

sudo wget https://github.com/slynobody/SteamOS-wallpaper-engine-kde-plugin/releases/download/0.5.5c_arch/WallpaperEngine_kde6-3_1c-1-x86_64.pkg.tar.zst

sudo pacman -U ./WallpaperEngine_kde6-3_1c-1-x86_64.pkg.tar.zst --overwrite '*'

plasmapkg2 -r ~/.local/share/plasma/wallpapers/com.github.casout.wallpaperEngineKde && qdbus org.kde.plasmashell /PlasmaShell org.kde.PlasmaShell.evaluateScript 'var allDesktops = desktops();print (allDesktops);for (i=0;i<allDesktops.length;i++) {d = allDesktops[i];d.wallpaperPlugin = "org.kde.image";d.currentConfigGroup = Array("Wallpaper", "org.kde.image", "General");d.writeConfig("Image", "file:///media/sda2/Background/SpaceWall/Escape_Function.jpg")}' & plasmashell --replace &

sudo steamos-readonly enable

SteamOS 3.9 (dev-Channel / 'main')

sudo steamos-devmode enable --no-prompt

sudo wget https://github.com/slynobody/SteamOS-wallpaper-engine-kde-plugin/releases/download/0.55d_arch/WallpaperEngine_kde6-1.1e-1-x86_64.pkg.tar.zst

sudo pacman -U ./WallpaperEngine_kde6-1.1e-1-x86_64.pkg.tar.zst --overwrite '*'

kpackagetool6 -r ~/.local/share/plasma/wallpapers/com.github.casout.wallpaperEngineKde && qdbus org.kde.plasmashell /PlasmaShell org.kde.PlasmaShell.evaluateScript 'var allDesktops = desktops();print (allDesktops);for (i=0;i<allDesktops.length;i++) {d = allDesktops[i];d.wallpaperPlugin = "org.kde.image";d.currentConfigGroup = Array("Wallpaper", "org.kde.image", "General");d.writeConfig("Image", "file:///media/sda2/Background/SpaceWall/Escape_Function.jpg")}' & plasmashell --replace &

sudo steamos-readonly enable

apt (Debian / Ubuntu)

Plasma 6.3 (-6.5) / qt 6.8.2 (-6.9.2)

wget https://github.com/slynobody/SteamOS-wallpaper-engine-kde-plugin/releases/download/0.6_beta/int_wallpaper_engine_qt6-1-1_amd64.deb

sudo apt install ./int_wallpaper_engine_qt6-1-1_amd64.deb

Legacy: Plasma 6 (6.1-6.2)

wget https://github.com/slynobody/SteamOS-wallpaper-engine-kde-plugin/releases/download/0.5.5a/int_wallpaper_engine_qt6-1-1_amd64.deb

sudo apt install ./int_wallpaper_engine_qt6-1-1_amd64.deb

Legacy: Plasma 5 / qt5*

wget https://github.com/slynobody/SteamOS-wallpaper-engine-kde-plugin/releases/download/0.5.5/int_wallpaper_engine_1-1_amd64.deb

sudo apt install ./int_wallpaper_engine_1-1_amd64.deb

after installation

1. Switch Wallpaper Engine to the compatibility beta: (-> prevents plasma crashes / higher chances problematic wps run)
   • Steam -> Library -> right-click Wallpaper Engine -> Properties -> Beta
   • Select "win 7 compatibility"
2. Restart Plasma:
   • Log out and back in, or run: plasmashell --replace & -- or restart
3. Configure your wallpaper:
   • Right-click desktop -> Configure Desktop and Wallpaper
   • Change wallpaper type from "Image" to "Wallpaper Engine"
   • Point it to your Steam library folder (the one containing steamapps)

common 'Steam library'-paths

~/.local/share/Steam

~/.steam/steam (steam-deck)

~/.var/app/com.valvesoftware.Steam/data/Steam (Flatpak)

crashes!

• CTRL+ALT+T (Terminal) -- or boot into konsole -- then type:

sed -i '/wallpaperEngineKde/d' ~/.config/plasma-org.kde.plasma.desktop-appletsrc & qdbus6 org.kde.Shutdown /Shutdown logout

• WPE needs to be installed through steam before usage (main source of 'scene'-errors because of missing 'assets'-folder)

- choose WPE-version in steam: 'windows 7 compatibility' (esp. when 'scenes' crash that formerly worked)

• also try this.

no responsibility taken for usage.

how do i get SteamOS 3.9?

gamemode, settings-tab left: scroll down, tap 'enter developer mode'

in the new developer-tab on the left: enable 'extended update-channels'

go back to system-tab left: enable new OS-Update-Channel 'Main', check for updates>

i dont use kde! (but gnome, lxqt, hyprland etc.)

• try this.

i want to remove this!

cd SteamOS-wallpaper-engine-kde-plugin

./remove.sh

Disclaimer

1. Use at your own risk!
2. This is for educational and research purposes only!
3. No responsibility taken for any local customizations of the git!