GNOME → macOS Keyboard Remap for Wayland

This keyboard remap is based on the Xremap functionality and works with Wayland and Xorg.

How does it work?

Script doenloads the latest version of the xremap remapper for your architecture. Configuration file config.yml contains majority of the remapping instructions. On top of that the default GNOME shell and Mutter keybindings are modified. A systemd service is created and enabled for a particular user. Therefore after the install other users on the system will not be affected by the remap.

Prerequisities

• Install Git and GNOME extensions sudo <your-package-manager> install git gnome-shell-extensions.

Installation

1. Make sure you are running Wayland display server. Logout from your session. On the GNOME login screen click ⚙ icon on the bottom right. Select GNOME (defaults to Wayland). Log in.
2. Check out this repository run install.sh script in Terminal. Script will ask for administrator password.

cd ~/Downloads
git clone https://github.com/petrstepanov/gnome-macos-remap-wayland
cd gnome-macos-remap-wayland
chmod +x ./install.sh
./install.sh

3. Install and enable this GNOME extension.
4. Restart your computer.

How to uninstall

1. If repository was removed, check it out again. Navigate into the program directory in Terminal and run:

chmod +x ./uninstall.sh
./uninstall.sh

2. Restart your computer.

Logbook

May 24, 2024 • Added keybindings for the GNOME Console app.

Oct 01, 2023 • Blocker issue is resolved. Repository is ready for testing.

May 23, 2021 • Moving to Xremap functionality instead.

Dec 13, 2021 • First commit, testing out the Key Mapper.