Go to file
Ulli Kehrle a7219eee17
2022-11-24 22:59:15 +01:00
example example: Add example flake.nix file 2022-06-24 15:20:10 -07:00
lib Initial Import 2022-06-22 16:57:08 -07:00
modules narf 2022-11-24 22:59:15 +01:00
script rc2nix: Block more dialogs 2022-09-28 09:51:11 -07:00
test demo: Add a demo app that runs Plasma in a VM 2022-06-22 16:57:13 -07:00
.envrc flake: Simplify the flake.nix file and add a devShell 2022-06-23 13:38:52 -07:00
.gitignore example: Add example flake.nix file 2022-06-24 15:20:10 -07:00
LICENSE Initial Import 2022-06-22 16:57:08 -07:00
README.md Add initial documentation 2022-06-24 16:04:00 -07:00
flake.lock Initial Import 2022-06-22 16:57:08 -07:00
flake.nix typo: Update module name to match change in 1492919230 2022-08-11 13:35:41 -07:00


Manage KDE Plasma with Home Manager

This project aims to provide Home Manger modules which allow you to configure KDE Plasma using Nix.

Configuration is broken down into three layers:

  1. High-level interface like many Home Manager modules:

      programs.plasma = {
        workspace.clickItemTo = "select";

    This layer is doesn't currently have many options. If using a high-level interface like this sounds interesting to you please consider contributing more options.

  2. Mid-level interface:

      programs.plasma = {
        shortcuts.kwin = {
          "Switch Window Down" = "Meta+J";
          "Switch Window Left" = "Meta+H";
          "Switch Window Right" = "Meta+L";
          "Switch Window Up" = "Meta+K";

    This layer is considered mid level because, while it generates a great deal of configuration for you, you must still know the name of the corresponding KDE setting to use it. (See information about the rc2nix tool below.)

  3. A low-level interface:

      programs.plasma = {
        files."baloofilerc"."Basic Settings"."Indexing-Enabled" = false;

    The other two layers ultimately generate Nix configuration for this low-level layer. Configuration at this level is essentially in the final state before being sent to the kwriteconfig5 tool.

An example is available in the example directory.

Capturing Your Current Configuration

To make it easier to migrate to Plasma Manger, and to help maintain your Nix configuration, this project includes a tool called rc2nix.

This tool will read KDE configuration files and translate them to Nix. The translated configuration is written to standard output. This makes it easy to:

  • Generate an initial Plasma Manager configuration file.

  • See what settings are changed by a GUI tool by capturing a file before and after using the tool and then using diff.

To run the rc2nix tool without having to clone this repository run the following shell command:

nix run github:pjones/plasma-manager

Contributions and Maintenance

I consider this a community project and welcome all contributions. If there's enough interest I would love to move this into nix-community once it has matured.

That said, this project works well enough for my needs. I don't have enough free time to maintain this project on my own. Therefore I won't be able to fix issues or implement new features without help.

Special Thanks

This work was inspired by the suggestions on Home Manger Issue #607 by people such as bew and kurnevsky. Thank you.