Before starting:
1. Make sure your Kobo ereader is running firmware version 3.3.0 (8eb9c1f8b2). These patches work only for this specific firmware version and no other.
2. Check that your battery is well charged.
Windows (or other OS using a Windows emulator):
1. Download mz_koboreaderpatch_12.exe (self-extracting archive) from http://rghost.net/53295702. Extract kpg.exe only (ignore the other files, they are for older firmware versions).
2. Download the Kobo firmware archive version 3.3.0 for your device (See this thread). Inside kobo-update-3.3.0.zip is a tar archive KoboRoot.tgz. Inside KoboRoot.tgz is a file usr/local/Kobo/libnickel.so.1.0.0. Extract libnickel.so.1.0.0 only (ignore the other files).
3. Download kpg_conf_330.zip (attached) and extract kpg.conf.
4. Edit kpg.conf to: enable the patches you want (set patch_enable = `yes`) and disable the patches you don't want (set patch_enable = `no`); change the replacement values for the patches to suit your preferences. (See the section below on editing kpg.conf.)
5. Put kpg.exe, libnickel.so.1.0.0, and the edited kpg.conf together in the same directory and run kpg.exe.
6. If there were no errors, copy the ressuting KoboRoot.tgz to the .kobo directory on your ereader.
7. Safely eject then unplug the ereader. Once unplugged the ereader will update and restart.
Linux (or other OS with GCC and GLIBC):
1. Download and extract patch32lsb_330.zip (attached) into a working directory.
2. Read all the *.patch files and edit them with a text editor, in order to: choose which patches to enable (patch_enable=`yes`) or disable (patch_enable=`no`); change some of the replacement values to suit your device and preferences. (See the section below on editing kpg.conf.)
3. Download the Kobo firmware archive version 3.3.0 for your device (See this thread) into the same working directory as step 2. (do not extract).
4. Run make-patch.sh from the command line.
5. If there were no errors, copy the resulting KoboRoot.tgz 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 kpg.conf (or all *.patch files for Linux) to disable all patches (set patch_enable = `no` for every patch).
2. Delete the old KoboRoot.tgz, then repeat the last three steps of the procedure for your OS above.
Editing kpg.conf to suit to 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 existing values in kpg.conf 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).
1. Make sure your Kobo ereader is running firmware version 3.3.0 (8eb9c1f8b2). These patches work only for this specific firmware version and no other.
2. Check that your battery is well charged.
Windows (or other OS using a Windows emulator):
1. Download mz_koboreaderpatch_12.exe (self-extracting archive) from http://rghost.net/53295702. Extract kpg.exe only (ignore the other files, they are for older firmware versions).
2. Download the Kobo firmware archive version 3.3.0 for your device (See this thread). Inside kobo-update-3.3.0.zip is a tar archive KoboRoot.tgz. Inside KoboRoot.tgz is a file usr/local/Kobo/libnickel.so.1.0.0. Extract libnickel.so.1.0.0 only (ignore the other files).
3. Download kpg_conf_330.zip (attached) and extract kpg.conf.
4. Edit kpg.conf to: enable the patches you want (set patch_enable = `yes`) and disable the patches you don't want (set patch_enable = `no`); change the replacement values for the patches to suit your preferences. (See the section below on editing kpg.conf.)
5. Put kpg.exe, libnickel.so.1.0.0, and the edited kpg.conf together in the same directory and run kpg.exe.
6. If there were no errors, copy the ressuting KoboRoot.tgz to the .kobo directory on your ereader.
7. Safely eject then unplug the ereader. Once unplugged the ereader will update and restart.
Linux (or other OS with GCC and GLIBC):
1. Download and extract patch32lsb_330.zip (attached) into a working directory.
2. Read all the *.patch files and edit them with a text editor, in order to: choose which patches to enable (patch_enable=`yes`) or disable (patch_enable=`no`); change some of the replacement values to suit your device and preferences. (See the section below on editing kpg.conf.)
3. Download the Kobo firmware archive version 3.3.0 for your device (See this thread) into the same working directory as step 2. (do not extract).
4. Run make-patch.sh from the command line.
5. If there were no errors, copy the resulting KoboRoot.tgz 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 kpg.conf (or all *.patch files for Linux) to disable all patches (set patch_enable = `no` for every patch).
2. Delete the old KoboRoot.tgz, then repeat the last three steps of the procedure for your OS above.
Editing kpg.conf to suit to 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 existing values in kpg.conf 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).