diff options
Diffstat (limited to 'modules/keyboard/kmonad-nixos-module.nix')
| -rw-r--r-- | modules/keyboard/kmonad-nixos-module.nix | 187 |
1 files changed, 187 insertions, 0 deletions
diff --git a/modules/keyboard/kmonad-nixos-module.nix b/modules/keyboard/kmonad-nixos-module.nix new file mode 100644 index 0000000..5f6cd34 --- /dev/null +++ b/modules/keyboard/kmonad-nixos-module.nix @@ -0,0 +1,187 @@ +{ config, lib, pkgs, ... }: + +let + cfg = config.services.kmonad; + + # Per-keyboard options: + keyboard = { name, ... }: { + options = { + name = lib.mkOption { + type = lib.types.str; + example = "laptop-internal"; + description = "Keyboard name."; + }; + + device = lib.mkOption { + type = lib.types.path; + example = "/dev/input/by-id/some-dev"; + description = "Path to the keyboard's device file."; + }; + + extraGroups = lib.mkOption { + type = lib.types.listOf lib.types.str; + default = [ ]; + example = [ "openrazer" ]; + description = '' + Extra permission groups to attach to the KMonad instance for + this keyboard. + + Since KMonad runs as an unprivileged user, it may sometimes + need extra permissions in order to read the keyboard device + file. If your keyboard's device file isn't in the input + group you'll need to list its group in this option. + ''; + }; + + defcfg = { + enable = lib.mkEnableOption '' + Automatically generate the defcfg block. + + When this is option is set to true the config option for + this keyboard should not include a defcfg block. + ''; + + compose = { + key = lib.mkOption { + type = lib.types.nullOr lib.types.str; + default = "ralt"; + description = "The (optional) compose key to use."; + }; + + delay = lib.mkOption { + type = lib.types.int; + default = 5; + description = "The delay (in milliseconds) between compose key sequences."; + }; + }; + + fallthrough = lib.mkEnableOption "Reemit unhandled key events."; + + allowCommands = lib.mkEnableOption "Allow keys to run shell commands."; + }; + + config = lib.mkOption { + type = lib.types.lines; + description = "Keyboard configuration."; + }; + }; + + config = { + name = lib.mkDefault name; + }; + }; + + # Create a complete KMonad configuration file: + mkCfg = keyboard: + let defcfg = '' + (defcfg + input (device-file "${keyboard.device}") + output (uinput-sink "kmonad-${keyboard.name}") + '' + + lib.optionalString (keyboard.defcfg.compose.key != null) '' + cmp-seq ${keyboard.defcfg.compose.key} + cmp-seq-delay ${toString keyboard.defcfg.compose.delay} + '' + '' + fallthrough ${lib.boolToString keyboard.defcfg.fallthrough} + allow-cmd ${lib.boolToString keyboard.defcfg.allowCommands} + ) + ''; + in + pkgs.writeTextFile { + name = "kmonad-${keyboard.name}.cfg"; + text = lib.optionalString keyboard.defcfg.enable (defcfg + "\n") + keyboard.config; + checkPhase = "${cfg.package}/bin/kmonad -d $out"; + }; + + # Build a systemd path config that starts the service below when a + # keyboard device appears: + mkPath = keyboard: rec { + name = "kmonad-${keyboard.name}"; + value = { + description = "KMonad trigger for ${keyboard.device}"; + wantedBy = [ "default.target" ]; + pathConfig.Unit = "${name}.service"; + pathConfig.PathExists = keyboard.device; + }; + }; + + # Build a systemd service that starts KMonad: + mkService = keyboard: + let + cmd = [ + "${cfg.package}/bin/kmonad" + # NOTE: Removed because of version mismatch with 0.4.1 also because this is redundant + # "--input" + # ''device-file "${keyboard.device}"'' + ] ++ cfg.extraArgs ++ [ + "${mkCfg keyboard}" + ]; + + groups = [ + "input" + "uinput" + ] ++ keyboard.extraGroups; + in + { + name = "kmonad-${keyboard.name}"; + value = { + description = "KMonad for ${keyboard.device}"; + script = lib.escapeShellArgs cmd; + serviceConfig.Restart = "no"; + serviceConfig.User = "kmonad"; + serviceConfig.SupplementaryGroups = groups; + serviceConfig.Nice = -20; + }; + }; +in +{ + options.services.kmonad = { + enable = lib.mkEnableOption "KMonad: An advanced keyboard manager."; + + package = lib.mkOption { + type = lib.types.package; + default = pkgs.kmonad; + example = "pkgs.haskellPackages.kmonad"; + description = "The KMonad package to use."; + }; + + keyboards = lib.mkOption { + type = lib.types.attrsOf (lib.types.submodule keyboard); + default = { }; + description = "Keyboard configuration."; + }; + + extraArgs = lib.mkOption { + type = lib.types.listOf lib.types.str; + default = [ ]; + example = [ "--log-level" "debug" ]; + description = "Extra arguments to pass to KMonad."; + }; + }; + + config = lib.mkIf cfg.enable { + environment.systemPackages = [ cfg.package ]; + + users.groups.uinput = { }; + users.groups.kmonad = { }; + + users.users.kmonad = { + description = "KMonad system user."; + group = "kmonad"; + isSystemUser = true; + }; + + services.udev.extraRules = '' + # KMonad user access to /dev/uinput + KERNEL=="uinput", MODE="0660", GROUP="uinput", OPTIONS+="static_node=uinput" + ''; + + systemd.paths = + builtins.listToAttrs + (map mkPath (builtins.attrValues cfg.keyboards)); + + systemd.services = + builtins.listToAttrs + (map mkService (builtins.attrValues cfg.keyboards)); + }; +} |
