/gnome-macos-remap

Script remaps default GNOME keyboard shortcuts to macOS standards. This provides native desktop environment feel for Mac users that are utilizing GNOME-based Linux desktop environment. Read more info about the script here: https://medium.com/@petrstepanov/a-macos-like-keyboard-remap-on-ubuntu-linux-cae1d108a97

Primary LanguageShell

GNOME → macOS Keyboard Remap

Important

This keyboard remap is based on Autokey functionality. Therefore it works with Xorg only.

Similar remap is available for Wayland and is published here.

Gnome macOS Remap Icon Gnome macOS Remap Icon

Migrating to Linux from a Mac?

This bash script remaps native GNOME desktop environment keybindings to the macOS defaults. Very useful keyboard remap for Linux users who are running GNOME on a Macbook, Mac or a PC with Apple keyboard. Don't spend time getting used to the default GNOME keybindings. Run the script and use your Linux just like you do use your Mac. Here are some key remaps that are implemented:

  • Command key set as main system modifier key.
  • Copy and Paste work in Terminal with ⌘ c, ⌘ v. Regular interrupt ctrl c works in Terminal.
  • Nautilus keyboard hotkeys replaced with the Finder ones: navigate in and out of folder, delete folder, new folder...
  • Home and End keys assigned to macOS defaults ⌘ ← and ⌘ →.
  • Workspace switching works with ctrl ← and ctrl →.
  • Some macOS window manager keyboard shortcuts are implemented: application switcher ⌘ tab, ⌘ ~, close window ⌘ w.
  • Mission Contol the Mission Control key and Launchpad the Launchpad key media keys are remapped.
  • And more...

How does it work?

The functionality is based on the Autokey mechanism. On top of that the default GNOME shell keybindings are modified as well. Therefore it will only work in X11 window system. Wayland is not supported.

Prerequisities

Make sure you are using X11, not Wayland. Logout from your session. On the GNOME login screen find and click gear icon. Select option "GNOME on Xorg". Log back in.

Install Git and AutoKey with package manager of your choice:

  • On Debian based distributions (Ubuntu, Zorin...) run sudo apt-get install git autokey-gtk.
  • On Pop!_OS run sudo apt-get install git autokey-common autokey-gtk.
  • On Fedora run sudo dnf install git autokey autokey-gtk.

Installation

  1. Make sure you are running Xorg display server. If not sure logout from your session. On the GNOME login screen click ⚙ icon on the bottom right. Select GNOME on Xorg. Log in.
  2. Check out the repository to some arbitrary location and run the install.sh script in Terminal. Script will ask for administrator password.
mkdir -p ~/Downloads && cd ~/Downloads
rm -rf ./gnome-macos-remap
git clone https://github.com/petrstepanov/gnome-macos-remap
cd gnome-macos-remap
chmod +x ./install.sh ./uninstall.sh
./install.sh
  1. Open AutoKey (autokey-gtk). In Edit -> Preferences menu make sure the Automatically start AutoKey at login checkbox is on.
  2. Restart your computer.

Postinstall notes

  • To get a functionality similar to the macOS Spotlight, I recommend installing the Ulauncher application. You can assign the ⌘ space hotkey for the Ulauncher in its settings.
  • To replicate the emoji selector in macOS, there are at least two options:
    • Smile emoji selector for Linux is a great alternative. Install here. Assign macOS-like keyboard combination ctrl ⌘ space via custom keyboard shortcuts in GNOME settings.
    • Emote is another option. Install via snap here, or via other means detailed in the official repo here. After installation, you can assign a macOS-like keyboard combination ctrl ⌘ space by opening the application, clicking on the hamburger menu ☰, then Keyboard Shortcuts.
  • To enable gestures on X11 install touchegg followed up by the X11 Gestures GNOME extension.
  • Current implementation requires re-installing the script after each kernel update.
  • Logitech MX series keyboard users please use Solaar to set your keyboard to use macOS layout.

How to uninstall

  1. Navigate into the program directory in Terminal and run ./uninstall.sh.
  2. Restart your computer.

How to contribute

Please run the ./install.sh dev command. This will create a symbolic link for autokey scripts from the repository into the autokey settings. Therefore it will be easy to add or modify AutoKey scripts and introduce the pull request to the repoisitory.

Changelog

Sep 16, 2022 • Updated install script to resolve conflicting hotkeys.

Apr 23, 2022 • Changed setup mode from global (for all users) to local user. Fixed the ctrl d delete line shortcut workflow.

Apr 22, 2022 • Added support for new Screenshot tool in GNOME 42.

Mar 30, 2022 • Tweaked some Nano key combinations in Terminal.

Dec 16, 2021 • Fixed the ctrl w keyboard shortcut in Terminal.

Dec 14, 2021 • Improved pasting in GNOME Terminal.

Dec 13, 2021 • Fixed deprecated overlay hotkey introduced in GNOME 41.

Apr 30, 2021 • Added support for GNOME 40 horizontal workspace switching.

Rodmap

Some hotkeys need to be implemented on the application-specific basis. However a regexp-related issue in Autokey prevents doing it at the moment. More macOS hotkeys will be implemented once this issue is resolved.

After Autokey 0.96.0 is released there will be a major update to account on the new filtering system implementation.