Maps

The TextBlade comes with a number of pre-configured maps to support major language variants; however, one of its great strengths is the ability to customize maps to suit particular preferences via the TextBlade app (as long as you have the MultiMap capability). At the moment the TextBlade app is only available on Apple iOS devices (iPhone, iPad, iPod), but there are plans for it to be ported to other OS's in the future.

WayTools provide a library of pre-configured maps which can be used either as-is, or as the starting point for any customization you want to make. The library is held on the WayTools servers so they can easily add new maps or alter existing ones.

The current list of standard Library maps (as of October 2018) are called:

qwerty.jpg QWERTY

uk.jpg UK

qwertz.jpg QWERTZ

azerty.jpg AZERTY

spanish.jpg Spanish

portuguese.jpg Portuguese

italian.jpg Italian

swedish.jpg Swedish

finnish.jpg Finnish

danish.jpg Danish

norwegian.jpg Norwegian

dvorak.jpg Dvorak

colemak.jpg Colemak

emoji.jpg Emoji

qwerty_num.jpg QWERTY Num

emacs_both.jpg Emacs Both

emacs_pinky.jpg Emacs Pinky

Click on the name of one of the above if you want to see the details of that particular map.

It is presumed that WayTools are likely to offer custom key tops corresponding to most (if not all) of the standard default maps). On that basis points to note are:

  • The 'white' letters on the keytops correspond to the standard Alpha layer (and where relevant the Alpha shift layer).
  • The 'green' symbols on the keytops correspond to the standard Green layer (and where relevant the Green shift layer).
  • The left blade has engraved indications of the chord to be used for the Media, Select and Edit layers. The right blade has engraved meanings for the standard Edit layer (and thus Select layer where relevant).
  • However since none of these keytops have (yet) been shipped to TREG testers (all current TREG units ship with QWERTY keytops) the above points are only supposition.
The TextBlade app provides the ability to print out a PDF version of the images associated with any of the above list of maps. This can be useful as a ‘cheat sheet’ as you get to learn the less frequently used parts of any map. You can do the same with any customised maps that you produce.

One point to note that this will not include Jump Slot Settings, or any Macros you have set up (other than an indication of letters have associated macros) so you need to keep these documented separately if you want a ‘cheat sheet’ for those.

When producing customized maps the normal alphanumeric characters can be assigned simply by tapping on the location you wish to assign and then typing the character on an existing keyboard. There are also a lot of special characters that are available for assigning to key positions. In addition, common keyboard shortcuts are assigned so that they can always be keyed the same way regardless of the target operating system. The symbols available are organized in a scrollable window with blocks of related symbols. The ones currently available are:

The following tables gives more information what each of these selections does. Note that Modifiers can be used in conjunction with any non-modifier sequence. The table is in the order that the characters are displayed on the selection strip.

Symbol Name Description/Comments Operating System Specific
MacOS iOS Windows Linux Android ChromeOS
Shift Provides shift to next character typed. Operates in 'Sticky mode so it does not have to be held down while next character is typed
Command Modifier widely used on MacOS and iOS. Tends to be the equivalent in many cases of the Ctrl key used on Windows. On a jump slot set for Windows/Linux this key is treated as the the Win key. Win Win
Alt/OptionModifier widely used on all OS. Often combined with other modifiers Alt Alt Alt
Control Modifier widely used on Windows and Linux. On iOS/MacOS the CMD key tends to be used instead Ctrl Ctrl Ctrl Ctrl Ctrl
Tab Tab Tab Tab Tab Tab
Home Screen Home
Button
CtrlH
Enter
BackSpace Deletes character before cursor
Del Deletes next character Del Del Del Del Del
DelPrev Deletes previous word AltBackSpaceAltBackSpaceCtrlBackSpace CtrlBackSpace CtrlBackSpace
DelNext Deletes next word CtrlDel
DelStart Deletes to Start of Line Del
DelEnd Deletes to End-of-Line
Escape
Edit Keys
Symbol Name Description/Comments Operating System Specific
MacOS iOS Windows Linux Android ChromeOS
Cut Removes the selected text and puts it on the clipboard X X CtrlX CtrlX CtrlX CtrlX
Copy Copies the selected text to the clipboard C C CtrlC CtrlC CtrlC CtrlC
Paste Inserts the text from the clipboard V V CtrlV CtrlV CtrlV CtrlV
Select All Selects all available items A A CtrlA CtrlA CtrlA CtrlA
Undo Undoes the last edit Z Z CtrlZ CtrlZ CtrlZ CtrlZ
Redo Redoes the last edit ShiftZ ShiftZ CtrlShiftZ CtrlShiftZ CtrlShiftZ CtrlShiftZ
Symbol Name Description/Comments Operating System Specific
MacOS iOS Windows Linux Android ChromeOS
Left Moves cursor left
Right Moves cursor right
Up Moves cursor up
Down Moves cursor down
Previous Word AltAlt Ctrl
Next Word Alt Alt Ctrl
Beginning of line Home
End of line End
Page Up Page Up
Page Down Page Down
Previous paragraph Ctrl
Next paragraph Ctrl
Beginning of document CtrlHome
End of document CtrlEnd
Search Keys
Symbol Name Description/Comments Operating System Specific
MacOS iOS Windows Linux Android ChromeOS
Previous match Go to previous match in current document ShiftF15
Find match CtrlF
Next match Go to the next match in current document F3
App Keys
Symbol Name Description/Comments Operating System Specific
MacOS iOS Windows Linux Android ChromeOS
New tab ShiftCtrl T
Previous tab ShiftCtrlTab
Next tab CtrlT
Close tab Close current tab or window Ctrl W
Previous Window in Current app CtrlT
Next Window in Current app Esc
New Window Ctrl N
Previous app ShiftAlt
Next app AltT
Show Open apps
Show Current app
Find app Win
Quit app AltF4
Accents
Symbol Name Description/Comments Operating System Specific
MacOS iOS Windows Linux Android ChromeOS
Dieresis Dieresis applied to next character
Grave Grave accent for next character
Acute Acute accent for next character
Tilde Tilde applied to next character
Circumflex Circumflex for next character
Formulaic Keys
Symbol Name Description/Comments Operating System Specific
MacOS iOS Windows Linux Android ChromeOS
± PlusMinus
Δ Delta
π Pi
Square root
Σ Sum
f Function
Integral
Infinity
Approximation/Approximately equal
º Degree
Dot
Currency
Symbol Name Description/Comments Operating System Specific
MacOS iOS Windows Linux Android ChromeOS
$ Dollar
¢ Cent
£ Pound
Euro
¥ Yen
Basis Point
Legacy Keys
Symbol Name Description/Comments Operating System Specific
MacOS iOS Windows Linux Android ChromeOS
Print Print
Break Break
Numeric Lock Num Lock
Scroll Lock Scroll Lock
Home Home
End End
Insert Ins
Function Keys
Symbol Name Description/Comments Operating System Specific
MacOS iOS Windows Linux Android ChromeOS
F1
F2
F3
F4
F5
F6
F7
F8
F9
F10
F11
F12
F13
F14
F15
F16
F17
F18
F19
F20
F21
F22
F23
F24
Media keys
Symbol Name Description/Comments Operating System Specific
MacOS iOS Windows Linux Android ChromeOS
Volume up
Volume down
Mute
Play / pause
Rewind
Fast forward
Previous track
Next track
Eject
Capture Keys
Symbol Name Description/Comments Operating System Specific
MacOS iOS Windows Linux Android ChromeOS
Scroll Lock
Capture Screen Captures the whole screen
Capture window Captures the current active window or part of screen
TextBlade Control
Symbol Name Description/Comments Operating System Specific
MacOS iOS Windows Linux Android ChromeOS
Turn Off Puts TextBlade into deep sleep
Reboot Reboots the TextBlade
Battery Show TextBlade Battery level

Useful online sites for checking exactly what key codes are being sent for any particular map can be found at:

MacOS users may find Karabiner as a useful utility for customising and monitoring keycodes.

Windows users may find Keycode3 as a useful utility for monitoring keycodes.

Raspberry Pi users may find that you are mapping your TextBlade for the Raspberry Pi and you have Kodi on your Pi it makes a nice key logger. Just turn on the Kodi debug function and monitor the kodi log with:
tail -f /storage/.kodi/temp/kodi.log | grep OnKey

Many of the maps leave a lot of the keys unassigned, and it is possible to remap most of the pre-supplied character key positions. This section covers some ideas that users have come up with to suit their personal tastes

  • Use the unused positions on the Function layer for common modifier sequences that you use. For example the middle row could be used to map ALT-1 to ALT-0.