Skip to content

Bring your PC/Windows/Linux hotkey to MacOS within 10 minutes!

License

Notifications You must be signed in to change notification settings

pdecat/hammerspoon-windows-mode

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 

Repository files navigation

hammerspoon-windows-mode

With this project, you are able to replace system-wide hotkeys such as cmd+c, cmd+v with their Windows/Linux equivalents, e.g., ctrl+c, ctrl+v. This project is heavily inpsired by karabiner-windows-mode. The benefit of hammerspoon over Karabiner-Elements is

  • Karabiner-Elements operates does NOT support tools like Barrier and input-leap.
  • Lua configuration used by hammerspoon is easier to tweak compared to the json format used by Karabiner-Elements

hammerspoon-windows-mode is meant to be minimistic, so it only implements relavent part of the keymaps defined in karabiner-windows-mode that I found most useful. However, the configuration framework is already there, and it should be easy to fork the project and configure it to your needs. If you think there is something important missing, please open an issue or PR.

Installation

First, make sure that hammerspoon is installed. You can install it with homebrew:

brew install --cask hammerspoon

Next, clone this repository as the following:

cd ~
mv .hammerspoon .hammerspoon.backup
git clone [email protected]:zhou13/hammerspoon-windows-mode.git .hammerspoon

Finally, click "Reload Config" in the hammerspoon tray icon. If you have not launched hammerspoon, you can simply start the application. It should work! The "Console" menu item will help you debug the problem in case of any issue.

Shortcuts

By default, the keymap does not apply to hypervisors, IDEs, remote desktops, or terminal emulators. The actual list of app bundle IDs can be found in init.lua.

Below is the full list of shortcuts for people who don't want to read the init.lua file:

Input Key Input Modifier(s) Output Key Output Modifier(s) Notes
A Ctrl A Command
B Ctrl B Command
F Ctrl F Command
H Ctrl H Command Only applies to web browsers.
I Ctrl I Command
L Ctrl L Command Only applies to web Browsers.
N Ctrl N Command
O Ctrl O Command
P Ctrl P Command
R Ctrl R Command
S Ctrl S Command
T Ctrl T Command
U Ctrl U Command
V Ctrl V Command
W Ctrl W Command
X Ctrl X Command
Y Ctrl Y Command
Z Ctrl Z Command
Home Left Arrow Command
Home Shift Left Arrow Command+Shift
End Right Arrow Command
End Shift Right Arrow Command+Shift
Left Arrow Ctrl Left Arrow Option
Left Arrow Ctrl+Shift Left Arrow Option+Shift
Right Arrow Ctrl Right Arrow Option
Right Arrow Ctrl+Shift Right Arrow Option+Shift

About

Bring your PC/Windows/Linux hotkey to MacOS within 10 minutes!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Lua 100.0%