Quick Start

Once you have installed the module, you can start configuring your environment.

Here is a minimal "Hello World" configuration that sets a dark theme, configures a bottom panel with standard widgets, and defines a keyboard shortcut.

Add this to your home.nix:

{ pkgs, ... }: {
  programs.plasma = {
    enable = true;

    # 1. Workspace Settings
    workspace = {
      lookAndFeel = "org.kde.breezedark.desktop";
      wallpaper = "${pkgs.kdePackages.plasma-workspace-wallpapers}/share/wallpapers/Patak/contents/images/1080x1920.png";
    };

    # 2. Panel Configuration
    panels = [
      {
        location = "bottom";
        widgets = [
          "org.kde.plasma.kickoff"        # Start Menu
          "org.kde.plasma.icontasks"      # Task Manager
          "org.kde.plasma.marginsseparator"
          "org.kde.plasma.systemtray"
          "org.kde.plasma.digitalclock"
        ];
      }
    ];

    # 3. Window Manager Shortcuts
    shortcuts = {
      kwin = {
        "Switch Window Down" = "Meta+J";
        "Switch Window Up" = "Meta+K";
      };
    };
  };
}

Applying Changes

Run your standard Home Manager switch command:

home-manager switch

(Or nixos-rebuild switch if using Home Manager as a NixOS module).

Next Steps