Giter Club home page Giter Club logo

pragyanhazarika / gnome-macos-remap Goto Github PK

View Code? Open in Web Editor NEW

This project forked from petrstepanov/gnome-macos-remap

0.0 1.0 0.0 190 KB

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 informatino about the script on Medium: https://medium.com/@petrstepanov/a-macos-like-keyboard-remap-on-ubuntu-linux-cae1d108a97

Shell 79.19% Python 20.81%

gnome-macos-remap's Introduction

GNOME → macOS Keyboard Remap

This keyboard remap is based on Autokey functionality. Therefore it currently works with Xorg only. Wayland solution is in early development and is published here.

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.

gnome-macos-remap's People

Contributors

petrstepanov avatar alexjyong avatar olearycrew avatar cstrouse avatar misaka13514 avatar curiousercreative avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.