azu / mu-epub-reader

Epub viewer on Electron that support text translation.

mu-epub-reader

Epub viewer on Electron.

This application is forked of futurepress/epubjs-reader: Epub.js Reader.

Features

• Standalone Electron app
• Integrate with Google Translation
• Shortcuts:
  • ←: Prev Page
  • →: Next Page
  • j or Space: Scroll down
  • k or Shift+Space: Scroll up
  • Cmd+o: Open file
  • Cmd+^: Increase font size
  • Cmd+-: Decrease font size
  • Cmd+0: Reset font size
• One column mode: continuous scroll like PDF
• Open file with arguments

Quote from https://book.systemsapproach.org/

Usage

1. Click File > Open File
2. Select epub file
3. View epub

or

1. Open epub file with mu-epub-reader
2. View epub

Installation

Electron Version:

Download app and Install it.

• Download binary from Latest Release

⚠️ This app is not signed. So, it will appear warning about un-signed app.

Web Version:

• https://mu-epub-reader.netlify.app/?bookPath=https://mu-epub-reader.netlify.app/example/childrens-literature.epub
  • ⚠️ Require CORS setting for each epub files
  • 📝 Source: https://github.com/IDPF/epub3-samples/tree/master/30/childrens-literature/EPUB

Development

Build electron app

yarn install
yarn run dist
# output .app to dist/

Load reader/override.js or <AppData>/mu-epub-viewer/override.js if exists.

- macOS: ~/Library/Application Support/mu-epub-viewer/override.js

1. Put custom logic script to reader/override.js
2. Restart app
3. mu-epub-reader preload reader/override.js in renderer process.

override.js example: modify request url

const origOpen = XMLHttpRequest.prototype.open;
XMLHttpRequest.prototype.open = function (...args) {
    const originalURL = args[1];
    const url = new URL(originalURL);
    /// hack something...
    args[1] = url.toString();
    origOpen.apply(this, args);
};

Release

npm version patch
git push --tags && git push

Related

• azu/mu-pdf-viewer: PDF viewer on electron.
  • PDF Viewer
• Epub.js library

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

License

MIT

mu-epub-reader's Issues

Can not open link by CSP

Original and translation side by side

Hi, how hard is to implement this?

It would be amazing for learning a language.

How to Zoom?

I want increase the text size, but I don't found any option.

--edit, i'm idiot, in the window menu

Uncaught (in promise) Error: No Section Found

epub.js:10023 Uncaught (in promise) Error: No Section Found
    at rendition_Rendition._display (epub.js:10023)
    at Queue.dequeue (epub.js:4620)
    at epub.js:4665

I can not jump from TOC in some book.
It is a bug that is epubjs or mu-epub-reader.

Support for MOBI/DjVU?

There are other ebook standards out there that are used by many library archives, notably MOBIpocket and DjVU. It would be good to see a cross-platform too to support those forms of books as well.