Remapping keys in Agent

Although we did our best to make Agent as intuitive as possible, we get questions from time to time. By far, the most usual question is how to exchange the keys of the bottom row.

Let's say you want to exchange Alt and Fn.

Now select the base layer of your default keymap in Agent. You should see something like this:

The important thing to understand is that each key has an associated action. Let's click on Alt.

A popover appears that contains the type and properties of the action. The Keypress tab is active, so this is a keypress action (type) featuring no scancode and the left Alt modifier (properties).

Now let's see the action of the Fn key by clicking on it.

Now the Layer tab is active, which means that it's a layer switch action that activates the Fn layer while holding this key.

You simply have to exchange the actions of the Alt and Fn keys by clicking on them and setting their action type and properties. Make sure to check the "Remap on all layers" checkbox for modifier keys before clicking on the "Remap key" button.

Lastly, click on the "Save to keyboard" button in the bottom right corner.

Last but not least, you can play with the web demo of Agent in the browser without installing it on your computer. Give it a try!

That's about it! Happy remapping!

The comments are closed, but our forum is available for public discussion.

9 Comments

  1. Jared 2020-08-27 at 05:23

    Is there a way to have a secondary function while holding shift?

    Specifically, I'm wanting Shift + Backspace to perform the Delete function, but so far I've been unable to figure out how to get that configured!

  2. LJ Sinclair 2022-10-21 at 11:57

    how do I remap an arrow key from the Mod overlay to the Main overlay?
    I'm intending to move the arrows to RH FN, Alt, System and CTRL keys

    • László Monda 2022-10-21 at 12:27

      You can already map arrows to the Fn layer. The next Agent version will also support modifier layers, allowing you to map arrows via modifiers.

  3. Rob 2022-11-10 at 14:21

    Is it possible to remap the left mod key to space, and have the mod available on the keyboard shell buttons?

  4. Nicolette Quigley 2023-01-24 at 17:44

    Hi,
    do you have information for remapping the keyboard for German users? I need the letter ä, ö, ü and woul like to switch y and z.

    • László Monda 2023-01-24 at 21:25

      Hi Nicolette! Please see check out this article.

  5. Andrew Kirkpatrick 2023-03-09 at 15:41

    Apologies if this is already possible, but is there a way currently or a plan in the future to allow tap-hold options? (similar to https://github.com/qmk/qmk_firmware/blob/master/docs/tap_hold.md)

    For example I'm wondering if I can bind CapsLock to Escape on tap and Control on hold

    • László Monda 2023-03-09 at 23:25

      Please open a new issue, and my colleague will reply on GitHub.

Comments are closed.