Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Readers > Kobo Reader > Kobo Developer's Corner

Notices

Reply
 
Thread Tools Search this Thread
Old 02-02-2015, 03:41 PM   #1
GeoffR
Wizard
GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.
 
GeoffR's Avatar
 
Posts: 1,891
Karma: 3705528
Join Date: Nov 2012
Location: New Zealand
Device: Kobo Glo, iPod Shuffle 4g
Instructions for patching firmware 3.12.1

Before starting:

1. Make sure your Kobo ereader is already running firmware version 3.12.1 (c1198635ca).

2. Check that your battery is well charged.

3. Note that in Windows 8 the instructions below might require the batch file to be run in admistrator mode.


Patching from Windows, Linux (i386/x86_64), or Mac (OS X 10.8-10.9, i386/x86_64):

1. Download and extract patch_kobo_3121.zip (attached). [WARNING: If using Windows, make sure the path to the extracted files does not contain any '&' characters.]

2. Download the Kobo firmware archive version 3.12.1 for your device (See this thread) into the 3.12.1_source subdirectory. (Don't extract.)

3. Read and edit all the *.patch files in the 3.12.1_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.12.1.bat; For Linux/Mac open a terminal, change to the patch_kobo_3121 directory, and run ./3.12.1.sh from the command line.

5. If there were no errors, copy the resulting KoboRoot.tgz from the 3.12.1_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.12.1_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 six example footer 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. Examples 1 or 4 are best if using the ePub adjustable top/bottom margin patch.

More complex customisation is possible, see this post for a guide on what all the options do.

2. My line spacing values: 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).
Attached Files
File Type: zip patch_kobo_3121.zip (473.2 KB, 659 views)

Last edited by GeoffR; 02-04-2015 at 10:13 AM. Reason: spelling
GeoffR is offline   Reply With Quote
Old 02-02-2015, 03:44 PM   #2
GeoffR
Wizard
GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.
 
GeoffR's Avatar
 
Posts: 1,891
Karma: 3705528
Join Date: Nov 2012
Location: New Zealand
Device: Kobo Glo, iPod Shuffle 4g
Notes, more patches

Notes

The `ePub fixed top/bottom margin` and `ePub ajustable top/bottom margin` patches have been combined into a single `ePub fixed/adjustable top/bottom margins` patch.


Working around problems with reading kepubs in full-screen mode:

To enable the full-screen reading option, add the following to the device's configuration file ./kobo/Kobo/Kobo eReader.conf using a unix-aware text editor (don't use Windows' Notepad or Wordpad, use an editor such as Notepad++ instead.)
Code:
[FeatureSettings]
FullScreenReading=true
Then it is possible to switch between normal and full-screen mode by ticking the "Show header and footer" box in the Reading Settings menu.

Full-screen mode works well with epubs, but there are two problems that affect kepubs:

1. If the book's stylesheet has non-zero margin or padding on the body element, then the text can be shifted to the right resulting in text being cut off at the right hand side.

For sideloaded kepubs this should be able to be fixed by adding the following to the book's stylesheet, or to kobo_extra.css if that option is enabled in Calibre:
Code:
body { margin: 0 0 0 0 !important; padding: 0 0 0 0 !important; }
For kepubs synced from Kobo, the `KePub zero body margin/padding` patch (see post #27) can be used to modify the device's built-in KePub stylesheet instead.


2. For some fonts, characters with a large side-bearing value (such as Georgia f, J, etc.) get cut off if they appear at the end of a line.

For sideloaded kepubs created by recent versions of Calibre's KoboTouchExtended driver, this can be fixed by adding the following to the book's stylesheet or to kobo_extra.css:
Code:
div#book-columns { padding: 0.2em !important; }
For kepubs synced from Kobo or created with older versions of the KoboTouchExtended driver, the `Fix kepub side bearing font cut-off bug` patch can be used to add the appropriate padding to the device's built-in stylesheet instead.


More patches:
If you know of any other patches for firmware 3.12.1, post in this thread an I'll add the patch to this post.

* A patch to fix a problem with displaying book titles in Arabic and other scripts: post #17.

* Arabic keyboard patch: post #20.

* Hebrew keyboard patch: post #24

* A patch to work around the problem with the text of some KePubs being shifted to the right and cut off in full-screen reading mode: post #27

Last edited by GeoffR; 02-19-2015 at 04:45 AM. Reason: Added link to `KePub zero body margin/padding` patch
GeoffR is offline   Reply With Quote
 
Advertisement
Old 02-02-2015, 05:31 PM   #3
boriar
Connoisseur
boriar began at the beginning.
 
Posts: 85
Karma: 10
Join Date: Jan 2015
Device: bq Avant XL, Kobo Aura H2O
Speedy Gonzalez!!!!!

Time to suscribe a new thread!
boriar is offline   Reply With Quote
Old 02-03-2015, 07:28 AM   #4
Nick_1964
Bookworm
Nick_1964 can self-interpret dreams as they happen.Nick_1964 can self-interpret dreams as they happen.Nick_1964 can self-interpret dreams as they happen.Nick_1964 can self-interpret dreams as they happen.Nick_1964 can self-interpret dreams as they happen.Nick_1964 can self-interpret dreams as they happen.Nick_1964 can self-interpret dreams as they happen.Nick_1964 can self-interpret dreams as they happen.Nick_1964 can self-interpret dreams as they happen.Nick_1964 can self-interpret dreams as they happen.Nick_1964 can self-interpret dreams as they happen.
 
Nick_1964's Avatar
 
Posts: 414
Karma: 20000
Join Date: Aug 2010
Location: Netherlands
Device: Sony prs-650, Kobo Aura HD, Kobo Glo
Thank you again
Nick_1964 is offline   Reply With Quote
Old 02-04-2015, 05:40 AM   #5
Alexander Turcic
Fully Converged
Alexander Turcic ought to be getting tired of karma fortunes by now.Alexander Turcic ought to be getting tired of karma fortunes by now.Alexander Turcic ought to be getting tired of karma fortunes by now.Alexander Turcic ought to be getting tired of karma fortunes by now.Alexander Turcic ought to be getting tired of karma fortunes by now.Alexander Turcic ought to be getting tired of karma fortunes by now.Alexander Turcic ought to be getting tired of karma fortunes by now.Alexander Turcic ought to be getting tired of karma fortunes by now.Alexander Turcic ought to be getting tired of karma fortunes by now.Alexander Turcic ought to be getting tired of karma fortunes by now.Alexander Turcic ought to be getting tired of karma fortunes by now.
 
Alexander Turcic's Avatar
 
Posts: 17,933
Karma: 11626114
Join Date: Oct 2002
Location: Switzerland
Device: Sony PRS-650 / Nexus 7 / Kindle PW
GeoffR, great instruction! Now a sticky.

Alex
Alexander Turcic is offline   Reply With Quote
Old 02-04-2015, 07:28 AM   #6
truemarine
Member
truemarine has a complete set of Star Wars action figures.truemarine has a complete set of Star Wars action figures.truemarine has a complete set of Star Wars action figures.truemarine has a complete set of Star Wars action figures.
 
Posts: 14
Karma: 374
Join Date: Dec 2013
Device: K4B, Kobo Aura H2O
So great! Thank you again!
truemarine is offline   Reply With Quote
Old 02-04-2015, 10:41 AM   #7
karamasova
Member
karamasova began at the beginning.
 
Posts: 15
Karma: 10
Join Date: Oct 2014
Device: h2o
GeoffR, Thank you! =)
karamasova is offline   Reply With Quote
Old 02-04-2015, 03:21 PM   #8
booklover6
Wizard
booklover6 ought to be getting tired of karma fortunes by now.booklover6 ought to be getting tired of karma fortunes by now.booklover6 ought to be getting tired of karma fortunes by now.booklover6 ought to be getting tired of karma fortunes by now.booklover6 ought to be getting tired of karma fortunes by now.booklover6 ought to be getting tired of karma fortunes by now.booklover6 ought to be getting tired of karma fortunes by now.booklover6 ought to be getting tired of karma fortunes by now.booklover6 ought to be getting tired of karma fortunes by now.booklover6 ought to be getting tired of karma fortunes by now.booklover6 ought to be getting tired of karma fortunes by now.
 
booklover6's Avatar
 
Posts: 4,505
Karma: 4067156
Join Date: May 2008
Location: PA (USA)
Device: Kindle Voyage, Kobo Glo, Fire HD 6
Is there anyway to add more information to the page number line in the footer? Like, for example, a clock?
booklover6 is offline   Reply With Quote
Old 02-04-2015, 07:10 PM   #9
Ripplinger
350 Hoarder
Ripplinger ought to be getting tired of karma fortunes by now.Ripplinger ought to be getting tired of karma fortunes by now.Ripplinger ought to be getting tired of karma fortunes by now.Ripplinger ought to be getting tired of karma fortunes by now.Ripplinger ought to be getting tired of karma fortunes by now.Ripplinger ought to be getting tired of karma fortunes by now.Ripplinger ought to be getting tired of karma fortunes by now.Ripplinger ought to be getting tired of karma fortunes by now.Ripplinger ought to be getting tired of karma fortunes by now.Ripplinger ought to be getting tired of karma fortunes by now.Ripplinger ought to be getting tired of karma fortunes by now.
 
Ripplinger's Avatar
 
Posts: 2,602
Karma: 3109211
Join Date: Dec 2010
Location: Midwest USA
Device: Sony PRS-350, Kobo Glo, PW2
Quote:
Originally Posted by booklover6 View Post
Is there anyway to add more information to the page number line in the footer? Like, for example, a clock?
I would love that feature myself, I've always missed the clock display from my Sony 350s. I read a lot between waiting for various things where I need to watch the time and it's very convenient to be able to check the time without having to bring up the menu, which disrupts reading for me. And I often forget as well and end up being late...
Ripplinger is offline   Reply With Quote
Old 02-05-2015, 12:01 AM   #10
JSWolf
Resident Curmudgeon
JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.
 
JSWolf's Avatar
 
Posts: 40,013
Karma: 21862133
Join Date: Nov 2006
Location: Roslindale, Massachusetts
Device: Kobo Aura H2O, Sony PRS-650, Sony PRS-T1, nook STR, iPad 4, iPhone 5
Are there any patches for 3.12.0 that are not present here?
JSWolf is offline   Reply With Quote
Old 02-05-2015, 01:59 AM   #11
jshzh
Addict
jshzh could sell banana peel slippers to a Deveel.jshzh could sell banana peel slippers to a Deveel.jshzh could sell banana peel slippers to a Deveel.jshzh could sell banana peel slippers to a Deveel.jshzh could sell banana peel slippers to a Deveel.jshzh could sell banana peel slippers to a Deveel.jshzh could sell banana peel slippers to a Deveel.jshzh could sell banana peel slippers to a Deveel.jshzh could sell banana peel slippers to a Deveel.jshzh could sell banana peel slippers to a Deveel.jshzh could sell banana peel slippers to a Deveel.
 
Posts: 290
Karma: 3394
Join Date: Aug 2009
Device: Pocketbook 602, Kobo Aura HD
Thank you, GeoffR, for the great work.

I wonder, after I disabled the firmware auto-update, if I will still able to use Pocket when there is a new firmware available. In the past I seemed to get notices telling me "sync articles" only works after I update the firmware.

Thank you.
jshzh is offline   Reply With Quote
Old 02-05-2015, 02:05 PM   #12
GeoffR
Wizard
GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.
 
GeoffR's Avatar
 
Posts: 1,891
Karma: 3705528
Join Date: Nov 2012
Location: New Zealand
Device: Kobo Glo, iPod Shuffle 4g
Quote:
Originally Posted by booklover6 View Post
Is there anyway to add more information to the page number line in the footer? Like, for example, a clock?
I'm sure it is possible, but working out how to do it is another matter, I'm not sure how easy it would be.

Quote:
Originally Posted by JSWolf View Post
Are there any patches for 3.12.0 that are not present here?
All patches from 3.12.0 are available for 3.12.1, there was very little changed between the firmware versions.

Quote:
Originally Posted by jshzh View Post
I wonder, after I disabled the firmware auto-update, if I will still able to use Pocket when there is a new firmware available. In the past I seemed to get notices telling me "sync articles" only works after I update the firmware.
I don't know sorry, I don't use Pocket, but I don't expect there would be any change in the way the `Block WiFi firmware upgrade` patch functions.
GeoffR is offline   Reply With Quote
Old 02-05-2015, 02:56 PM   #13
JSWolf
Resident Curmudgeon
JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.
 
JSWolf's Avatar
 
Posts: 40,013
Karma: 21862133
Join Date: Nov 2006
Location: Roslindale, Massachusetts
Device: Kobo Aura H2O, Sony PRS-650, Sony PRS-T1, nook STR, iPad 4, iPhone 5
Quote:
Originally Posted by GeoffR View Post
All patches from 3.12.0 are available for 3.12.1, there was very little changed between the firmware versions.
This weekend, I'll have to have a go at setting up the patches for 3.12.1. I won't install without the patches ready to go.
JSWolf is offline   Reply With Quote
Old 02-06-2015, 11:36 AM   #14
boriar
Connoisseur
boriar began at the beginning.
 
Posts: 85
Karma: 10
Join Date: Jan 2015
Device: bq Avant XL, Kobo Aura H2O
@GeoffR
Is it posible a patch to change the order of windows in home screen?
boriar is offline   Reply With Quote
Old 02-06-2015, 04:20 PM   #15
GeoffR
Wizard
GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.GeoffR ought to be getting tired of karma fortunes by now.
 
GeoffR's Avatar
 
Posts: 1,891
Karma: 3705528
Join Date: Nov 2012
Location: New Zealand
Device: Kobo Glo, iPod Shuffle 4g
Quote:
Originally Posted by boriar View Post
Is it posible a patch to change the order of windows in home screen?
I don't know. The tile order is based on the last time the object associated with the tile was used. What other order would be useful?

If you mean to change the order by dragging the tiles around or pinning them in place then that would be a nice feature, but I doubt it is possible just with a patch.
GeoffR is offline   Reply With Quote
Reply

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Instructions for patching firmware 3.2.0 DNSB Kobo Developer's Corner 66 12-05-2014 07:28 AM
Instructions for patching firmware 3.11.0 GeoffR Kobo Developer's Corner 223 12-05-2014 03:12 AM
Instructions for patching firmware 3.8.0 GeoffR Kobo Developer's Corner 92 10-22-2014 07:22 AM
Instructions for patching firmware 3.3.x, 3.4.x, 3.5.x GeoffR Kobo Developer's Corner 285 08-27-2014 10:06 AM
Instructions for patching firmware 3.1.1 GeoffR Kobo Developer's Corner 64 04-18-2014 01:23 PM


All times are GMT -4. The time now is 12:55 AM.


MobileRead.com is a privately owned, operated and funded community.