Manage KDE Plasma with Home Manager

Plasma Manager provides Home Manager modules that allow you to configure the KDE Plasma Desktop declaratively using Nix.

Instead of manually clicking through System Settings and hoping your backups work, you can define your panels, widgets, shortcuts, themes, and window rules in a clean Nix syntax.

Key Features

  • Comprehensive Configuration: Manage Themes, Fonts, Panels, Widgets, KWin Scripts, Window Rules, and Shortcuts.
  • Declarative Panels: Define your panel layout and widgets in code.
  • Migration Tools: Includes rc2nix, a tool to snapshot your current KDE configuration and convert it into Nix code.
  • Config Protection: Options to strictly enforce configuration (overrideConfig) to ensure your system matches your code exactly.

Supported Versions

  • Plasma 6: The trunk branch (default) is focused on Plasma 6.
  • Plasma 5: Supported via the plasma-5 branch. While trunk may work for Plasma 5, using the dedicated branch is recommended for stability.

High-Level Capabilities

At a glance, you can configure:

  • Workspace: Global themes, colors, cursors, wallpapers, splash screens.
  • Desktop: Icons, background behavior, mouse actions.
  • Panels: Location, size, and widgets (Kickoff, Clock, Task Manager, etc.).
  • Input: Keyboard layouts, mouse acceleration, touchpad gestures.
  • Window Management: KWin effects, virtual desktops, window rules, night light.
  • Shortcuts: Global keybindings and custom command hotkeys.
  • Applications: Configuration for Konsole, Kate, Elisa, and more.

Where to start?

  1. Check the Installation guide to add it to your flake.
  2. Follow the Quick Start to apply a basic configuration.
  3. Learn how to migrate your existing setup with rc2nix.