User Guide

JanneEdelman edited this page Feb 23, 2014 · 27 revisions


The Emoji Keyboard implements all Japanese mobile culture born ideograms or smileys implemented in Apple iOS 5 and latter iOS versions with support for preseting and writing those symbols. Android and Windows Phone implements these symbols partially in screen font and Windows Phone partially also on keyboard.

This Sailfish addon implements the full emoji support in Jolla phones running SailfishOS with screen font (SailfishEmoji.otf) supporting the Emoji symbols and keyboard layout supporting writing of all Emoji symbols.

The Emoji Keyboard is quite crowded with total of 834 symbols in it and typically Emoji keyboard is selected to only to type ideograms or smileys and then switched back to language specific keyboard used to write text.


Tap and hold spacebar key on your selected keyboard and swipe over Emoji on top of the list while still holding tap and release when holding over Emoji and keyboard selector.

Same method you can use to switch to any other keyboard layout.


Emoji keyboard has three lines of symbol keys with total of 30 symbols on keyboard, two page selectors on third line at left and right and emoji character set selection line as fourth.

First two lines have 11 symbols on both and third line has place for 8 symbols. As each emoji set contains more than 30 symbols there are multiple pages on each symbol set. Arrow-head key on most right of the third line selects next page of symbols from same symbol set and arrow-head key on most right of the third line selects previous page of symbols. Both keys will be disabled individually when first page is select (no previous page) or last page is selected (no next page). Pages can be selected by tapping arrow-head keys.


Fourth line - called Selection Key Row - has two configurable styles, changable via Emoji Keyboard Settings. Each style has four different elements:

  • Keyboard selection key, acting also as SPACE key according to configuration made via settings.
  • Emoji Set selection keys, where first key opens set of your favorite or latest emoji symbols typed. Last 30 emojis typed are listed in this set starting from the one you last typed. Each symbol is listed only once. The Emoji Keyboard has 5 sets of emoji symbols. Each set has specific symbol on set selection keys and key of selected emoji set remains highlighed.
  • Backspace key, acting as normal BACKSPACE, only location has been dropped from normal last key on third line position to bottom line.
  • Enter/Action key, visual presence either as Enter key or as Action key differs from application calling the keyboard. Functionality equals with Enter/Action key on other layouts, so you do not need to switch back to other keyboard layout in order to send a message or write line feed.

Apple style

A selection row style inspired by the Apple iOS emoji keyboard and named according to source of inspiration. This is The Emoji Keyboard default style where selection row elements are in order: * Keyboard selection key * Emoji Set selection keys * Backspace key * Enter/Action key

Kurosh style

A selection row style inspired by The Emoji Keyboard fans and named by Russian mathematician. This is alternative style which can be selected into use from settings. In this style Keyboard selection key has been moved near the same location is has in standard Jolla keyboard layouts. Order of selection row elements in this style is: * Emoji Set selection keys * Keyboard selection key * Backspace key * Enter/Action key #### INCOMPLETE KEYBOARD LAYOUTS ON EACH SYMBOL SET

A full keyboard has 30 keys and as number of symbols in each set typically is not multiple of thirty, the last keyboard page remains incompletely filled.

Division of symbols on pages may be altered later to distribute keys more evenly or to add new symbols to the keyboard. Empty keys on imcomplete pages have been disabled and do not have any functionality.


The Emoji Keyboard has been designed to operate both portrait and landscape orientation. Key order remains same and same functionality applies to keyboard in both orientations.

It has been designed and tested in Jolla with 960 x 540 screen resolution and may or may not operate properly in other devices running SailfishOS. The Emoji Keyboard is also dependent on closed source Jolla code and thus might not work properly in other devices.

### SELECTING ANOTHER KEYBOARD LAYOUT Returning back to other keyboard layout from Emoji keyboard can be done with same method than Emoji keyboard can be selected. In Emoji keyboard SPACE key is mostly obsolete although exists. It has been located to bottom left corner with the purpose of being more keyboard selection key than space key.

You can return back to other keyboard by tapping and holding keyboard selector key in Emoji keyboard until keyboard selector opens. Hold still and swipe your finger on top or preferred keyboard layout and release hold. Keyboard will be switched to the one you just selected.


Version 0.3 implemented configurable settings in The Emoji Keyboard as first keyboard layout ever in Jolla which enables user to alter keyboard behavior in live action. There is Settings key on most right of keyboards paste input line.

Settings can be accessed by pressing and holding Settings key for a moment until settings view opens. Settings is part of emoji keyboard layout and can be accessed via The Emoji Keyboard only.

All settings are effective immediately after change and do not need any saving. When altering or viewing settings has been finished, settings can be exited using common Sailfish gesture by swiping from left to right.

As there is more than a screenful of settings the page can be scrolled on vertical direction by swiping the page to up or down direction.


Emoji Keyboard Settings allow personalization of keyboard by enabling following settings:

  • Selection Key Row style can be selected from two available styles

  • Keyboard Switch Key Click Action is setting allowing keyboard user to configure if Keyboard switch key should act as spacebar when clicked once. Currently supported actions are:

    • Spacebar, a space character is typed when keyboard switch key is clicked
    • None, no action from clicking keyboard switch key
  • Favorites set can be viewed and reseted from settings. Reset action is delayed by 5 seconds and accidental clicks to Reset Favorites button can be canceled. Exiting settings does not cancel delayed reset.

  • Send usage statistics settings can be used to disable usage statistics collection and re-enable it again. Statistics collects only anonymous information when The Emoji Keyboard is launched to calculate how many users are using the keyboard, how many times keyboard is launched and in which countries and locales the keyboard is in use.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.