Repository files navigation

Yet another one productivity-oriented keyboard keys remapper for macOS.
It is largely based onVonng'sCapsLock Enhancement, but with a twist:WASD-style navigation instead of Vim-style.
For those who are more accustomed to arrow keys or FPS controls ᗜωᗜ

This set up is tailored specifically to my workflow and has no aim to cover all possible use cases,though it is easily customizable to your preferences if you like the general idea.

TurnCapslock into a new modifier –Hyper*.Do stuff without moving your hands away from the keyboard's home row:

• Navigate and edit text quickly

• Delete words and lines with a single key press

• Navigate macOS: desktops, apps and tabs

• Start and switch active apps

• Control the mouse pointer, buttons and wheels with a keyboard

• ... and other workflow enhancements

• macOS

• brew

1. Install Karabiner-Elements:

   brew install --cask karabiner-elements

2. Download the configuration and allow Karabiner to load it;

3. Enable HyperIJKL in Karabiner-Elements:

   Karabiner-Elements → Complex Modifications → Add rule → Enable all

4. Enjoy!

Several non-essential HyperIJKL features (marked inDescription section) require additionalinstallation steps. SeeAdvanced Installation for instructions.

HoldCapslock to activateHyper* mode.
PressCapslock once to sendesc.
Capslock + esc to toggle Capslock mode.

* additional set up required. SeeAdvanced Installation.

Navigate macOS: desktops, windows, tabs, Mission Control and Launchpad.

Use keyboard keys to control the mouse pointer, buttons and wheels.

These shortcuts duplicate some shortcuts fromOS Navigation. Their aim is to grant the abilityto navigate windows and desktops while using a mouse with your right hand at the same time.

These shortcuts launch applications or switch to a desktop with the said application if it is already running.
* § starts multiple apps that are configured inhyperijkl.yml.
§ is placed on top of atab on ISO (EU) keyboards,replace it with` to get similar results on ANSI (US) keyboards (seeModifying HyperIJKL).

Press* 1 to center the mouse pointer on Display 1. Works with digits from 1 to 4.

Press* ; to select EN input source.
* p to select the second input source.
* / to select the third input source.
* ␣ to select the previous input source (like the default⌥ ␣ in macOS).
* ⌘ ␣ to select the next source in the input menu(iterates through the full list of input sources like the default⌥ ⌘ ␣).

Requires manual set up of additional input sources to work.You will have to edithyperijkl.yml by replacing predefined input language codes to desired ones.Those input languages should also be configured in macOS.Reinstall the script (seeModifying HyperIJKL)after those steps and check if LANG2 and LANG3 shortcuts work.

* additional set up required. SeeAdvanced Installation.

You can make HyperIJKL work on Login Screen.

1. Go to:

   Karabiner-Elements → Misc

2. PressCopy the current configuration to the system default configuration. You will be prompted for admin password.

You can edit HyperIJKL's shortcuts with the following steps:

1. Open HyperIJKL/mac/hyperijkl.yml;

2. Edit shortcuts (seeKarabiner docs for reference);

3. Run inmac directory:

   make all

4. Go to:

   Karabiner-Elements → Complex Modifications

5. Delete all the old HyperIJKL's modifications;

6. Press:

   Add rule → Enable all

   on newly edited modifications.

Advanced Installation of HyperIJKL allows you to use several additional shortcuts,but requires more complex configuration that involves modifying key bindings in macOS and in IntelliJ IDEA.

1. Install Karabiner-Elements:

   brew install --cask karabiner-elements

2. Clone HyperIJKL:

   git clone https://github.com/RomanYuldashev/HyperIJKL.git

3. Run installation script in HyperIJKL'smac directory:

   make all

   This step automatically sets upDefaultKeyBindings.dict in macOS. SeeSetting Up DefaultKeyBindings.dict for details.

4. Enable HyperIJKL in Karabiner-Elements:

   Karabiner-Elements → Complex Modifications → Add rule → Enable all

5. Set up additional IDEA shortcuts (seeSetting Up Additional IDEA Shortcuts).

HyperIJKL requires modification of DefaultKeyBindings.dict for advanced shortcuts to work.If you have no custom key bindings in your macOS — you are good!Otherwise, you will have to manually merge HyperIJKL's key bindings into existing ones.In this case HyperIJKL's advanced installation script will notify you about key bindings conflict.

HyperIJKL utilizes a couple of text navigation actions that are supported by macOS but are rarely recognized by apps.To enable these actions in IntelliJ IDEA you will have to add shortcuts for them either through in-app Settingsor by directly modifying configuration files.

1. Perform previous steps of HyperIJKL's Advanced Installation;

2. Go to IDEA configuration directory (directory name may vary between app versions):

   cd~/Library/Application\Support/JetBrains/[IntelliJIdea]

3. If directory[IdeaConfigBasePath]/keymaps doesn't exist, copy it from HyperIJKL'smac/idea directory and paste here;

   Else go tokeymaps, openmacOS.xml with a text editor and paste all the<action> blocks from HyperIJKL'smac/idea/keymaps/macOS.xml into it;

4. Go to[IdeaConfigBasePath]/options/mac and openkeymap.xml. Make sure thatactive_keymap name is aligned with an .xml fromkeymaps directory:

   <active_keymap name="macOS" />

5. Restart IDEA;

6. Check if these shortcuts work in IDEA:

   * ⌥ i → move to beginning of paragraph

   * ⌥ ⌘ i → select previous paragraph

   * ⌥ k → move to end of paragraph

   * ⌥ ⌘ k → select next paragraph

1. Perform previous steps of HyperIJKL'sAdvanced Installation;

2. Open IntelliJ IDEA;

3. Go to:

   Settings → Keymap → Find

4. Add these shortcuts:

   Move Caret Backward a Paragraph →* ⌥ i

   Move Caret Backward a Paragraph with Selection →* ⌥ ⌘ i

   Move Caret Forward a Paragraph →* ⌥ k

   Move Caret Forward a Paragraph with Selection →* ⌥ ⌘ k

Author: Roman Yuldashev (RomanYuldashev@proton.me)

License:Apache 2.0 License

ᗜˬᗜ