7
Programming the Fn Key:
The TKO supports two different types of Fn layer access: “Shift” and “Toggle”.
The default behavior of the Fn key is “Shift” (i.e., momentary).
Note: For proper functionality, it is necessary to
assign the desired Fn action token to the position token in both layers, otherwise you’ll get stuck in the Fn
layer
4.7 Programming Macros
To program a macro, encode the position token(s) corresponding to the desired trigger key(s) and the action
token in curly brackets, separated by “>“. Each layout can store up to 7,200 total macro characters spread
across up to 100 macros.
Trigger Keys:
Any non-modifier key can be assigned as a macro trigger in either layer. A co-trigger can be
added by adding a modifier key to the left of “>“.
Note: Windows keys are not recommended as co-triggers.
Shifted Actions:
To produce a shifted key action, it is necessary to encode a macro which includes the both
the down and up stroke of the shift key surrounding the basic key action. Downstrokes are indicated by
placing a “-” inside the bracket and upstrokes are indicated by placing “+”. See example 1 below.
Individual Playback Speed Prefix {s_}:
By default, all macros play at the selected “Global” playback speed.
To assign a custom speed for improved playback performance for a given macro you can use the “Individual
Playback Speed” prefix “{s_}”. Choose a number from 1-9 corresponding to the speed scale shown Section
4.6. The speed prefix should be placed to the right of the “>“ before the macro content. See example 2 below.
Multiplay Prefix {x_}:
By default, all macros playback continuously while the trigger key is held. To override
the repeat feature and restrict a macro to playback a specific number of times you can use the “Macro
Multiplay” prefix “{x_}”. Choose a number from 1-9 corresponding to the number of times you want the macro
to replay. The multiplay prefix should be placed to the right of the “>“ before the macro content. See example
3 below.
If a macro is not playing back properly, try assigning a Multiplay value of 1. The macro may actually be firing
multiple times before you are releasing the trigger key.
Timing Delays:
Delays can be inserted into a macro to improve playback performance or to produce a
mouse double-click. Delays are available in any interval between 1 and 999 millisecond ({d001} & {d999}),
including random delays ({dran}). Delay tokens can be combined to produce delays of various durations and
inserted at any point in a macro. See example 4 below.
Macro Examples:
1. Tab performs “Hello” with a capital H:
{tab}>{-lshft}{h}{+lshft}{e}{l}{l}{o}
2. Fn Layer Left Ctrl + q performs “qwert” at speed 9:
fn {lctrl}{lmous}>{s9}{q}{w}{e}{r}{t}
3. Esc + Left Shift performs “hi” three times:
{lshft}{esc}>{x3}{h}{i}
4.8 Tap and Hold Actions
With Tap and Hold, you can assign two unique actions to a single key based on the duration of the keypress.
Each Layout can support up to 10 Tap and Hold actions. Designate the position token, then the Tap action,
then the timing delay from 1 to 999 milliseconds using the special Tap and Hold token ({t&hxxx}), then the
Hold Action. Due to inherent timing delays, Tap-and-Hold is not recommended for use with alphanumeric
typing keys. Not all key actions support Tap-and-Hold.
Note: For most applications, we recommend a timing delay of 250ms.
Tap and Hold Example:
1. Caps performs Caps when tapped and Esc when held longer than 500ms: [caps]>[caps][t&h500][esc]
