User Tools

Site Tools


chordnotation

T4 Chord Notation

Classic Twiddler chords were limited to any number of thumb buttons (Shift, Alt, Ctrl, Num modifier keys) plus one button from each of the 4 rows of finger buttons. Starting with Twiddler 4, Firmware 2.00, chords can be made up of multiple button presses in the same row on the Finger pad, utilizing the mini-buttons (3 buttons above the finger pad) in a chord, and the thumb buttons can be remapped to anything. So, any button can be pressed at any time to make a chord - there are no limits. The T4 Chord Notation looks to clearly document a chord that reflects these new rules.

The T4 Notation represents pressed buttons only, no blanks are denoted. This deprecates the use of “0” to indicate absence of a keypress.

Button Areas

There are two button areas: THUMB BUTTONS and FINGER BUTTONS

Thumb Buttons

Image of Twiddler Thumb Area with buttons numbered 
from Left to Right, 1, 2, 3 and 4

  • Denoted as: T<1234>
  • Physical button numbers increase from left to right
  • “T” followed by any combination of thumb button indexes 1-4
Notation
T4 Notation Action
T1Thumb button 1
T14Thumb buttons 1 and 4
T23Thumb buttons 2 and 3

Finger Buttons

  • Denoted as: F <row number{0-4}><LMR>
  • “F” followed by any combination of Row and Column information
  • Row information is represented by the row number followed by any combination of L,M,R buttons (left, middle, right column buttons)
  • Mini buttons are row 0
  • Main four finger rows are 1-4
  • Columns are still designated Right, Middle and Left

Image of Twiddler with keys facing the viewer indicating the mouse row as 0, first row of keys as 1, second row as 2, third row as 3 and fourth row as 4 Image of Twiddler with keys facing the viewer indicating left hand column marked as "L", middle column marked as "M" and, right hand column marked as "R"

Notation
T4 Notation Action Classic Action
F2RFinger row 2 right buttonOROO
F3MFinger row 3 middle buttonOOMO
F2R 3MFinger row 2 right button, row 3 middle buttonORMO
F1R 2R 3R 4RFinger row 1,2,3 and 4 right buttonRRRR
F1LRFinger row 1, both L and R buttons[LR]OOO
F0MMiddle mini button

Classic Chord Notation

This user’s guide and Twiddler Tuner uses a special notation to show you how to type each character and command with a factory-preset chord. As you face Twiddler’s twelve-key layout, you will find four keys (labeled SP, DEL, BS, and ENT) arranged in a column on the left. This column is designated “L”. The four keys in the middle column (E, F, G, H) are referred to as “M”. And the four keys on the right (A, B, C, D) are designated “R”.

Image of Twiddler with keys facing the viewer indicating left hand column marked as "L", middle column marked as "M" and, right hand column marked as "R"

Each unique chord is defined by a four-symbol sequence indicating which key is pressed in each of the four rows ordered from top to bottom. If no key needs to be pressed in a particular row, a zero (0) in the sequence will indicate that. Remember that the first symbol in the chord notation refers to a key in the top row pressed by your index finger, the second symbol to a key in the second row assigned to your middle finger, the third symbol to a key in the third row pressed by your ring finger, and the fourth symbol to a key in the bottom row reached by your little finger.

For example, to type a lowercase letter “a”, your index finger must press and release the key at the right end of the top row, while no other keys need to be pressed in the next three rows. So, the notation for “a” is: R000

Image of Twiddler with keys facing viewer with the letter "A" marked in green at the top right of the key matrix. Position R000 in Twiddler Notation.

Finger Keys

FINGER KEYS are indicated by a group of four symbols: 0, L, M, and R.

These symbols represent key presses in ROWS: 1, 2, 3, and 4 (top to bottom). 0 means no button pressed in that row; L means the Left button is pressed; M means the Middle button is pressed; and, R means the Right button is pressed.

Example: L00R means:

Left Button in ROW 1
0 buttons in ROW 2
0 Buttons in ROW 3
Right button in ROW 4

This example types the letter “k”.

Image of the Twiddler with the keys facing the viewer. The "Space" key in the top left is shaded red and the "D" key in the bottom right is shaded green.  This is how the chord  L00R would be pressed.

Similarly, you can type the lowercase letter “k” by pressing and releasing (with your index finger) the left key in the top row, no keys in the next two rows, and (with your little finger) the right key in the bottom row. This chord is designated by the notation L00R. L00R is the notation for typing the letter “k”.

Thumb Keys

THUMB KEYS are indicated by a group of four symbols: N,A,C,S Image of the Twiddler, keys facing away from viewer and looking top down at the joystick and four modifier buttons Thumbs keys are not pressed individually but are modifiers to other keypresses and make up a chord.

In order, from left to right the buttons are:

NotationKey
NNum
AAlt
CControl
SShift

Expanding on the Finger Key example above, adding a Shift (S) modifier to L00R would issue a Shifted “k” and result in a capital “K” being displayed onscreen. Explicit notation for this is S L00R.

You can use multiple thumb keys at the same time. Some combinations are harder to press than others. We use this to make special reserved chords harder to press as they may cause undesirable results during normal operation. For example: Holding Num and Shift (N+S 0000) during power on replaces the current firmware on the Twiddler with the factory boot firmware.

Experimental Chord Notation

If Experimental Features is turned on and Multiple Buttons per row is in enabled, you will be able press more than one key per row. Keys in the same row will be bracketed.

Example: (RML)00(ML) means:

Right, Middle, AND Left Button in ROW 1
0 buttons in ROW 2
0 buttons in ROW 3
Middle AND Left buttons in ROW 4

More info here: multiple_buttons_per_row

Last modified: 2024/04/24 12:59

Page Tools