the-epube

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.