plasma-manager/modules/hotkeys.nix

# Global hotkeys (user-defined keyboard shortcuts):
{ pkgs, config, lib, ... }:
let
  cfg = config.programs.plasma;

  commandString = command: (builtins.replaceStrings [ "%" ] [ "%%" ] command);

  group = rec {
    name = "plasma-manager-commands";
    desktop = "${name}.desktop";
    description = "Plasma Manager";
  };

  commandType = { name, ... }: {
    options = {
      name = lib.mkOption {
        type = lib.types.str;
        default = name;
        description = "Command hotkey name.";
      };

      comment = lib.mkOption {
        type = lib.types.str;
        default = name;
        description = "Optional comment to display in the KDE settings UI.";
      };

      key = lib.mkOption {
        type = lib.types.str;
        description = "The key combination that triggers the action.";
        default = "";
      };

      keys = lib.mkOption {
        type = with lib.types; listOf str;
        description = "The key combinations that trigger the action.";
        default = [ ];
      };

      command = lib.mkOption {
        type = lib.types.str;
        description = "The command to execute.";
      };

      logs.enabled = lib.mkOption {
        type = lib.types.bool;
        default = true;
        description = "Connect command's stdin and stdout to systemd journal with systemd-cat.";
      };

      logs.identifier = lib.mkOption {
        type = lib.types.str;
        default = lib.trivial.pipe name [
          lib.strings.toLower
          (builtins.replaceStrings [ " " ] [ "-" ])
          (n: "${group.name}-${n}")
        ];
        description = "Identifier passed down to systemd-cat.";
      };

      logs.extraArgs = lib.mkOption {
        type = lib.types.str;
        default = "";
        description = "Additional arguments provided to systemd-cat.";
      };
    };
  };
in
{
  options.programs.plasma.hotkeys = {
    commands = lib.mkOption {
      type = with lib.types; attrsOf (submodule commandType);
      default = { };
      description = "Commands triggered by a keyboard shortcut.";
    };
  };

  config = lib.mkIf
    (cfg.enable && builtins.length (builtins.attrNames cfg.hotkeys.commands) != 0)
    {
      xdg.desktopEntries."${group.name}" = {
        name = group.description;
        noDisplay = true;
        type = "Application";
        actions = lib.mapAttrs
          (_: command: {
            name = command.name;
            exec =
              if command.logs.enabled then
                "${pkgs.systemd}/bin/systemd-cat --identifier=${command.logs.identifier} ${command.logs.extraArgs} ${commandString command.command}"
              else (commandString command.command);
          })
          cfg.hotkeys.commands;
      };

      programs.plasma.configFile."kglobalshortcutsrc"."${group.desktop}" = {
        _k_friendly_name = group.description;
      } // lib.mapAttrs
        (_: command:
          let
            keys = command.keys ++ lib.optionals (command.key != "") [ command.key ];
          in
          lib.concatStringsSep "," [
            (lib.concatStringsSep "\t" (map (lib.escape [ "," ]) keys))
            "" # List of default keys, not needed.
            command.comment
          ])
        cfg.hotkeys.commands;
    };
}