helicopter

Helicopter is a keymap system with composability and ergonomics in mind. It provides a scalable way to define keybindgs, making them easy to remember and easy to use.

welldan97

91

2

0.6.1

MIT

GitHub

Helicopter

Keymap

Modifiers Method
ctrl main
alt main²
ctrl-shift select
alt-shift select²
ctrl-alt delete
ctrl-alt-shift delete²

Helicopter is a keymap system with composability and ergonomics in mind. It provides a scalable way to define keybindgs, making them easy to remember and easy to use.

Core Principles

To make Helicopter system effective and powerful it is based on top of a few core principles.

1. Composability

One of the main goals of the project is to give a composable way to define keystrokes in a way that it would be mentally easy to learn them. Each keystroke consists of 2 main elements - method and argument. The left hand is responsible for methods and the right hand is responsible for its arguments.

You can see a few examples of resulting keybindings:

Statement Keystroke Command
main + = move right ctrl-; core:move-right
select + = select right ctrl-shift-; core:select-right
delete + = delete right ctrl-alt-; core:delete
file + = next tab ctrl-v ctrl-; pane:show-next-item
srch + = find next ctrl-e ctrl-; find-and-replace:find-next
srch + select + = select next found ctrl-e ctrl-shift-; find-and-replace:select-next
bkmk + = next bookmark ctrl-w ctrl-; bookmarks:jump-to-next-bookmark
pane + = focus right pane ctrl-c ctrl-; window:focus-pane-on-right
pane + →² = split pane right ctrl-c ; pane:split-right

The defined keymap works via regular key events, there is no need for entering mode, like in vim. Although, mode as an addition might be added in a future.

You can see the whole keymap here.

2. Ergonomics & Semantics

All the keystrokes are defined with ergonomics in mind. The navigation keys lie literaly at your fingertips. And the more common the action you want make the easier it is to access.

Each key has a semantics behind it. So you don't have to memorize all the weird keybindings, you just have to the remember base keys and next time you use it you will feel that it make sense. Many times you are going to guess the keybindings without ever using them.

The whole list of user experience principles you can see here

3. Different keyboard layouts support

From the day one we have a support for different keyboard layouts. No matter which keyboard layout you use, the keys stay at the same place. Me myself using programmer dvorak, I see how it can be important to have support for different keyboards.

4. Customizability

All the keybindings should be customizable. If the defaults don't make sense for you, you would be able to change it. If you want to have the search button on another key — you should be able to do it. And of course nothing stops you to define your own keybindings in a usual way.

You can see how the keybindings structured here. And here is a resolving file for actions.

5. Scalability

Helicopter is not just a keymap, it is actually a system to define one. It gives you an ability to add new methods and arguments easily. There are still a lot of unbound keys left. So you can add support for your favorite packages without a problem.

Right now it can be used only on Atom. But it's in the plans to support other platform too.

Usage

There are two main concepts in Helicopter system: methods and arguments. The combination of two results in a keybinding. Method is responsible for a context in which you want to use the action and the action itself. I.e. file, pane could be a context and delete could be an action. Argument can be used only once, and usually it defines the direction (LEFT) or (RIGHT), but it also can define a more abstract concept like SETUP or (EXPORT).

Some of the keys support alternatives, and they can be addressed either via modified version of keystroke, or via evoking method keybinding twice. I.e. core:save-as is a third variation of file + (EXPORT). And it can be accessed either via alt key, or it can be accessed via double press of ctrl-v and then choosing the version of the third version of keybinding(via k key).

Statement Keystroke Command
file + ⤴³ ctrl-v alt-y core:save-as
file + ⤴³ ctrl-v ctrl-v ctrl-y ctrl-k core:save-as

Keybinding version keys go in order of homerow: hjkl:'

You can always consult to the list of all keybindings: here.

Plans for the project

Helicopter is still hugely work in progress. And many of the things could be implemented with the with your contribution.

  1. There should be defined more actions and functions which atom is missing
  2. Make complete support for default atom keybindings
  3. See if other units would make sense - word borders etc. What else can be inherited from vim&co.
  4. Make it customizable for real.
  5. Much more...