web EPUB reader using EPUB.js, Bootstrap, and Calibre.

Andrew Dolgov 76760cffe0 update password if adding but user exists 2 weeks ago
css de703d45c1 switch to a different library for swipe events 1 month ago
db 05b286c2b5 add db/ 1 year ago
img 86d02c4cba update hires favicon 1 year ago
js 80910996b0 react to device orientation change to preserve lastread position 1 month ago
lib fd5e4afe54 Revert "exp workaround: enable swipes after first touch event" 1 month ago
sessions e12535e601 add .empty back 9 months ago
themes cf4f0ca070 update plan9 theme 2 months ago
.gitignore e6db30b32f update .gitignore 9 months ago
COPYING 1acf84942d add COPYING 1 year ago
README.md 59ddd75559 screenshots -> wiki 1 month ago
backend.php 80905f7477 use expires: for covers 1 month ago
config.php-dist dfee22901d * use PDO::sqlite 5 months ago
db.php dfee22901d * use PDO::sqlite 5 months ago
index.php 68e4d8ef48 remove php_auth_user transition warning 3 weeks ago
login.php dfee22901d * use PDO::sqlite 5 months ago
logout.php 9f4927825b move to internal user management because it's impossible to implement 9 months ago
manifest.json f37c9975ee add hires favicon, add support for run-as-app on chrome 1 year ago
offline.html cfc197038f js: enable strict mode 1 month ago
read.html 80910996b0 react to device orientation change to preserve lastread position 1 month ago
schema.sql 55f2b0090a add basic favorites via a horrible hack 9 months ago
sessions.php dfee22901d * use PDO::sqlite 5 months ago
useradm.php 76760cffe0 update password if adding but user exists 2 weeks ago
worker.js fd5e4afe54 Revert "exp workaround: enable swipes after first touch event" 1 month ago

README.md

The Epube

web EPUB reader using EPUB.js, Bootstrap, and Calibre.

  • responsive design
  • has transparent offline mode via service workers
  • can optionally store files locally for later reading
  • supports word definition lookups using dictd
  • supports Chrome homescreen "app mode"
  • has several color themes

Screenshots

See here: https://git.tt-rss.org/fox/the-epube/wiki/Home

Installation

  1. Initialize scratch.db

    sqlite3 db/scratch.db < schema.sql
  2. Ensure both scratch.db and its containing folder (i.e. db/) are writable by the application, normally this means chown-ing them as www-data or whatever user your httpd is running under.

    chown www-data db/ db/scratch.db
  3. Copy config.php-dist to config.php and edit path to Calibre, etc.

  4. Setup users via useradm.php (command line)

Upgrading

When upgrading from an older Git snapshot which used HTTP Authentication:

  1. Disable HTTP Authentication in httpd configuration
  2. Reopen browser to clear HTTP auth
  3. Add two new tables to scratch.db (epube_users & epube_sessions)
  4. Add users via useradm.php (use same names as http auth, all data will be kept)

Requirements

  • PDO::sqlite
  • Calibre books directory and metadata.db

Acknowledgements

  1. Hires favicon by Flaticon - https://www.shareicon.net/business-school-material-open-book-education-leisure-reader-reading-794233
  2. Normal favicon from Silk icon pack - http://www.famfamfam.com/lab/icons/silk/

License

GNU GPL version 3.