Skip to content

Instantly share code, notes, and snippets.

@numpde
Last active October 18, 2025 13:15
Show Gist options
  • Save numpde/219b3fd134e2e8b94c25faa7cb0043fb to your computer and use it in GitHub Desktop.
Save numpde/219b3fd134e2e8b94c25faa7cb0043fb to your computer and use it in GitHub Desktop.
Installation and remapping process for key remapping using keyd (ASUS ROG FALCHION)

Keyd Setup for ASUS ROG FALCHION Keyboard

This guide installs and configures keyd to remap keys on the ASUS ROG FALCHION keyboard.

  1. Install keyd
    sudo add-apt-repository ppa:keyd-team/ppa
    sudo apt update
    sudo apt install keyd
    sudo systemctl enable --now keyd

  2. Find Your Keyboard’s Vendor:Product:ID
    The keyd executable installed by the package may be named keyd.rvaiya instead of keyd.
    Run with full path:
    sudo /usr/bin/keyd.rvaiya monitor
    Press any key and look for output like (for example):
    ASUSTeK ROG FALCHION 0b05:193e:5a05be1d rightcontrol down
    The 0b05:193e:5a05be1d is your keyboard ID.

(Optionally, create a symlink for convenience:
sudo ln -s /usr/bin/keyd.rvaiya /usr/local/bin/keyd
Then you can run sudo keyd monitor as usual.)

  1. Configure Key Remapping
    Edit the keyd configuration:
    sudo nano /etc/keyd/default.conf
    Add the following:
[ids]  
0b05:193e:5a05be1d  

[main]  
rightcontrol = left  
rightshift = up  
left = down

[control+alt]  
space = macro(C-S-u 2004 enter)  # optional

Save and exit (Ctrl + X, Y, Enter).

  1. Apply Changes
    sudo systemctl restart keyd

  2. Test the Remapping
    Run with full path or symlink:
    sudo /usr/bin/keyd.rvaiya monitor
    (or sudo keyd monitor if symlink created)
    Press Right Ctrl, Right Shift, Left → Should map as Left, Up, Down.

  3. Verify Final Mapping
    sudo /usr/bin/keyd.rvaiya list-keys
    (or sudo keyd list-keys if symlink created)
    If needed, force apply:
    sudo /usr/bin/keyd.rvaiya bind rightcontrol=left

Done! Reboot and test again.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment