Andreas Schaafsma 093feba49d changes
2025-07-15 01:30:58 +02:00

55 lines
1.9 KiB
Markdown

# 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
1. Add the module to your NixOS configuration:
```nix
{ config, ... }:
{
andreas.wallpaper-engine-kde-plugin.enable = true;
}
```
2. 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:
1. Make sure you own Wallpaper Engine on Steam and have subscribed to wallpapers
2. The default location for Steam Workshop content is:
- `~/.local/share/Steam/steamapps/workshop/content/431960/`
3. 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:
```bash
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](https://github.com/catsout/wallpaper-engine-kde-plugin) project by catsout.