/bindED

This VoiceAttack plugin reads keybindings in Elite:Dangerous and stores them as VoiceAttack variables.

Primary LanguageC#GNU General Public License v3.0GPL-3.0

bindED

This VoiceAttack plugin reads keybindings in Elite:Dangerous and stores them as VoiceAttack variables. It has originally been written by Gary (the developer of VoiceAttack) and published on the VoiceAttack forums.

You can find the original README here.

I have taken the original source code and added automatic detection of the correct bindings file and support for non-US keyboard layouts (see below for details).

Installing

Grab bindEDplugin.zip from the release page and extract it into your VoiceAttack’s Apps directory.

Migrating from the Old Plugin

If you use this as a drop-in replacement for the initial version all commands invoking the plugin will throw an error message. Gary has asked me to change the plugin’s GUID, and the plugin with the old one will no longer be found.

That is irrelevant in basically all cases and can safely be ignored. Binds will be read automatically when VoiceAttack starts, and when they change.

Usage

You don’t have to do anything! When VoiceAttack loads, bindED will automatically detect your bindings. It will also keep a watchful eye on Elite’s bindings folder and reload them when there is a change!

If something goes awry, you can still manually call the loadbinds plugin context to force a refresh.

If you are not using a US QWERTY keyboard layout, see below.

Support for non-US Keyboard Layouts

Shipped layouts:

  • en-US
  • en-GB
  • de-neo2

If you are using any non-US layout you might have noticed that some binds don’t work. Elite internally uses keycode values (a number assigned to each key on the keyboard) for its bindings but for some reason both displays and saves them as keysyms (the label on the key), according to the UK QWERTY keyboard layout. That means VoiceAttack can’t just send the keysym it reads from a binding, it has to translate it into the corresponding keycode.

The original plugin contained a EDMap.txt file that contains information on that conversion for the US keyboard layout. If you are using any other layout that information will be incorrect for any symbols that are on a different key than they are on the US layout.

I have added the option to use maps for other keyboard layouts. In order to do so you will have to set a text variable in VoiceAttack called bindED.layout# to the layout you want to use. BindED will be notified of the variable changing and reload your bindings with the appropriate key map. If the variable is not set it will defaut to “en-us”, leaving the original behaviour intact.

I have included a map file for Neo2 (EDMap-de-neo2.txt) which is the layout that I am using personally. If you are on a different layout, you will have to create a corresponding map file yourself or prod me to add it. E.g. for the french AZERTY it would be EDMap-fr-fr.text and set bindED.layout# to “fr-fr”. For US Dvorak, EDmap-en-us-dvorak and “en-us-dvorak”. You can see where this is going.

For more information on creating new supported keyboard layouts see the Wiki.

Troubleshooting

If you run into any kinds of trouble with missing bindings the first step should be to import and load the included bindED-reports profile. It will generate both a list of bind names used by Elite and a report of binds that do not have a keyboard shortcut assigned, and put them on your Desktop.

Need help beyond that? Please file an issue or hop into Discord.