Keyboard Hotkey Macros

Long video on using VIA to configure my Keychron keyboard for OpenBB

This document will explain how you can set hotkeys macros on your customizable keyboard which allow you to perform investment research in a few seconds.

Supported Configurators

VIA

This document will explain how you can set hotkeys on your customizable keyboard using VIA.

Here is a list of VIA's supported keyboards: https://www.caniusevia.com/docs/supported_keyboards

Note: We were in the market looking for a keyboard that could be highliy customizable for the needs of OpenBB power users. This is when we stumbled upon Keychron and the VIA configurator which allows users to intuitively remap any key on the keyboard, and create numerous macro commands, shortcuts, or key combinations. Here's a post from Keychron on VIA: Why VIA is one of the most essential features for a custom keyboard?

For the purpose of this example, the command pipeline we are creating has the following sequence of commands: dps/psi/../fa/pt/income/..

1. Try VIA here. The following screen should popup

2. Select the Layer you are interested in altering. As we're not looking forward to remap any of the existing main keys, we need to go to layer 2, 3 or 4. In my case, with a Keychron Q2, I know that Layer 4 can be accessed by pressing on "Fn2". Thus, I select that layer.

3. Most keys should have a triangle upside down which simbolizes that they don't have any functionality. You want to select one of those keys to contain your hotkey routine. After that selection you want to remap the key functionality, hence in the KEYMAP settings below you click on MACROS tab and select "MO". Now the screen should look like this:

4. Now we want to change what "MO" does and for that we select the MACROS settings below. Then we can select "M0" and insert dps/psi/../fa/pt/income/..{KC_ENT}. The screen should look like this:

Note that the {KC_ENT} will ensure that the command is run on the terminal.

5. Save. To ensure that everything is correct you can go into the KEYMAP settings and click on the hotkey that you just created to see if it contains the sequence of commands, the following sequence should appear:

6. Finally, we are ready to test it on the OpenBB Terminal. After going into stocks and doing load AAPL, I pressed "Fn2+Z" which lead to: