Instructions for patching firmware 4.31.19086

[geek1011]

This patch thread is for firmware 4.31.19086 (2adb3f45adf02047d1d48fdb29f28ffbb7b7c172):

Instructions for patching on Windows, Linux, or macOS with kobopatch:

1. Download the Kobo firmware release
   You can find the download links here here.
2. Download and extract the patch zip
   Download and unzip kobopatch_4.31.19086.zip from here.
3. Copy the firmware file to the src folder
   Copy the original firmware you just downloaded into the kobopatch src folder.
4. Install the firmware if needed
   Install the firmware on your kobo BEFORE proceeding with the next steps. You can do this by extracting the contents of the firmware zip into the .kobo folder and ejecting.
5. Choose your patches from the files in the src folder
   Enable patches in the files in the src folder (or use the overrides in kobopatch.yaml to keep your options separate).
6. Run kobopatch
   Double-click kobopatch.bat on Windows, or run ./kobopatch.sh on Linux or macOS. On macOS, you can drag it into the terminal and press enter (you may need to go to System Preferences - Security and Privacy - General to confirm that you actually want to run it).
7. Install the patches by copying KoboRoot.tgz into the .kobo folder of your device
   If the patching succeeded, a file named KoboRoot.tgz will be created in the out folder. Copy it to the .kobo folder of your device. Safely remove your device once you are finished. On Linux, you may have to press Ctrl+H to show the .kobo folder.

Download

[geek1011]

Changes to the kobopatch zip:
v74 (2022-01-21): Initial release for 4.31.19086.

Missing patches:
- None!

New patches in this version:
- jackie_w: KePub stylesheet additions - optimizeLegibility

[Deobulakenyo]

Forgive my laziness but can i use my kobopatch yaml from 4.30 fw and just use that to replace the one in this 4.31 patch files and generate a new koboroot.tgz?

Or is there any change within the seetings files that would break my intended plan?

[geek1011]

Originally Posted by Deobulakenyo

Forgive my laziness but can i use my kobopatch yaml from 4.30 fw and just use that to replace the one in this 4.31 patch files and generate a new koboroot.tgz?

Yes, and you just need to update the firmware version in the config.

[Deobulakenyo]

Originally Posted by geek1011

Yes, and you just need to update the firmware version in the config.

as always, thank you very much for the updates.

[Uncle Robin]

Originally Posted by geek1011

Yes, and you just need to update the firmware version in the config.

That was so easy I'm actually going to do something I've not done in ages and read 2 books in Kobo stock as downloaded kepubs rather than epubs in KOReader. Thanks!

[JSWolf]

Originally Posted by Uncle Robin

That was so easy I'm actually going to do something I've not done in ages and read 2 books in Kobo stock as downloaded kepubs rather than epubs in KOReader. Thanks!

Do you know if side-loaded fonts work? There was a report that they do not work. This is important to know before installing this firmware.

[JSWolf]

geek1011, thank you for the patches.

[Barruel]

Originally Posted by geek1011

Changes to the kobopatch zip:
v74 (2022-01-21): Initial release for 4.31.19086.

Missing patches:
- None!

New patches in this version:
- jackie_w: KePub stylesheet additions - optimizeLegibility

As I understand it, the trio of patches "KePub stylesheet additions - text justify", "KePub stylesheet additions - optimizeSpeed" and "KePub stylesheet additions - optimizeLegibility" replace the old "KePub stylesheet additions patch".

Shouldn't that be explicitly stated? I'm thinking mainly in those using kobopatch.yaml to pick the patches and updating from older firmwares.I can see myself being fooled without that info.

[Barruel]

Originally Posted by JSWolf

Do you know if side-loaded fonts work? There was a report that they do not work. This is important to know before installing this firmware.

They do work.

[jackie_w]

Originally Posted by Barruel

As I understand it, the trio of patches "KePub stylesheet additions - text justify", "KePub stylesheet additions - optimizeSpeed" and "KePub stylesheet additions - optimizeLegibility" replace the old "KePub stylesheet additions patch".

Shouldn't that be explicitly stated? I'm thinking mainly in those using kobopatch.yaml to pick the patches and updating from older firmwares.I can see myself being fooled without that info.

It is explicitly stated in libnickel.so.1.0.0.yaml

# The next 2 patches are alternatives. Enable ONE ONLY.
# They have replaced the old patch named 'KePub stylesheet additions'

... but spot the careless error (by me). That should have been updated to "# The next 3 patches are alternatives ..." which I'll now correct. Edit: Done

Edit 2: I did post explicit details in this forum at the time the old single patch stopped working - see here.

[DNSB]

Originally Posted by JSWolf

Do you know if side-loaded fonts work? There was a report that they do not work. This is important to know before installing this firmware.

I just tested the sideloaded fonts on my Sage and they all seem to work using my Font Tester epub file.

[xyclonei]

Thank you for the patches!

I've noticed that on this firmware, there is a larger gap on the footer than the header (attached).

I've applied the below patches, however I cannot figure out what's causing this. This was fine in the 4.30 firmware with the same parameters. Any idea what's causing this?

Custom header/footer captions	Font size : 22px; footer margin : 108px
Reduce new header/footer height	55px
Reduce top/bottom page spacer	16px
Remove footer (row3) and increase cover size on new home screen	22 to 16px

[jackie_w]

Originally Posted by xyclonei

Thank you for the patches!

I've noticed that on this firmware, there is a larger gap on the footer than the header (attached).
<snip>
Any idea what's causing this?

Probably just the particular circumstances of that particular page in that particular book.

The first line on the page always starts in the same place. The last line on the page lands wherever it lands depending what else came before it on that page. The reading app doesn't think it can fit any more whole lines on that page (using the book's current font-size and line spacing) and the scenebreak height will affect the position of the last line.

[Barruel]

Originally Posted by jackie_w

It is explicitly stated in libnickel.so.1.0.0.yaml


... but spot the careless error (by me). That should have been updated to "# The next 3 patches are alternatives ..." which I'll now correct. Edit: Done

Edit 2: I did post explicit details in this forum at the time the old single patch stopped working - see here.

I've noticed that too. Thanks for fixing it.

Originally Posted by DNSB

I just tested the sideloaded fonts on my Sage and they all seem to work using my Font Tester epub file.

Can you share that epub? I'm playing with fonts a lot lately and would love that. I'm using a custom KOReader's font-test.html, but I must generate a new one when I add a new font, generate a kepub and edit it.