Installation

Plasma Manager is designed to be used as a module within Home Manager. The recommended installation method is using Nix Flakes.

Prerequisites

• Nix installed on your system.
• Home Manager configured (either standalone or as a NixOS module).
• A running KDE Plasma session.

Using Nix Flakes

Add plasma-manager to your flake.nix inputs and import the module into your Home Manager configuration.

1. Update inputs

In your flake.nix:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";

    home-manager = {
      url = "github:nix-community/home-manager";
      inputs.nixpkgs.follows = "nixpkgs";
    };

    # Add plasma-manager
    plasma-manager = {
      url = "github:nix-community/plasma-manager";
      inputs.nixpkgs.follows = "nixpkgs";
      inputs.home-manager.follows = "home-manager";
    };
  };

  outputs = { self, nixpkgs, home-manager, plasma-manager, ... }:
    let
      system = "x86_64-linux";
      pkgs = nixpkgs.legacyPackages.${system};
    in {
      homeConfigurations."username" = home-manager.lib.homeManagerConfiguration {
        inherit pkgs;
        modules = [
          # Import the plasma-manager module
          plasma-manager.homeModules.plasma-manager

          ./home.nix
        ];
      };
    };
}

Note for Plasma 5 Users: If you are using Plasma 5, use the plasma-5 branch URL: github:nix-community/plasma-manager/plasma-5.

2. Enable the module

In your home.nix file, you can now enable the module:

{
  programs.plasma.enable = true;
}

Using Nix Channels

If you are not using Flakes, you can add the channel manually.

1. Add the channel:

   nix-channel --add https://github.com/nix-community/plasma-manager/archive/trunk.tar.gz plasma-manager
   nix-channel --update

2. Import the module:

   In your Home Manager configuration file (usually ~/.config/home-manager/home.nix):

   {
     imports = [
       <plasma-manager/modules>
     ];
   
     programs.plasma.enable = true;
   }