====== Edit Your Config ======

Editing your Twiddler Config is a very simple procedure:

  - Decide on what you want to type when you press a chord 
  - Click Add a new chord button
  - Click the edit button beside the new chord
  - Select a chord to press to generate the text
  - Type the text into the Key Stroke Text Box
  - Apply the Chord
  - Save the Config
  - Download the Config to your Twiddler

Let's get started and open up the [[https://tuner.mytwiddler.com/tuner/login|Twiddler Tuner]]

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

{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_Bars.png}}
====  The File Bar ====

{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_File_Bar.png}}

Located at the top of the screen, the File Bar indicates which Config file you are currently editing - shown in the black text box (twiddler_0).  To the left of the file name is the version of the Config file you are editing (v6).  Older firmware versions use a different [[twiddler_firmware | config format]]. 
The Left Pointing Arrow brings you back to the main page.

====  The Settings Bar ====
{{https://tgimages.s3.amazonaws.com/twiddler/wiki/T4_Tuner_SettingsBar.jpg}}

The Settings Bar allows you to change settings for the configuration file and editor.

===  The Download Button ===
The First item is the download button. This downloads the current config to your host device.  By clicking on the pull down, a sub menu appears allowing you to specify in which config slot you would like this to be saved. The config file will be downloaded with the appropriate name.

{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_Download_Slot.png}}

**NOTE:** if **1.cfg** already exists in the download directory, some operating systems will automatically re-name the file **1 (2).cfg**. The Twiddler requires that the naming convention of **1.cfg**, **2.cfg** and **3.cfg** be maintained.  Copying **1 (2).cfg** or some variant will cause the Twiddler to ignore these files.

**NOTE:** Your browser may display a warning when downloading a .CFG file to your host.

{{ https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_CFG_Popup_Warning.png }}

This is an expected response due to security settings in most browsers. Click "Download unverified file" to save the config file to your local storage.

**IMPORTANT:** Once you copy the config file to the Twiddler - you must disconnect the USB cable from the Twiddler to commit the file to the Twiddler's storage.


=== The Settings Button ===

{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_Settings_Button.png}}

Clicking on the Settings Button opens a slide out window that gives you access to some of the "deeper" settings of the Twiddler.

^v1-v5 Firmware^v6 Firmware^
|{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_V5_Settings_Slideout.png}}|{{https://tgimages.s3.amazonaws.com/twiddler/wiki/T4_Tuner_Settings.jpg}}|

**Nav Mouse Click** allows you to specify the action of clicking the Touchpad (Twiddler 4) or Joystick (Twiddler 3).
**Mouse Left Click** lets you choose between F0R or F0L for the mouse left click.

Toggle the **Bluetooth** checkbox 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”.

Enable **Direct Key Mode** 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. No chording is possible in this mode.

Enable **Sticky NUM, SHIFT, ALT, and CTRL ** to if you always want that keyboard modifier to be sent with every chord you press.  An example is Sticky SHIFT. This acts as CAPS Lock.  Every chord is modified with the shift enabled. 
|Firmware Version|Supported Sticky Keys|
|v1-v5|NUM, SHIFT|
|v6|NUM, SHIFT, ALT, CTRL|

Learn more here:[[stickykeys|Sticky Keys]] 

Available in v1-5 Firmware only, each of the 3 **mouse buttons** can be configured to send either their respective mouse clicks or keystrokes to the host.  In v6 Firmware, mouse button actions can be assigned to any key through the Mouse Action menu in the keystroke editor. See [[tuner_advancedchording|Advanced Chording Concepts]] for more information.

**Key Repeat Delay** let's you adjust the rate of the pause between holding a button down and when it starts repeating. 
//Note: 1,000msec = 1 second//

**Mouse Sensitivity** slider allows you to modify how sensitive you want the mouse input to be.

**Idle Time until Sleep** sets the time the Twiddler will wait until it goes into sleep mode.  Default is 1 minute.  The longer the Idle Time, the larger the impact on battery life.

=== The Notation Button ===

{{https://tgimages.s3.amazonaws.com/twiddler/wiki/T4_Tuner_Notation.jpg}}

Classic Twiddler Notation has been around since the advent of the Twiddler.  Twiddler 4 eliminated all of the chording limits imposed by previous versions of the Twiddler.  The T4 notation was devised to clearly represent chording without limits.  Use this button to toggle the display of T4 and Classic notation in the chord table.

=== The Mirror Button ===

{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_Mirror_Button.png}}

Use this button to globally swap all Left and Right keypresses in the config.  Some people like this if they are moving the Twiddler to their other hand.

=== The Syntax Button ===

{{https://tgimages.s3.amazonaws.com/twiddler/wiki/T4_Tuner_Syntax.jpg}}

Use this button to show the syntax for embedding keystrokes that you cannot get by pressing a key on a regular keyboard.  The Shift key is a good example.  Pressing it on your keyboard sets a modifier flag when another key is pressed so it is not picked up by itself.  If you want to use the Left Shift key in a chord just type in // <Left Shift> // _keys you want shifted_ //</Left Shift>// 
====  The Action Bar ====

{{https://tgimages.s3.amazonaws.com/twiddler/wiki/T4_Tuner_ActionBar.jpg}}

This is where you add new chords, save the config, and multi-select.

=== The Add New Chord Button ===

{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_AddNewChord_Button.png}}

Click this button to add a new chord in the chord table.

=== The Save Button ===

{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_Save_Button.png}}

Click this button to save your config file to the Twiddler Cloud storage.

=== The Select Button ===

{{https://tgimages.s3.amazonaws.com/twiddler/wiki/T4_Tuner_Select.jpg}}

This button toggles items in the chord table from single select to multi-select.  Its mostly used for mass deletion of chords in the table.


==== Chord Editor ====

{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_ChordEditor_Table.png}}

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

== The Filter Row ==
{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_Filter_Row.png}}

Use the fields in this row to quickly filter and find chords.    
  * Looking to find chords that utilize the T2 button?  Enter 2 in the Thumbs field.  
  * Looking to find a chord that use Fingers 1 and 2? Enter 1* 2* in the Fingers field. 
  * Looking to find the chords that send an Escape?  Enter *<Escape>*.  
The fields support wildcard lookups.

== 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.
{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_AddButton_Action.png}}

You will notice that a new row is inserted into the table below.  It is always designated as Empty as there are no keys assigned to that chord.  There is also a red box to highlight that this is your new chord placeholder.  Click on the Edit Button {{https://tgimages.s3.amazonaws.com/twiddler/wiki/Pencil.png}} in the new chord row to begin editing.  A Slide Out window will appear - the Keystroke Editor.

==== The Keystroke Editor ====
{{https://tgimages.s3.amazonaws.com/twiddler/wiki/T4_Tuner_KeystrokeEditor.jpg}}

There are two parts of the Keystroke editor. On the top, the chord assignment and on the bottom, the keyboard 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.  

Once you have settled on a Chord, click the **+ Add** button in the Keyboard area to enter in your desired character chord.  Keep things simple for now and select Keyboard.

{{https://tgimages.s3.amazonaws.com/twiddler/wiki/T4_Tuner_AddButton.jpg}}

A new blank field will appear with a grey Keyboard tag beside it.  Type in your desired keystrokes for this chord. In the example, we have typed in an email address. Click Apply once complete.
{{https://tgimages.s3.amazonaws.com/twiddler/wiki/T4_Tuner_Keyboard.jpg}}

You will see the new chord appear in the top of the Chord table.

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.

Click [[Tuner_AdvancedChording|Advanced Tuner Chording concepts]] for more advanced chord building concepts.

=== Using Capitals ===

Twiddler Tuner stores all keystrokes as HID codes in the config file.  If you use a capital letter in your chord, "C" for example, Tuner will store it as HID Code 0x06 and sets the L-Shift modifier bit.  Tuner automatically removes the 
<LSHIFT></LSHIFT> explicit notation and replaces it with a simple capital "C" for presentation purposes.

This is important to keep in mind as some programs interpret CTRL-c and CTRL-LSHIFT-c as completely different commands.