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. There are two icons inside the file bar:

“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.

Chord List

Directly below the File Bar is the Chord List Panel. Every chord starts here.


Click the + to Add a new Chord.

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 around the phrase —EMPTY CHORD— to highlight that this is your new chord placeholder. Click on the Edit Button in the new chord row to begin editing. You will now notice that focus has shifted to the right panel - the Keystroke Editor.

Moving Chords

You can change the index of the chord (its position in the twiddler.cfg table) by simply clicking and dragging it to its desired location in the table.

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.

Keystroke Editor


There are two parts of the Keystroke editor, the chord assignment, shown by a stylized image of the Twiddler, and a 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 only 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 Key Strokes area to enter in your desired character string.

To enter special non-typable keys, use the pull down menu to access a list of all the special keys available. Select the special key you would like to use than click Insert. You will notice that some marked up text is now in the text box. Some special keys have both a beginning and and ending tag. Place the key(s) you would like to modify inside the tag.

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.

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.

Mouse Click

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

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.

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


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”.

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.

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.

Last modified: 2015/06/03 10:49

Page Tools