Twiddler

User Tools

Site Tools

Trace:
tuner_edit

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
tuner_edit [2024/05/22 18:07] – tonytuner_edit [2025/02/26 16:47] (current) – [The Keystroke Editor] tony
Line 12: Line 12:
   - Download the Config to your Twiddler   - Download the Config to your Twiddler
  
-Let's get started and open up the Twiddler Tuner website: https://tuner.mytwiddler.com/tuner/login+Let's get started and open up the [[https://tuner.mytwiddler.com/tuner/login|Twiddler Tuner]]
  
 ===== The Chord Entry Screen ===== ===== The Chord Entry Screen =====
Line 27: Line 27:
  
 ====  The Settings Bar ==== ====  The Settings Bar ====
-{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_Settings_Bar.png}}+{{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 Settings Bar allows you to change settings for the configuration file and editor.
  
 ===  The Download Button === ===  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.+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}} {{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:** 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. **NOTE:** Your browser may display a warning when downloading a .CFG file to your host.
Line 42: Line 42:
 {{ https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_CFG_Popup_Warning.png }} {{ 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 the unverified file to save the config file to your local storage.+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.
  
  
Line 51: Line 53:
 Clicking on the Settings Button opens a slide out window that gives you access to some of the "deeper" settings of the Twiddler. Clicking on the Settings Button opens a slide out window that gives you access to some of the "deeper" settings of the Twiddler.
  
-{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_Settings_Slideout.png}}+^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). **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”. 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”.
Line 59: Line 63:
 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 **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, ALT, CTRL, and SHIFT** to if you always want that keyboard modifier to be sent with every chord you press.  An example is Sticky SHIFT. This acts as CAPSLock.  Every chord is modified with the shift enabled. Learn more here:[[stickykeys|Sticky Keys]]+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. **Mouse Sensitivity** slider allows you to modify how sensitive you want the mouse input to be.
Line 67: Line 81:
 === The Notation Button === === The Notation Button ===
  
-{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_Notation_Button.png}}+{{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. 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.
Line 77: Line 91:
 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. 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 Keystroke Lookup Button ===+=== The Syntax Button ===
  
-{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_KeystrokeLookup_Button.png}}+{{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>//  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 Selectable Button === 
- 
-{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_Selectable_Button.png}} 
- 
-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. 
- 
 ====  The Action Bar ==== ====  The Action Bar ====
  
-{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_Action_Bar.png}}+{{https://tgimages.s3.amazonaws.com/twiddler/wiki/T4_Tuner_ActionBar.jpg}}
  
-This is where you add new chords and Save the config.+This is where you add new chords, save the config, and multi-select.
  
 === The Add New Chord Button === === The Add New Chord Button ===
Line 106: Line 113:
  
 Click this button to save your config file to the Twiddler Cloud storage. 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.
  
  
Line 131: Line 144:
 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. 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 == +==== The Keystroke Editor ==== 
-{{https://tgimages.s3.amazonaws.com/twiddler/wiki/Tuner_KeyStrokeEditor_Slideout.png}}+{{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 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.  +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 Keystrokes area to enter in your desired character chord.  Keep things simple for now and select Keyboard.+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/Tuner_Keystroke_Keyboard_MenuSelect.png}}+{{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. 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/Tuner_KeyStrokeEditor_ChordEntry.png}}+{{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. You will see the new chord appear in the top of the Chord table.
Line 149: Line 162:
 Click [[Tuner_AdvancedChording|Advanced Tuner Chording concepts]] for more advanced chord building concepts. 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.
tuner_edit.1716401267.txt.gz · Last modified: 2024/05/22 18:07 by tony

Page Tools