Keyman Developer 9 (download the beta, free, here) includes full touch layout editing tools. In the image below I am editing the Geez Frontier Foundation's Amharic touch layout. We talk more about the touch editor in previous blog posts:

Touch Editor - Amharic

Once you have created your keyboard layout, you need to test it. Your keyboard layout may cover desktops as well as touch devices. The Build tab of the keyboard editor gives you access to testing and debugging commands for all platforms.

Touch Editor - Build tab

Testing is easy on Windows: press the Start Debugging button on the Build tab to test the rules in your keyboard layout with a fully interactive debugger. This allows you to step through complex rules, inspecting the contents of the stores referenced in each rule, and examine the context, deadkey state and output at each point.

After validating your rules, you will want to test the on screen keyboard and how your keyboard feels within other applications in Windows.  We recommend creating a package in order to simplify the installation of both the on screen keyboard and the keyboard (which are stored as two separate files). Then click the Install button in Build tab of the package wizard and you are done.

But how do you test your touch layout on your iPhone, iPad or Android device? We've thought about this as well. Keyman Developer includes a web server specifically for testing and installing keyboard layouts on these devices.

To start the web server and debugging session, on the Build tab of your keyboard editor, click Test KeymanWeb Keyboard (we may rename these buttons in a later release to reflect the cross-platform targets here).

You may need to open up the host port on your local computer firewall; most firewall software will prompt you at this point.  The default port that Keyman Developer uses is 8008. You can change this in the Tools/Options/Debugger dialog if necessary.

You will see a list of web addresses in the list box below the Test KeymanWeb Keyboard. This lists all the computer and domain names and IP addresses that Keyman Developer is listening on that we can find. Why so many? Because of the variety of network setups, different users will need to use different addresses; Keyman Developer leaves that up to you!  We call the list the Debug Host List.

KeymanWeb Debug Host

You can test your desktop layout by selecting an address in the debug host list and clicking Open Debug in Browser.  This will load the KeymanWeb Debug Host page in your browser, and you should be able to select your keyboard from the list and start using it.

To start testing on your mobile device, your device needs to be on the same network as your PC. Then open your web browser on the device. Which browser? On iOS, use Safari.  On Android devices, we recommend using Chrome. We don't recommend the Android Browser, because its capabilities vary dramatically depending on the Android version and the brand of your device.

Then you will need to pick an address from the debug host list in Keyman Developer that your device can find. An IP address on the same network is almost always going to work, but you may find that a canonical domain name works as well, if you are in an environment with a name server. The localhost and addresses are local to your PC — so don't try those.

Enter the address into the URL bar on your browser; don't forget to type the :8008 port at the end of the address you choose (on most devices you can skip the http:// at the start):


All going well, you should be presented with a page like this:


If you get a Host Not Found error, try different addresses from the KeymanWeb Debug Host list, check your computer's firewall settings, and make sure that both devices are on the same network.

Now you can instantly test your layout in KeymanWeb Touch, by clicking in the blank edit box: the touch layout will appear. If you make changes in Keyman Developer, just recompile (Compile to Web button, or Shift+F7), and reload on the touch device — you don't need to click the Test KeymanWeb button again.


Finally, you can also install your keyboard layout directly into Keyman for iPhone and iPad or Keyman for Android by clicking the Install Keyboard into native Keyman button on the test page on your device. You do need to have the app installed before clicking the button, of course.



Now your keyboard layout is installed and available in the Keyman App, and if you have the Keyman version with the system keyboard support installed, across all apps.

You can test multiple keyboards just by clicking Test KeymanWeb Keyboard in each keyboard editor.

You can distribute your keyboard to other users by following the instructions in these two blog posts:

0 thoughts on “How to test your keyboard layout with Keyman Developer 9 — touch and desktop”

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Related Posts

Developing Keyman

Keyman 11.0 is now available

We have just released Keyman 11.0 for Windows, macOS, Linux, Android, iOS and web, as well as Keyman Developer, the keyboard development suite. Keyman for Linux is entirely new for version 11. For the other Read more…

Developing Keyboards

Introducing the Keyman Open Source Keyboard Repository

We have many hundreds of keyboard layouts online at that cover well over a thousand  languages. These keyboard layouts work on Windows, the web, iPhones, iPads and Android phones and tablets. However, most of Read more…