release
dev builds
extras
themes manual
wiki
device status forums
mailing lists
IRC bugs
patches
dev guide



Wiki > Main > LoadableKeyboardLayouts (compare)

Difference: LoadableKeyboardLayouts (r8 vs. r7)

Loadable Keyboard Layouts in Rockbox

Loadable keyboard layouts allow you to define which characters are used in the layout, in which order they are displayed and to use the UI font to display them. Any characters included in unicode can be used.


The Concept

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

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

abcdefghijklmnopqrstuvwxyz

ABCDEFGHIJKLMNOPQRSTUVWXYZ

Cyrillic

абвгдеёжзийклмнопрстуфхцчшщъыьэюя

АБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ

Greek

αβγδεζηθικλμνξοπρστυφχψως

ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩ

Hebrew

אבגדהוזחטיכלמנסעפצקרשתךםןףץ

Arabic

أبجدﻫوزحطيكلمنسعفصقرشتثخذضظغ

Korean

note: the vkeyboard will correctly combine the "Jamo" chars while typing)

ㄱㄲㄳㄴㄵㄶㄷㄸㄹㄺㄻㄼㄽㄾㄿㅀㅁㅂㅃㅄㅅㅆㅇㅈㅉㅊㅋㅌㅍㅎㅏㅐㅑㅒㅓㅔㅕㅖㅗㅘㅙㅚㅛㅜㅝㅞㅟㅠㅡㅢㅣ



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



KBD Files to Download

OPTI II

opti2.kbd

English and spanish Spanish keyboard layout

This keyboard contains all letters and symbols needed for english English and spanish. Spanish. engspa.kbd


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

Revision r8 - 02 Apr 2008 - 01:06 - MarcGuay
Revision r7 - 27 Mar 2008 - 02:31 - HarrisonTu
Copyright by the contributing authors.