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

Go Back   MobileRead Forums > E-Book Readers > Android Devices

Notices

Reply
 
Thread Tools Search this Thread
Old 09-08-2023, 05:37 PM   #1
geek1011
Wizard
geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.
 
Posts: 2,792
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
Lithium EPUB Reader (Android) App Patches

I thought I'd share my patches for the Lithium EPUB Reader in case anyone finds them useful. I made them for myself back in 2019, and open-sourced them earlier this year.
  • Custom icon color.
  • Custom cover aspect ratio.
  • Optional cover-only grid view.
  • Debuggable reader webview.
  • Offline dictionary. (the original app doesn't even have one)
  • Custom fonts. (I really like Equity btw)
  • Smaller minimum font size.
  • Additional information in the reader footer.
  • Series metadata support.
  • Series section in library drawer.
  • Increased number of visible actions for the reader toolbar.
  • Support for inverted portrait/landscape rotation.

Note that this does not unlock the Pro features; you still need to get that the normal way through Google Play.

I've repeatedly tried to get in touch with the app's creator to try and get some or all of these improvements included in the base app without success, unfortunately.

Source Code & Build Instructions

.
Attached Thumbnails
Click image for larger version

Name:	lithiumpatch_dictionary.png
Views:	888
Size:	395.6 KB
ID:	203650   Click image for larger version

Name:	lithiumpatch_settings.png
Views:	902
Size:	150.5 KB
ID:	203651   Click image for larger version

Name:	lithiumpatch_progress.png
Views:	809
Size:	532.8 KB
ID:	203652   Click image for larger version

Name:	lithiumpatch_fonts.png
Views:	815
Size:	251.4 KB
ID:	203653   Click image for larger version

Name:	lithiumpatch_seriesmeta_list.png
Views:	815
Size:	393.2 KB
ID:	203654   Click image for larger version

Name:	lithiumpatch_seriesmeta_grid.jpg
Views:	810
Size:	243.0 KB
ID:	203655   Click image for larger version

Name:	lithiumpatch_seriesdrawer.png
Views:	809
Size:	105.1 KB
ID:	203656  

Last edited by geek1011; 09-09-2023 at 10:08 AM.
geek1011 is offline   Reply With Quote
Old 03-12-2024, 05:19 PM   #2
geek1011
Wizard
geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.
 
Posts: 2,792
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
I've recently added some features to this:
  • Support for EPUB3-style series metadata.
  • Support for deep lookups in the dictionary (i.e., you can tap a word in a definition to look it up.
geek1011 is offline   Reply With Quote
Old 03-20-2024, 10:44 PM   #3
geek1011
Wizard
geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.
 
Posts: 2,792
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
For testing, builds of the latest version can be found here.

These builds do not include sync support or additional custom fonts (you need to build it yourself for that), and pro features still require the pro version to be purchased from Google Play.
geek1011 is offline   Reply With Quote
Old 03-30-2024, 01:03 AM   #4
geek1011
Wizard
geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.
 
Posts: 2,792
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
Some more features:
  • Full-bleed full-screen background on devices with a notch.
  • More MD3-like design for library view.
  • Larger book covers in grid view (they now expand to fill the remaining width).
  • More built-in themes.
  • More fonts.
  • Option to enable hyphenation.
  • Expanded display settings popup.
  • Minor dictionary improvements.
geek1011 is offline   Reply With Quote
Old 03-30-2024, 09:01 AM   #5
Quoth
Reading till the spring
Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.
 
Quoth's Avatar
 
Posts: 12,490
Karma: 93729713
Join Date: Jun 2017
Location: Ireland
Device: All 4 Kinds: epub eink, Kindle, android eink, NxtPaper11
Can it do two pages side by side when tablet is in landscape? Unless I can't find the setting it's the only major omission on unpatched version.
Quoth is offline   Reply With Quote
Old 03-30-2024, 12:08 PM   #6
geek1011
Wizard
geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.
 
Posts: 2,792
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
Quote:
Originally Posted by Quoth View Post
Can it do two pages side by side when tablet is in landscape?
No, it can't, but that should be possible. I've been looking at the pagination mechanism since I'm trying to fix the highlight bug (highlighting near the top/bottom of the page or over large margins causes unpredictable jumping and scrolling).

It shouldn't break anything if I make the resize logic halve the page width on a screen of a certain width, and since it does reflow during any size change, it shouldn't cause other issues.

Quote:
only major omission on unpatched version
I found the lack of a dictionary, custom fonts, and series metadata to be pretty major lol... and the minimum font size on badly formatted books. Those were the only patches I did for the first few years.
geek1011 is offline   Reply With Quote
Old 03-30-2024, 01:47 PM   #7
Quoth
Reading till the spring
Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.Quoth ought to be getting tired of karma fortunes by now.
 
Quoth's Avatar
 
Posts: 12,490
Karma: 93729713
Join Date: Jun 2017
Location: Ireland
Device: All 4 Kinds: epub eink, Kindle, android eink, NxtPaper11
Quote:
Originally Posted by geek1011 View Post
I found the lack of a dictionary, custom fonts, and series metadata to be pretty major lol... and the minimum font size on badly formatted books. Those were the only patches I did for the first few years.
Yes, those are good additions.

However loads of Android epub apps not only don't have those but are essentially like reading on PalmOS, totally broken CSS and font support!
Quoth is offline   Reply With Quote
Old 03-30-2024, 05:50 PM   #8
geek1011
Wizard
geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.
 
Posts: 2,792
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
Quote:
Originally Posted by Quoth View Post
However loads of Android epub apps not only don't have those but are essentially like reading on PalmOS, totally broken CSS and font support!
Yeah, I remember when I first found Lithium (when it had < 10K installs), I searched "epub" on Google Play and tried nearly every one of the ~40 apps in search of one with a decent interface and rendering.

The only other apps that were even close were Boox, Prestigio, and PocketBook. Moon+ is okay-ish, but it kind of just throws the kitchen sink at everything and doesn't do anything particularly well.

I liked Lithium at first sight, and when I started patching it, I liked it even more. It's very well-designed internally (unlike pretty much any other e-book app I've looked at apart from Libby), and since it's written in Java, it's much easier to patch to add major features than Kobo lol. Ever since then, I've been tweaking it until it's perfect...

The last big things on my TODO list are reworking pagination (for the highlight fix, for better FXL support, for faster chapter loads, for spreads on landscape, and better position saving especially while changing fonts), PDF support (using PDF.js), and some tweaks to make it work better with EPUB3 stuff.

Last edited by geek1011; 03-30-2024 at 07:03 PM.
geek1011 is offline   Reply With Quote
Old 04-27-2024, 11:07 AM   #9
NeoGenesisX
Junior Member
NeoGenesisX began at the beginning.
 
Posts: 5
Karma: 10
Join Date: Aug 2023
Device: PPW5, Scribe
Thumbs up

You're a life saver, mine own android e-reader(s) but not a single apps are fully support Thai language flawlessly except this one. But the main problem is, as you have mentioned, the lack of customization of fonts and the size.

Thank you for your hard work!
NeoGenesisX is offline   Reply With Quote
Old 04-27-2024, 12:17 PM   #10
NeoGenesisX
Junior Member
NeoGenesisX began at the beginning.
 
Posts: 5
Karma: 10
Join Date: Aug 2023
Device: PPW5, Scribe
Oh by the way, the font selector doesn't work when the EPUB's language is set to 'th'. Workaround is to change the language to 'en' and it just works. Is this a bug or intended?
NeoGenesisX is offline   Reply With Quote
Old 06-21-2024, 12:34 AM   #11
geek1011
Wizard
geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.
 
Posts: 2,792
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
More new features:
  • Support for Thai fonts.
  • Option to disable page turn animation.
geek1011 is offline   Reply With Quote
Old 09-11-2024, 05:10 PM   #12
GreyFox
Militaires Sans Frontière
GreyFox began at the beginning.
 
GreyFox's Avatar
 
Posts: 21
Karma: 32
Join Date: May 2024
Device: PocketBook Era Color
Would it be possible to add reading stats to Lithium? MoonReader has the stats I want but I can't sort by series and it's still meh on eink screens.
GreyFox is offline   Reply With Quote
Old 10-18-2024, 11:57 AM   #13
OllyBe
Junior Member
OllyBe began at the beginning.
 
OllyBe's Avatar
 
Posts: 2
Karma: 10
Join Date: Oct 2024
Device: Amazon Kindle
Quote:
Originally Posted by GreyFox
Would it be possible to add reading stats to Lithium? MoonReader has the stats I want but I can't sort by series and it's still meh on eink screens.
Lithium doesn't currently have built-in support for detailed reading stats or series sorting

Last edited by OllyBe; 10-18-2024 at 11:59 AM.
OllyBe is offline   Reply With Quote
Old 10-20-2024, 02:30 PM   #14
geek1011
Wizard
geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.
 
Posts: 2,792
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
Quote:
Originally Posted by OllyBe View Post
Lithium doesn't currently have built-in support for detailed reading stats or series sorting
My patches add series metadata, series drawer items, and series sort.

I'm not planning to add reading stats though.
geek1011 is offline   Reply With Quote
Reply

Tags
android, epub, patch, patches, patching

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Lithium reader, can't get it to centre headings bookman156 Android Devices 24 08-24-2022 07:48 AM
Android devices. Built in e-reader vs. e-reader app. Your preferences? norweger Android Devices 19 11-10-2019 12:12 PM
[Android App] Default reader app selection? Mousebumples Devices 12 11-13-2012 01:12 PM
ePub and Mobi app for Android Kumabjorn Android Devices 8 08-27-2012 06:47 AM
Sony Reader Android App/ Nook Android App Quelle Android Developer's Corner 3 11-12-2011 12:31 AM


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


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