# 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.