Before starting:
1. Make sure your Kobo ereader is already running one of the following firmware versions. Each patch works for only one of these specific firmware versions and no other, and so
the patch you apply must exactly match the firmware version already on your device:
3.3.0 (8eb9c1f8b2)
3.3.1 (38384a81c1)
3.4.1 (d83b1b0e2a)
3.5.0 (1ad1188b51)
2. Check that your battery is well charged.
3. Note that
the instructions below have changed significantly from previous firmware versions. This is because some files other than just libnickel.so.1.0.0 are patched.
Patching from Windows, Linux (i386/x86_64), or Mac (OS X 10.8-10.9, i386/x86_64):
1. Download and extract patch_kobo_35.zip attached.
2. Download the appropriate Kobo firmware archive version 3.3.0, 3.3.1, 3.4.1, or 3.5.0 to match the firmware version already on your device (See
this thread) into the corresponding 3.x.x_source subdirectory. (Don't extract.) Throughout these instructions
3.x.x refers to the firmware version already on your device.
3. Read and edit all the *.patch files in the 3.x.x_source subdirectory in order to: choose which patches to enable (patch_enable=`yes`) or disable (patch_enable=`no`); and to change some of the replacement values to suit your device and preferences. (See the section below on customising the patches.)
4. In Windows double-click 3.x.x.bat; For Linux/mac run ./3.x.x.sh from the command line.
5. If there were no errors, copy the resulting KoboRoot.tgz from the 3.x.x_target subdirectory to the .kobo directory on your ereader.
6. Safely eject and unplug the device, which will then update and restart.
To return your ereader to its original unpatched state:
1. Edit all the 3.x.x_source/*.patch files to disable all patches (set patch_enable = `no` for every patch).
2. Repeat steps 4-6 of the procedure above.
Customising the patches to suit your preferences and device
Some patches require no customisation, you can choose simply to enable them or not. But the following patches allow more customisation and their initial values should be considered examples only.
1. Custom reading footer style: There are three example styles, comment out the styles you don't want by adding a "#" character at the beginning of the line beginning with replace_, and leave the style you want uncommented.
More complex customisation is possible by editing the replacement css text, see the
Kobo Patcher thread for examples.
2. My line spacing values: There are two versions of this patch, resulting in a line spacing slider with 10 or 15 spacing values, so enable one and disable the other. Change the lines of the enabled patch starting with replace_float: the middle number is the original spacing value, the number to change is on the right.
The values are the line spacings set by the adjustment slider. The actual spacing depends on the font used, but for most fonts a value of 0.7 gives very tight spacing with ascenders/descenders overlapping, a value of about 0.9 gives a spacing similar to that of a mass-market paperback. The smallest value available in the unpatched firmware is 1.0.
3. Custom font sizes: Change the lines starting with replace_int. The middle number is the original value, the number to change is on the right.
The values are the font sizes set by the adjustment slider, they are in pixels so the absolute size depends on the device: size 20 on the Glo is about the same as size 25 on the AuraHD. Some books change the base font size, so you may need font sizes that are larger or smaller than your normal reading size to allow for adjusting such books.
4. Custom left & right margins: Change the lines starting with replace_int. The middle number is the original value, the number to change is on the right.
The values are the margin widths (in units of about 1% screen width I think) set by the adjustment slider. The margin size is
added to whatever margin is fixed in the book (if any) and in reading software (The kepub reader has a base margin of about 2 units, the epub reader has a base margin of zero).
5. Brightness fine control: Change the lines starting with replace_int. The middle number is the original value, the number to change is on the right.
The values are the percentage amounts that the brightness slider changes when the small or large sun symbols are tapped. (Both should probably be set to the same value).
6. ePub adjustable top/bottom margin (disabled by default): Comment out one of the replace_string lines (i.e. add a '#' character to the beginning of the line) and leave the other uncommented to select whether both top and bottom, or just the top margin, should be made adjustable. Change the right-most number of the replace_int line to set the size of the top/bottom margins relative to the left/right margins, depending on your device. (The suggested values should make the top/bottom margins roughly equal to the left/right margins).