Wallpaper Engine KDE Plugin for NixOS

This package provides integration between KDE Plasma and Wallpaper Engine, allowing you to use Wallpaper Engine wallpapers in your KDE desktop environment.

Features

Use Wallpaper Engine wallpapers directly from your Steam Workshop subscription
Support for animated wallpapers through the QML renderer
Integration with KDE Plasma settings

Usage

Installation

Add the module to your NixOS configuration:

{ config, ... }:
{
  andreas.wallpaper-engine-kde-plugin.enable = true;
}

After applying your configuration (sudo nixos-rebuild switch), the plugin will be available in KDE Plasma.

Setting up Wallpaper Engine Content

The plugin requires access to your Wallpaper Engine content from Steam:

Make sure you own Wallpaper Engine on Steam and have subscribed to wallpapers
The default location for Steam Workshop content is:
- ~/.local/share/Steam/steamapps/workshop/content/431960/
In KDE Plasma:
- Right-click on the desktop → Configure Desktop and Wallpaper
- Select "Wallpaper Engine" from the wallpaper type list
- In the configuration panel, set the path to your Wallpaper Engine workshop content
- Browse and select a wallpaper from your collection

Troubleshooting

If the plugin doesn't appear in KDE wallpaper selection:

Check that the symlink was created properly: ls -la ~/.local/share/plasma/wallpapers/

If missing, manually create the symlink:

ln -sf /run/current-system/sw/share/plasma/wallpapers/com.github.catsout.wallpaperEngineKde ~/.local/share/plasma/wallpapers/

If wallpapers don't display properly:

Make sure the workshop content path is correctly set in the wallpaper configuration
Some complex wallpapers may not be supported due to limited shader support

Credits

This package is based on the wallpaper-engine-kde-plugin project by catsout.

1.9 KiB Raw Blame History