User Tools

Site Tools


Edit Your Config

Editing your Twiddler Config is a very simple procedure:

  1. Decide on what you want to type when you press a chord (from 1-1000 characters long)
  2. Click Add a new chord button
  3. Click the edit button beside the new chord
  4. Select a chord to press to generate the text
  5. Type the text into the Key Stroke Text Box
  6. Apply the Chord
  7. Save the Config
  8. Download the Config to your Twiddler

The Chord Entry Screen

There is a lot of information on this screen so, at first, it can look a bit intimidating. Once you know what everything means you will see how easy it is to create, edit and delete chords. Let's break this page down into its component sections.

The File Bar

Located at the top of the screen, the File Bar indicates which Config file you are currently editing - shown on the left hand side. Beside the file name is the version of the Config file you are editing. Older firmware versions use a different config format. On the right hand side, there are two icons:

“Save” saves your current Config in the Twiddler cloud.

“Download” downloads the current Config from the Twiddler cloud, depending on how your Internet Browser is configured, to your PC or directly to your Twiddler's onboard storage.

Note: twiddler.cfg must be copied to the onboard storage device on the Twiddler3. You do not need to cycle power to use the new .cfg file, it will be used on the next chord press.

Settings Editor

The Settings Editor allows you to configure general usage parameters for your Twiddler. Each of these settings are specific for the twiddler.cfg file. Enabling Sticky Keys, for example, does not enable Sticky Keys all the time on the Twiddler. Sticky Keys will only be enabled when this particular twiddler.cfg file is used.

Click on the Settings Bar to unroll the menu.

Mouse Sensitivity

Use this setting to slow down or speed up mouse movement. 1 is the fastest, 255 is the slowest and 128 is the default.

Idle Sleep Time

After the set period of time, the Twiddler will power down the Bluetooth Radio, disconnect from the host device, and go into a very low powered Sleep mode. Valid Settings are from 2 minutes to 1000 minutes. Default is 5 minutes. This should be the way you power down the Twiddler3 in normal use conditions. Powering Down with the switch should only be used in transportation and shipping situations.

Note: estimated battery life will decrease if the value is set greater than 5 minutes and increase if the value is set to less than 5 minutes.


Toggle this setting to turn on or turn off the Bluetooth Radio. Toggling this setting to “Disabled” will completely power down the Bluetooth Radio and stop it from emitting any RF. Default mode is “Enabled”.

Sticky Num and Sticky Shift

Enable these to make Num act as Num Lock and Shft act as Caps Lock with a single key press. More information here: Sticky Keys

Direct Key Mode

Enable to make keys respond like a standard keyboard. Key up and Key down commands are sent to the host. This limits the number of active keys to 15 (12 finger keys + 3 mouse buttons). This feature is normally enabled to use the Twiddler as a keyboard replacement for software that has shortcuts that rely on Press and Hold keystrokes.

Joystick Push

Pressing down, or clicking, the Mouse Stick can send either a Left or Right click. Use this setting to send the appropriate click.

Mouse Buttons

Each of the 3 mouse buttons can be configured to send either their respective mouse clicks or keystrokes to the host.

Chord Editor

The Keystroke Editor is where you define all the different chords you would like to use. Every chord starts here.

Look Up Button

The Look Up Button displays a syntax list for expressing non-visible key codes and modifiers in the Keystroke Editor area.

Finger Editor View Button (Finger Editor: xxxx)

This button toggles the display orientation of the finger keys when creating a chord. Front shows the layout with the keys pointing towards you as if looking at them.

While Reverse shows the layout with the keys pointing away from you as if looking through the Twiddler.

Chord Notation Button (Chord: xxxx)

This button toggles how the chord notation is displayed.

Notation shows the standard Twiddler chord notation

Buttons shows the buttons used on the Twiddler.

Clear Filters

This button clears all the filters set in the top row.

Add Button

Click the Add Button to create a new chord. A new blank line will be created in the first row of the table.

You will notice that a new row is inserted into the table below. It is always designated chord O OOOO as there are no keys assigned to that chord. Click here for a detailed description on Chord Notation. There is also a red box to highlight that this is your new chord placeholder. Click on the Edit Button in the new chord row to begin editing. A Popup window will appear - the Keystroke Editor.

Keystroke Editor

There are two parts of the Keystroke editor, on the Left, the chord assignment and, on the right, the keystroke text box. To create a Chord, click on the buttons you would like to assign to this chord. The keys will switch from Black to White to indicate that they are active. You can have a maximum of one key active per row and four per column selected. The Num, Alt, Ctrl and Shft buttons, at the top of the Twiddler, are Modifiers and can be added to the Chord and are not part of the maximum key limitation.

Once you have settled on a Chord, use the text box in the Keystrokes area to enter in your desired character string.

To enter special non-typable keys, click the Lookup Button to access a list of all the special keys available.

eg: CTRL-C would be written as: <Right Ctrl>c</Right Ctrl>

Other special keys only require a beginning tag as they are only on character.

eg: <F1> issues the F1 key. No ending tag </> is needed.

Note: You do not have to specify a unique chord for capital letters. Holding the SHFT key down while pressing the appropriate single character chord will produce a capital of that character. R000 will produce “a”. S R000 will produce “A”. S R000 does not have to be explicitly entered into the Chord List.

Once you have completed composing your chord, click on the Apply button to add it to the Chord List on the right. You will see the new chord appear in the table in orange.

If everything looks good and you are done editing, click the Save button in the File Bar to Save your changes to the Twiddler Cloud. Don't forget to download your updated file to the Twiddler by clicking on the download button in the File Bar.

Listing Chords

You can download a CSV or PDF version of the complete chord list by clicking the appropriate icon beside the Chord List header.

Last modified: 2018/02/28 10:15

Page Tools