| 403 | | === Fonts === |
| 404 | | |
| 405 | | In order to add fonts to device, put them to one of following directories: |
| 406 | | |
| 407 | | || SD card || `.fonts` directory || |
| 408 | | || Internal storage || `.home/user/.fonts` directory || |
| 409 | | |
| 410 | | Note that the internal memory is accessible using USB on '''N516''', but only available on '''V3''' by using SSH. |
| 411 | | |
| 412 | | === Keys === |
| 413 | | |
| 414 | | It is possible to remap most keys on the device. There are four keymapping formats out there: |
| 415 | | * Global keys |
| 416 | | * FBReader |
| 417 | | * !CoolReader |
| 418 | | * Other applications |
| 419 | | |
| 420 | | ==== Global keys ==== |
| 421 | | |
| 422 | | Global keymappings are declared in the file `/etc/uk.conf`. It is not recommended to change this file. |
| 423 | | |
| 424 | | 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. |
| 425 | | |
| 426 | | ==== FBReader ==== |
| 427 | | |
| 428 | | 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`: |
| 429 | | {{{ |
| 430 | | <group name="Keys"> |
| 431 | | <option name="Action0" value="largeScrollForward"/> |
| 432 | | <option name="Action1" value="menu"/> |
| 433 | | <option name="Key0" value="Return"/> |
| 434 | | <option name="Key1" value="5"/> |
| 435 | | <option name="Number" value="2"/> |
| 436 | | </group> |
| 437 | | }}} |
| 438 | | ==== !CoolReader ==== |
| 439 | | |
| 440 | | * [wiki:0.2/UsersGuide/cr3 here] |
| 441 | | |
| 442 | | ==== Other applications ==== |
| 443 | | |
| 444 | | All other applications use the same format for keymappings. |
| 445 | | |
| 446 | | Keymaps for applications are stored in /usr/share/keys/$application.ini, and can be overridden by /home/user/.keys/$application.ini |
| 447 | | |
| 448 | | A typical .ini file looks like this (for madeye): |
| 449 | | {{{ |
| 450 | | $ cat /usr/share/keys/madeye.ini |
| 451 | | [default] |
| 452 | | Left=PREV_IMAGE |
| 453 | | Up=PREV_IMAGE |
| 454 | | KP_9=PREV_IMAGE |
| 455 | | Right=NEXT_IMAGE |
| 456 | | Down=NEXT_IMAGE |
| 457 | | KP_0=NEXT_IMAGE |
| 458 | | KP_1=DEC_BRIGHTNESS |
| 459 | | KP_2=INC_BRIGHTNESS |
| 460 | | KP_3=DEC_CONTRAST |
| 461 | | KP_4=INC_CONTRAST |
| 462 | | KP_5=DITHER |
| 463 | | Return=RELOAD |
| 464 | | Escape=QUIT |
| 465 | | $ |
| 466 | | }}} |
| 467 | | |
| 468 | | 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: |
| 469 | | {{{ |
| 470 | | [default] |
| 471 | | KP_6=NEXT_IMAGE |
| 472 | | KP_7=PREV_IMAGE |
| 473 | | }}} |
| 474 | | |
| 475 | | In order to ''disable'' some key, use empty line instead of the action name: |
| 476 | | {{{ |
| 477 | | Return= |
| 478 | | }}} |
| 479 | | |
| 480 | | Files in /home/user will not be overwritten during a firmware upgrade. |
| 481 | | |
| 482 | | |
| 483 | | |
| 484 | | |
| 485 | | === Skins === |
| 486 | | |
| 487 | | Compiled Edje themes in /usr/share/$app. No more information at the moment, and no way to put them to $HOME, sorry. |
| 488 | | |
| 489 | | == Advanced topics == |
| 490 | | |
| 491 | | === SSH === |
| 492 | | |
| 493 | | See the [wiki:Documentation/ConnectViaSSH Connect via SSH access] page for instructions on accessing the device using SSH. |
| | 403 | See [wiki:0.3/Customization customization page]. |
