aboutsummaryrefslogtreecommitdiff
path: root/modules/keyboard/kmonad-nixos-module.nix
diff options
context:
space:
mode:
Diffstat (limited to 'modules/keyboard/kmonad-nixos-module.nix')
-rw-r--r--modules/keyboard/kmonad-nixos-module.nix187
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));
+ };
+}