Known Issues

Known Issues

From the project's README:

• Some Scene wallpapers may crash KDE. Remove the WallpaperSource line in ~/.config/plasma-org.kde.plasma.desktop-appletsrc and restart KDE to recover.
• Mouse long-press to enter panel edit mode is broken on desktop while a live wallpaper is running.
• Screen locking is not supported. The lock screen will show a static image, not the live wallpaper.

Recovering from a crash loop

If picking a Scene wallpaper kills plasmashell and it crashes again on every login:

1. Switch to a TTY (Ctrl+Alt+F2) or open KRunner.
2. Stop plasmashell so the config file isn't overwritten:

   systemctl --user stop plasma-plasmashell.service

3. Edit ~/.config/plasma-org.kde.plasma.desktop-appletsrc and delete any line beginning with WallpaperSource=. Optionally set Image= to a plain image path in the same [Wallpaper] block to guarantee a static fallback.
4. Restart Plasma:

   systemctl --user start plasma-plasmashell.service

Panel edit mode

Long-press on the desktop to bring up Plasma's edit overlay does not work while a live wallpaper is running.

Workaround: use the desktop toolbox icon (the hamburger in the corner) or right-click → Enter Edit Mode.

Screen locking

When the screen is locked, KDE uses its own greeter renderer that doesn't load this plugin. Your lock screen will show a static image (set in System Settings → Colours & Themes → Login Screen / Lock Screen), not the live wallpaper.

Web wallpapers

The web view is QtWebEngine (Chromium), so HTML/CSS/JS and WebGL work as you'd expect. If a particular Web wallpaper misbehaves it's usually a very new or unusual browser feature, not WebGL as a whole.