ePub viewer for Android based OS
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
oppen 7781123519 update build script 3 months ago
.idea ::: 3 months ago
app version bump 3 months ago
assets ::: 3 months ago
gradle/wrapper ::: 3 months ago
.gitignore ::: 3 months ago
LICENSE ::: 3 months ago
README.md remove attribution for old icon, long gone 3 months ago
build.gradle ::: 3 months ago
download.gmi update build script 3 months ago
filename ::: 3 months ago
gradle.properties ::: 3 months ago
gradlew ::: 3 months ago
gradlew.bat ::: 3 months ago
od.sh update build script 3 months ago
settings.gradle ::: 3 months ago

README.md

ÖppenBók

ePub viewer for Android based OS

  • Goals: a casual ePub reader with a solid UX, opens a book, remembers where you're up to - nothing else.
  • Non Goals: everything else, no highlighting, in-app dictionary, annotation etc.

I want a good reading experience for one book at a time, to pick up where I left off, that's it.

Status

Development has just begun, this is not fit for use yet.

ToDo:

  • Storage Access Framework .ePub import - DONE
  • Unzip the imported file and cache locally - DONE
  • Find index file and extract xhtml file array - DONE
  • Process each file: break down into screen sized pages - DONE
  • Store pages locally (in Room DB?) - DONE
  • purge cache directory - DONE
  • build UI (the fun bit) - DONE
  • Bonus: Inline images - TODO

Parsing

ePub files are just a series of xHtml files with CSS, this makes parsing books into mobile screen friendly chunks very tricky. This project takes each page, splits it into paragraph strings then adds them in turn until the height is greater than the available window height. The paragraph that overflows is then broken up into words which are added one by one to fill up the gap at the bottom. Any remaining words are then joined to a new line which is inserted at the start of the array and passed to process the next screen.

View ChapterSplicerImpl.kt

Parsing Diagram

Reference

Attribution

Book loading animation is by Филипп Чуланов (Philip Chulanov) from LottieFiles

Licence

European Union Public Licence v. 1.2

The page turning animation code is in the page_turn package and is derived from PlayLikeCurl, a Java library from 2016 by Karan Kalsi which was released under the MIT License: github.com/karankalsi/PlayLikeCurl