| 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 keybindings, making them easy to remember and easy to use.
To make the Helicopter system effective and powerful it is based on top of a few core principles.
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.
All the keystrokes are defined with ergonomics in mind. The navigation keys lie literally at your fingertips. And the more common the action you want to 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 remember the 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
From day one, we have supported 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.
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 are structured here. And here is a resolving file for actions.
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 platforms too.
There are two main concepts in the 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 the list of all keybindings: here.
Helicopter is still hugely work in progress. And many of the things could be implemented with your contribution.
- There should be defined more actions and functions which atom is missing
- Make complete support for default atom keybindings
- See if other units would make sense - word borders etc. What else can be inherited from vim&co.
- Make it customizable for real.
- Much more...