Custom Layout Designer

The Truly Ergonomic Keyboard provides for fully programmable keys and layout customization, allowing for uncommon and unique key configurations.

All keys are fully programmable. You can change the logical position of any key, add as many logical keys as you want, add special functionality to any key, have unique key configurations, and have up to six different layouts at once. Custom keys and layouts are saved internally so you can connect your Truly Ergonomic Keyboard to any computer without the need to install any additional software or to reprogram each time.

This “Layout Designer” allows you to create your own custom Layout/Firmware file.

Yes, the Truly Ergonomic Keyboard is fully programmable beyond what is available via DIP switches.

Newest Browsers only

This “Layout Designer” only works on newest Browsers: Firefox and Chrome.

If your browser does not allow you to drag a key from the top‑layout into the TrulyErgonomic‑layout, or does not allow you to save the file into your computer: you can upgrade your browser, use a different browser, or use a different computer.

Application to upgrade the Layout/Firmware

The application to upgrade the Layout/Firmware file into your Truly Ergonomic Keyboard is compatible with Windows, OS X, and Linux.

Once upgraded, disregarding which Operating System you used to upgrade the firmware, you can use your Truly Ergonomic Keyboard in compatible computers running diverse Operating Systems including Windows, OS X, or Linux.

Default Layout

When you arrive at this “Layout Designer” page, the default layout shown below on the “TrulyErgonomic‑layout” is the default for the Model 229/227 (ANSI-ISO), even if you change the “TEK” (keyboard model).

You can review other available Default Layouts of your Truly Ergonomic Keyboard in our “Default Layouts” section.

You can also start this “Layout Designer” with a Default layout for your particular model/language, by visiting our Default Layouts section.

Layouts already made

We have already created diverse custom layouts you can use to enhance your Truly Ergonomic Keyboard. You can review them at our Alternate Layouts section before creating something already made.

How to save your layout for future changes

If in the future you want to reopen your layout to make any additional changes, you must first “Bookmark or Share” your layout:

  • Click on the “Bookmark or Share” button, a link will be provided. Click on the link provided, then save the new link in your computer and/or add it to your Bookmarks.
  • When you want to reopen this layout to make further changes, open the saved link and continue enhancing your layout.
  • After you have finished, click the “Save file” button and save the Layout/Firmware file to your computer, then click “Bookmark or Share” once again so you receive a new link for your new layout. Click on the link provided, then save this new link in your computer and/or add it to your Bookmarks.

You can also share these links so others can benefit from your layout. Links are unique and nobody can overwrite your saved layout. Links are quite long, around 1000 bytes in length, if you want to share them you can consider using a link shortener.

International characters

If you use international keys like ä ö ü á ó ú, you have to find the equivalent physical key of the language you are looking for, and compare it against the US-layout keyboard shown in the top‑layout keyboard, then drag this key into the TrulyErgonomic‑layout.

For example, in the German layout, the ä key is equivalent of the '" key in the top‑layout, so drag the '" key from the top‑layout into the TrulyErgonomic‑layout where you want the ä key to reside, or type '" into the TrulyErgonomic‑layout. When connected to a computer with the German language selected, this '" key will in turn provide the letter ä.

Not all keys are recognized by all languages, but if you install a key incompatible with your selected language, the key will simply be ignored by the Operating System.

Using the firmware provided by this "Layout Designer"

  • DIP switch #1 selects “Primary” (ON) or “Alternate” (OFF) layers.
  • DIP switch #2, #3, and #4 are disabled.
  • DIP switch #5 protects or allows firmware to be reprogrammed – default.


  • You can have up to 6 distinct layers programmed at the same time. For each position of the DIP switch #1 (ON – Primary layers or OFF – Alternate layers), you can configure a "Main" layer, "Num" layer, and "Fn" layer. You can have any combination of keys for each layer.
  • When using your keyboard, you can choose to use the Primary layers (DIP switch #1 ON) or Alternate layers (DIP switch #1 OFF), this is controlled by the DIP switch #1 located on the underside of the keyboard. By default, Primary layers are set for Windows/Linux and Alternate layers are set for OS X.
  • If you use or want to have two distinct layouts (Qwerty/Alternate) or use two computers (Windows/OSX) without the need to constantly flip DIP switch #1, you can consider having one layout in the “Main” layer, and the secondary layout on the “Num” layer, having the Num‑LED showing if you are using the secondary layer – you can then use the “Fn” layer for the numeric keypad as well as special functionality. Review here.
  • If you are using OS X and prefer to have the Fn keys functionality as default, compared to require to press the Fn along F6-F12 keys, you can reprogram Fn functionality on the “Main” layer and F1‑F12 keys on the “Fn” layer. Review here.


  • Not all keys are recognized by all Operating Systems (OS). If you install a key incompatible with your OS or your selected keyboard language, the key will simply be ignored by the OS.
  • After you have upgraded your Truly Ergonomic Keyboard, if when using it you press a key and a different letter/symbol than expected show on your computer, it means you have to make sure the keyboard language in your computer is set to the default Qwerty – this is the default on all computers, make sure it is not set as Dvorak or any other.
  • Make sure you do not end up with a case of “double translation”. This will happen if your keyboard is remapped to an Alternative Layout and you also have an Alternative Layout selected in your Operating System (OS). There can be only one! You can leave your keyboard Qwerty and use the Alternative layout in your OS, or you can remap the keyboard and use the standard Qwerty layout in the OS.
  • As well, make sure that you are not using third party software that affects the functionality of keyboards – like AutoHotKey or KeyRemap4MacBook/Karabiner. Otherwise, your computer can have a “double translation” – this could happen as well when your keyboard sends different key codes of what your computer is expecting and your settings on your computer are changing the key codes a second time.


  • The “Layout Designer” and all related programs (the application) are specifically designed to work with the Truly Ergonomic Keyboard. The application's source code and usage for any other purpose is strictly forbidden.


  • This “Layout Designer” only works on newest Browsers: Firefox and Chrome. If your browser does not allow you to drag a key from the top‑layout into the TrulyErgonomic‑layout, or does not allow you to save the file into your computer: you can upgrade your browser, use a different browser, or use a different computer.
  • Press your keyboard's F11 key to show this “Layout Designer” in full-screen, making it easier to use – F11 returns to normal size.
  • Click on the top “Select Layout” to see and use more available conventional layouts and keys.
  • Select your keyboard model “TEK” in the TrulyErgonomic‑layout below. This only changes the keycaps being shown; does not load the default layout and does not make any changes to the current layout.
  • If your keyboard exhibits double letters, select a higher “Debouncing” setting. The higher the number the less probability of double letters, but consider that if you select a higher setting some keystrokes might not register. You can also select a lower setting if you type fast and your keyboard does not exhibits double letters.
  • Select which layer you want to configure amongst “Main”, “Num”, and “Fn”, for each position of DIP switch #1 (ON - Primary layers or OFF - Alternate layers).
  • Drag any key from the top‑layout into any key position of the TrulyErgonomic‑layout, or click any of the keys of the TrulyErgonomic‑layout and type a key name.
  • Click on “Save file” to download the Layout/Firmware file into your computer.
  • Follow steps to upgrade your keyboard's Firmware using the Layout/Firmware file from this “Layout Designer”.

⇪ CapsASDFGHJKL;:'"#~\|
T_NLTECK non–synchronized Num Lock : This turns on or off the “Num” layer. Non–synchronized means that when you press this key, only the Embedded Numeric Keypad layer of the Truly Ergonomic Keyboard turns on or off, and no other Numeric Keypad turns on or off.
T_WPTECK Windows_key + Pause : Open the Windows System Properties
T_CBTECK Control_key + Pause : Break
T_FnTECK Fn : Special functionality, located in the “Fn” layer, while pressing this key

Default “Fn” layer functionality:
Lang4Internet Browser Email Search My ComputerCalculator Media Select Media Previous Track Media Play/PauseMedia Next Track Volume Mute Volume Down Volume UpMedia Eject

You can have up to 23 different Media Control (MC), Application Control (AC), or Application Launch (AL) keys at the same time, including the 12 keys already assigned in the default Fn layers. The same key in diverse positions and/or layers count as only one. If you add more keys, extra keys are stored in the layout but will behave as if unassigned.

SearchAC Go ToAC HomeAC BackAC ForwardAC StopAC RefreshAC Previous LinkAC Next LinkAC BookmarksAC HistoryAC Subscriptions
AC NewAC OpenAC SaveAC Save and CloseAC RenameAC Print PreviewAC PrintAC PropertiesAC Exit
AC EditAC UndoAC Redo/RepeatAC CopyAC CutAC PasteAC Paste SpecialAC Select WordAC Select SentenceAC Select ParagraphAC Select ColumnAC Select RowAC Select TableAC Select ObjectAC Select AllAC FindAC Find and ReplaceAC Insert ModeAC DeleteAC Attach CommentAC Delete CommentAC View Comment
AC Zoom InAC Zoom OutAC Full Screen ViewAC Normal ViewAC View ToggleAC Scroll UpAC Scroll DownAC Pan LeftAC Pan RightAC ExpandAC Expand AllAC CollapseAC Collapse All
AC Insert RowAC Insert ColumnAC Insert FileAC Insert PictureAC Insert ObjectAC Insert Symbol
AC FormatAC BoldAC ItalicsAC UnderlineAC StrikethroughAC SubscriptAC SuperscriptAC All CapsAC RotateAC ResizeAC Flip HorizontalAC Flip VerticalAC Mirror HorizontalAC Mirror VerticalAC Font SelectAC Font ColorAC Font SizeAC Justify LeftAC Justify Center HAC Justify RightAC Justify Block HAC Justify TopAC Justify Center VAC Justify BottomAC Justify Block VAC Indent DecreaseAC Indent IncreaseAC Numbered ListAC Restart NumberingAC Bulleted ListAC PromoteAC DemoteAC LockAC UnlockAC ProtectAC UnprotectAC Set BordersAC MergeAC SplitAC Distribute HorizontallyAC Distribute Vertically
AC SortAC Sort AscendingAC Sort DescendingAC Filter
AC SynchronizeAC Send/ReceiveAC Send ToAC ReplyAC Reply AllAC Forward MsgAC SendAC Attach FileAC UploadAC Download (Save Target As)
AC MinimizeAC MaximizeAC CloseAC New WindowAC Tile HorizontallyAC Tile Vertically
AC YesAC NoAC CancelAC CatalogAC Buy/CheckoutAC Add to Cart
AC Set ClockAC View ClockAC Select Time ZoneAC Edit Time ZonesAC Set AlarmAC Clear AlarmAC Snooze AlarmAC Reset Alarm
Volume control
Volume MuteVolume DownVolume Up
Media control
Media SelectMedia Previous TrackMedia Play/PauseMedia Next TrackMedia PlayMedia PauseMedia RecordMedia RewindMedia ForwardMedia StopMedia EjectMedia Random PlayMedia Enter DiscMedia RepeatMedia Stop/Eject
Display Brightness control
Display Brightness IncrementDisplay Brightness DecrementDisplay BrightnessDisplay Backlight ToggleDisplay Set Brightness to MinimumDisplay Set Brightness to MaximumDisplay Set Auto Brightness
Power management
AL Launch Button Configuration ToolAL Programmable Button ConfigurationMedia SelectAL Control Panel
AL Text EditorCalculatorAL Command Line Processor/RunAL Keyboard LayoutAL File BrowserAL Digital Wallet
Productivity applications
AL Word ProcessorAL SpreadsheetAL Graphics EditorAL Presentation AppAL Database AppAL Calendar/ScheduleAL Task/Project ManagerAL Log/Journal/TimecardAL Checkbook/FinanceAL ThesaurusAL DictionaryAL Spell CheckAL Grammar Check
AL Internet BrowserEmailAL NewsreaderAL VoicemailAL Contacts/Address BookAL Remote Networking/ISP ConnectAL Network ConferenceAL Network ChatAL Telephony/DialerAL Instant Messaging
AL A/V Capture/PlaybackAL Image BrowserAL Audio BrowserAL Movie BrowserAL Audio Player
Shell folders
My ComputerAL LAN/WAN BrowserAL DocumentsAL Desktop
User account
AL LogonAL LogoffAL Logon/LogoffAL Terminal Lock/ScreensaverAL Screen Saver
Task control
AL Process/Task ManagerAL Select Task/ApplicationAL Next Task/ApplicationAL Previous Task/ApplicationAL Preemptive Halt Task/Application
Help and support
AL Integrated Help CenterAL OEM Features/Tips/Tutorial BrowserAL OEM HelpAL Online CommunityAL Entertainment Content BrowserAL Online Shopping BrowserAL SmartCard Information/HelpAL Market Monitor/Finance BrowserAL Customized Corporate News BrowserAL Online Activity Browser
AL Wireless StatusAL Virus ProtectionAL EncryptionAL AlarmsAL ClockAL Power StatusAL Digital Rights Manager
Terminal keys
Language keys

You can assign additional HID usage codes from usage pages 07 or 0C, as defined by the HID Usage Tables. To do so, click on a key and enter either of the following:

  • for usage page 07 (Keyboard/Keypad), the low byte of the usage code followed by the letter 'h'. Example: A5h

  • for usage page 0C (Consumer), the full 20–bit usage code followed by the letter 'h'. Example: 0C0107h

Not all HID codes are currently recognized by all Operating Systems.

Layers DIP #1 ON – Primary: 
OFF – Alternate: 

DIP switch #1 selects “Primary” (ON) or “Alternate” (OFF) layers.

Firmware is to be used only for products manufactured by Truly Ergonomic Ltd. Any other use is prohibited.
Layout Designer created in collaboration with Yuri Khan
Firmware v4.00 created by this Layout Designer works on all models.

Helping you become productive in a comfortable and healthy manner
All contents Copyright 2019 © Truly Ergonomic Ltd. • Truly Ergonomic™ is a Trademark of Truly Ergonomic Ltd.