Skip to content

bartosjiri/autokey-macos

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 

Repository files navigation

AutoKey scripts for macOS-like shortcuts

A collection of scripts for Autokey that emulate macOS styled keyboard commands/sshortcuts in Linux and X11.

How to use

There are 2 different script packages available:

  • For unmodified command keys layout (where ctrl outputs control and cmd outputs super)

  • For modified command keys layout (where ctrl outputs super and cmd outputs control)

    ⮡ Learn how to modify the layout.

Using unmodified command keys layout

  1. Install AutoKey using your package manager or following AutoKey installation instructions.

  2. Clone or download the macOS-default folder to ~/.config/autokey/data/.

  3. Modify individual scripts in AutoKey to prevent an interference with default terminal shortcuts:

    Replace the 'xfce4-terminal.Xfce4-terminal' part with the terminal class name of your choice.

    To get the class name, open terminal, then open AutoKey, click on Window Filter -> Detect Window Properties -> click on terminal window and AutoKey will show you the name as Window class. Don't forget to cancel the Window Filter settings.

  4. Enable AutoKey at login: AutoKey -> Edit -> Preferences -> Automatically start Autokey at login.

Using modified command keys layout

  1. Install AutoKey using your package manager or following AutoKey installation instructions.

  2. Unbind AutoKey's configuration hotkey: AutoKey -> Edit -> Preferences -> Special hotkeys -> Show configuration window using a hotkey -> Clear

  3. Clone or download the macOS-switched folder to ~/.config/autokey/data/.

  4. Modify individual scripts in AutoKey to prevent an interference with default terminal shortcuts:

    Replace the 'xfce4-terminal.Xfce4-terminal' part with the terminal class name of your choice.

    To get the class name, open terminal, then open AutoKey, click on Window Filter -> Detect Window Properties -> click on terminal window and AutoKey will show you the name as Window class. Don't forget to cancel the Window Filter settings.

  5. Enable AutoKey at login: AutoKey -> Edit -> Preferences -> Automatically start Autokey at login.

Limitations

  • Command key input in terminals is troublesome, since macOS uses ctrl for all terminal operations. While the provided scripts provide a workaround for this, you won't be able to use these in built-in terminals (i.e. VS Code).

About

Autokey remapping to macOS-like shortcuts

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages