0.2/Customization

Table of Contents

    1. Fonts
    2. Keys
      1. Global keys
      2. FBReader
      3. CoolReader
      4. Other applications
    3. Skins
  2. Advanced topics
    1. SSH

Customization Guide

Fonts

In order to add fonts to device, put them to one of following directories:

SD card .fonts directory
Internal storage .home/user/.fonts directory

Note that the internal memory is accessible using USB on N516, but only available on V3 by using SSH.

Keys

It is possible to remap most keys on the device. There are four keymapping formats out there:

  • Global keys
  • FBReader
  • CoolReader
  • Other applications

Global keys

Global keymappings are declared in the file /etc/uk.conf. It is not recommended to change this file.

If you know what conffiles, X keycode and UNIX domain sockets mean, you can figure out how to change the global keymappings by looking at the source code of the uk utility in uk.git repository.

FBReader

To remap keys in FBReader, first look list of available commands in /usr/share/FBReader/default/keymap.xml. Remember the command you want to remap (action="..."). Then open /home/user/.FBReader/options.xml and look for the Keys group there (add it if it is not there yet). Then you need to add new ActionX and KeyX with new number and increase the X Number with Number+1. For example, to remap largeScrollForward (go to the next page) command to Return (OK) key and menu (book menu) command to 5 key, you need to add this code into your /home/user/.FBReader/options.xml: 

  <group name="Keys">
    <option name="Action0" value="largeScrollForward"/>
    <option name="Action1" value="menu"/>
    <option name="Key0" value="Return"/>
    <option name="Key1" value="5"/>
    <option name="Number" value="2"/>
  </group>

CoolReader

Other applications

All other applications use the same format for keymappings.

Keymaps for applications are stored in /usr/share/keys/$application.ini, and can be overridden by /home/user/.keys/$application.ini

A typical .ini file looks like this (for madeye): 

$ cat /usr/share/keys/madeye.ini
[default]
Left=PREV_IMAGE
Up=PREV_IMAGE
KP_9=PREV_IMAGE
Right=NEXT_IMAGE
Down=NEXT_IMAGE
KP_0=NEXT_IMAGE
KP_1=DEC_BRIGHTNESS
KP_2=INC_BRIGHTNESS
KP_3=DEC_CONTRAST
KP_4=INC_CONTRAST
KP_5=DITHER
Return=RELOAD
Escape=QUIT
$

In order to e.g. use key 6 for going to next image and 7 for going to previous one, create /home/user/.keys/madeye.ini with the following content: 

[default]
KP_6=NEXT_IMAGE
KP_7=PREV_IMAGE

In order to disable some key, use empty line instead of the action name: 

Return=

Files in /home/user will not be overwritten during a firmware upgrade.

Skins

Compiled Edje themes in /usr/share/$app. No more information at the moment, and no way to put them to $HOME, sorry.

Advanced topics

SSH

See the Connect via SSH access page for instructions on accessing the device using SSH.