Jump to content

Xremap: Difference between revisions

From Official NixOS Wiki
Deckori (talk | contribs)
Added: a reference for installing the flake module, instructions on how to remap a copilot key
 
Deckori (talk | contribs)
m Added a note mentioning version mismatch errors
Line 24: Line 24:
This configuration was made by referring to a [https://github.com/xremap/xremap/discussions/762 GitHub discussion].
This configuration was made by referring to a [https://github.com/xremap/xremap/discussions/762 GitHub discussion].


  {{note|The above works as of Xremap version <code>0.14.19</code> in the <code>nixpkgs-unstable</code> channel.}}
  {{note|At the time of writing, the above works as of Xremap version <code>0.14.19</code> in the <code>nixpkgs-unstable</code> channel. The flake version provided version <code>0.15.1</code>. This version mismatch might cause errors. So adjust your configuration accordingly.}}

Revision as of 14:07, 15 April 2026

Install the flake module

Refer to Xremap's documentation on their GitHub repository.

Remapping the Copilot key

An increasing number of new laptops come with a Copilot key that you might want to remap. Follow these steps to do so:

❄︎ /etc/nixos/configuration.nix
services.xremap = {
      enable = true;
      package = pkgs.xremap; # Use the official package to skip building xremap from source
      userName = "username"; # The username of your user
      config.experimental_map.chords = [
        {
          keys = [ "Super_L, Shift_L, F23" ]; # This is the triggered key combination from when the copilot key is pressed
          actions = "Ctrl_R"; # This is the key that you want to remap the co-pilot key to
          timeout = 500;
        }
      ];
};

This configuration was made by referring to a GitHub discussion.

Note: At the time of writing, the above works as of Xremap version 0.14.19 in the nixpkgs-unstable channel. The flake version provided version 0.15.1. This version mismatch might cause errors. So adjust your configuration accordingly.