LoadableKeyboardLayouts < Main

Downloads
release
dev builds
extras
themes
Documentation
manual
wiki
device status
Support
forums
mailing lists
IRC
Development
bugs
patches
dev guide
Donate
Wiki > Main > LoadableKeyboardLayouts
---+!! Loadable Keyboard Layouts

%TOC%

---

---++ The Concept

The concept is quite simple: The keyboard works the same as before except the character layout can now be defined and the user font will be used display them instead of the system font. All Unicode characters are valid. A string of characters is taken from a KBD file and printed to a grid calculated to fit the current user font. If all characters won't fit on one screen, then separate 'pages' will be created. Pages are changed either by a button if your device has one defined (see your player's manual) or by moving the cursor off the screen to the left or right.

---

---++ Creating KBD Files

In order to define your own layout, you must create a kbd file. This is just a UTF-8 encoded text file with the extension 'kbd'. Create a new file in any [[http://www.rockbox.org/twiki/bin/view/Main/UnicodeGuide#Text_editors_supporting_Unicode][UTF-8 capable text editor]] and insert the characters you would like in your layout. These can be any characters you like, but note that if your font does not support them, the default glyph will be displayed instead. The keyboard code will automatically skip newlines, so feel free to use several lines, if you like. When you are done, save the file as UTF-8 and give it the extension 'kbd'.

Here follows a list of samples you can used to easily copy&paste together your own keyboard layout:

---+++ ASCII
.,!?'`"()[]{}&lt;&gt;_-=+/\|@~#$%^&*

abcdefghijklmnopqrstuvwxyz

ABCDEFGHIJKLMNOPQRSTUVWXYZ
---+++ Cyrillic
Ð°Ð±Ð²Ð³Ð´ÐµÑ&lsquo;Ð¶Ð·Ð¸Ð¹ÐºÐ»Ð¼Ð½Ð¾Ð¿Ñ€ÑÑ&sbquo;Ñ&fnof;Ñ&bdquo;Ñ&hellip;Ñ&dagger;Ñ&Dagger;Ñ&circ;Ñ&permil;Ñ&Scaron;Ñ&lsaquo;Ñ&OElig;ÑÑŽÑ

ÐÐ&lsquo;Ð&rsquo;Ð&ldquo;Ð&rdquo;Ð&bull;ÐÐ&ndash;Ð&mdash;Ð&tilde;Ð&trade;Ð&scaron;Ð&rsaquo;Ð&oelig;ÐÐžÐ&Yuml;Ð Ð¡Ð¢Ð£Ð¤Ð¥Ð¦Ð§Ð¨Ð©ÐªÐ«Ð¬ÐÐ®Ð¯
---+++ Greek
&alpha;&beta;&gamma;&delta;&epsilon;&zeta;&eta;&theta;&iota;&kappa;&lambda;&mu;&nu;&xi;&omicron;&pi;&rho;&sigma;&tau;&upsilon;&phi;&chi;&psi;&omega;&sigmaf;

&Alpha;&Beta;&Gamma;&Delta;&Epsilon;&Zeta;&Eta;&Theta;&Iota;&Kappa;&Lambda;&Mu;&Nu;&Xi;&Omicron;&Pi;&Rho;&Sigma;&Tau;&Upsilon;&Phi;&Chi;&Psi;&Omega;
---+++ Hebrew
××&lsquo;×&rsquo;×&ldquo;×&rdquo;×&bull;×&ndash;×&mdash;×&tilde;×&trade;×&rsaquo;×&oelig;×ž× ×¡×¢×¤×¦×§×¨×©×ª×&scaron;××&Yuml;×£×¥
---+++ Arabic
Ø£Ø¨Ø¬Ø¯ï»«Ù&circ;Ø²ØØ·Ù&Scaron;Ù&fnof;Ù&bdquo;Ù&hellip;Ù&dagger;Ø³Ø¹ÙØµÙ&sbquo;Ø±Ø´ØªØ«Ø®Ø°Ø¶Ø¸Øº
---+++ Korean
note: the vkeyboard will correctly combine the "Jamo" chars while typing)

ã&bdquo;±ã&bdquo;²ã&bdquo;³ã&bdquo;´ã&bdquo;µã&bdquo;¶ã&bdquo;·ã&bdquo;¸ã&bdquo;¹ã&bdquo;ºã&bdquo;»ã&bdquo;¼ã&bdquo;½ã&bdquo;¾ã&bdquo;¿ã&hellip;€ã&hellip;ã&hellip;&sbquo;ã&hellip;&fnof;ã&hellip;&bdquo;ã&hellip;&hellip;ã&hellip;&dagger;ã&hellip;&Dagger;ã&hellip;&circ;ã&hellip;&permil;ã&hellip;&Scaron;ã&hellip;&lsaquo;ã&hellip;&OElig;ã&hellip;ã&hellip;Žã&hellip;ã&hellip;ã&hellip;&lsquo;ã&hellip;&rsquo;ã&hellip;&ldquo;ã&hellip;&rdquo;ã&hellip;&bull;ã&hellip;&ndash;ã&hellip;&mdash;ã&hellip;&tilde;ã&hellip;&trade;ã&hellip;&scaron;ã&hellip;&rsaquo;ã&hellip;&oelig;ã&hellip;ã&hellip;žã&hellip;&Yuml;ã&hellip; ã&hellip;¡ã&hellip;¢ã&hellip;£

---

---++ Using KBD Files

To load a new keyboard layout, simply 'play' the kbd file from the file browser. If you want the new layout to be loaded on each boot, put it into your .rockbox folder.

That's it!

---

---++ KBD Files to Download

---+++ OPTI II
[[%ATTACHURL%/opti2.kbd][opti2.kbd]]

For a background to the theory of the Opti layout, look at this: http://www.almaden.ibm.com/u/zhai/papers/ZhaiHunterSmithHCIGalley.pdf

---+++ English and Spanish

This keyboard contains all letters and symbols needed for English and Spanish. [[%ATTACHURL%/engspa.kbd][engspa.kbd]]
---+++ Default

This is the default keyboard layout, as a .kbd file. Thought it might be useful having it explicitly written out. [[%ATTACHURL%/default.kbd][default.kbd]]

*Caveat:* it's UTF-8 text (UNIX format), so make sure to save it like that.

---
r10 - 03 Jul 2010 - 22:26:19 - SimonRaven