Xremap - Revision history

Deckori: /* Remapping the Copilot key */ Corrected code that doesn't work anymore and added more instructions

2026-04-16T13:33:46Z

Remapping the Copilot key: Corrected code that doesn't work anymore and added more instructions

← Older revision		Revision as of 13:33, 16 April 2026
Line 6:		Line 6:

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

			Start a shell with keyd available <code>nix-shell -p keyd</code> to monitor what the Copilot key does and see your keyboard id. From that shell, run <code>sudo keyd monitor</code> and press the Copilot key.

			<syntaxhighlight>
			AT Translated Set 2 keyboard 0001:0001:09b4e68d leftmeta down
			AT Translated Set 2 keyboard 0001:0001:09b4e68d leftshift down
			AT Translated Set 2 keyboard 0001:0001:09b4e68d f23 down
			AT Translated Set 2 keyboard 0001:0001:09b4e68d f23 up
			AT Translated Set 2 keyboard 0001:0001:09b4e68d leftshift up
			AT Translated Set 2 keyboard 0001:0001:09b4e68d leftmeta up
			</syntaxhighlight>

			Then translate the names of keys to the ones used by Xremap.

			You may then edit your configuration accordingly:

	{{file\|/etc/nixos/configuration.nix\|nix\|<nowiki>		{{file\|/etc/nixos/configuration.nix\|nix\|<nowiki>
Line 12:		Line 27:
	package = pkgs.xremap; # Use the official package to skip building xremap from source		package = pkgs.xremap; # Use the official package to skip building xremap from source
	userName = "username"; # The username of your user		userName = "username"; # The username of your user
	~~config.experimental_map.chords~~ = [		yamlConfig = ''
	{		experimental_map:
	keys = [ "Super_L, Shift_L, F23" ]~~; # This is the triggered key combination from when the copilot key is pressed~~		- chords:
	actions ~~= "~~Ctrl_R~~"; # This is the key that you want to remap the co-pilot key to~~		- keys: [Super_L, Shift_L, F23]
	timeout ~~= 500;~~		actions: Ctrl_R
	}		timeout: 30
	];		'';

	};		};
	</nowiki>}}		</nowiki>}}

Deckori: Added a note mentioning version mismatch errors

2026-04-15T14:07:13Z

Added a note mentioning version mismatch errors

← Older revision		Revision as of 14:07, 15 April 2026
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.}}

Deckori: Added: a reference for installing the flake module, instructions on how to remap a copilot key

2026-04-15T13:59:25Z

Added: a reference for installing the flake module, instructions on how to remap a copilot key

New page

=== Install the flake module ===

Refer to Xremap's documentation on their [https://github.com/xremap/nix-flake/blob/c1aa0dab35024c1b85e22934006dbddd4f86fc1e/docs/HOWTO.md#example-configuration 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:

{{file|/etc/nixos/configuration.nix|nix|<nowiki>
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;
}
];
};
</nowiki>}}

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.}}