Skip to content

bariskisir/EpubReader

Repository files navigation

EPUB Reader

A simple full-screen client-side EPUB reader for Vercel. The app opens an EPUB URL from the query string, stores books in localStorage, and remembers the last reading position for each book.

Usage

Open a book directly:

https://epub-reader-omega.vercel.app?epub=https://github.com/bariskisir/AI-Books/raw/refs/heads/master/The_Meridian_Cycle/epub/Book_0_The_Gate_at_Kestrel_Falling.epub

The app also accepts book and epub as query parameter names:

/?book=https://example.com/book.epub
/?epub=https://example.com/book.epub

If no query parameter is provided, use the plus button to add an EPUB URL. Opening the same EPUB URL again reuses the existing saved book instead of adding a duplicate.

Use the play button in the top menu to listen to the current page with the browser Web Speech API. The reader detects the book language from the current page and nearby pages, supports Turkish and English language selection, pauses playback, and automatically advances to the next page when the current page finishes.

Speech playback depends on the browser and operating system voices installed on the device. Mobile browsers may stop Web Speech playback when the app is backgrounded or the screen is locked; the app requests Screen Wake Lock where supported to reduce interruptions while the reader stays open.

GitHub blob and raw links are normalized automatically. For example, this:

https://github.com/user/repo/blob/main/books/example.epub

is opened as:

https://raw.githubusercontent.com/user/repo/main/books/example.epub

Other EPUB hosts still need to allow browser CORS requests.

Development

npm install
npm run dev

Build

npm run build

Deploy the repository to Vercel with the default Vite settings. EPUB files must be reachable from the browser and must allow CORS requests.

About

A simple full-screen client-side EPUB reader for Vercel. The app opens an EPUB URL from the query string, stores books in localStorage, and remembers the last reading position for each book.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors