• EPUB Reader Browser Extension

A powerful browser extension for reading EPUB books directly in your browser with a beautiful library management system.

• Seamless Reading: Read EPUB books with a clean, distraction-free interface
• Smart Navigation: Easy switching between the library and the reader
• Table of Contents: Quick navigation through chapters and sections
• Zoom Controls: Adjust view widths for comfortable reading
• Font Controls: Adjust text size for comfortable reading
• Responsive Design: Works great on desktop and mobile devices
• Epub URL Intercepts: toggle on and off to open epub books automatically from URLs
• Progress Tracking: Through percentage

• Drag & Drop: Drop EPUB files onto the reader to open immediately and add to the library

╭────────────────────────────╮
│        USER ACTION         │
│  Click Extension Icon      │
╰────────────┬───────────────╯
             │ Opens reader page.
             │
             ▼
╭────────────────────────────╮
│        USER OPTIONS        │
│  (drag-drop / open EPUB)   │
╰────────────┬───────────────╯
             │
             ▼
╭────────────────────────────╮
│         BROWSER            │
│ Fetch EPUB → detect MIME   │
│ (application/epub+zip)     │
╰────────────┬───────────────╯
             │
             ▼
╭────────────────────────────╮
│  EXT BACKGROUND SCRIPT     │
│ webRequest.onHeadersReceived│
│ → detects EPUB MIME or .epub│
│ → redirects tab             │
│     ↓                       │
│ reader.html?file=<url>      │
╰────────────┬───────────────╯
             │
             ▼
╭────────────────────────────╮
│       READER.HTML          │
│ uses renders or fetches    │
│ the .epub via URL          │
│ displays in tab like PDF   │
│ See reading progress %     │
╰────────────────────────────╯

• Vue 3: Modern reactive framework for UI
• jszip.js: EPUB parsing and rendering
• CSS3 & SCSS: For great styling
• Vite: Fast build tool and development server
• Manifest V3: Latest Chrome extension API

# Install dependencies
pnpm install

# Development mode
pnpm run dev

# Build for Chrome
pnpm run build:chrome

# Build for Firefox
pnpm run build:firefox

# Build all
pnpm run build

The extension automatically intercepts EPUB files anywhere in your browser, just like how browsers handle PDFs:

1. Click EPUB Links: Click any .epub link on a website → Opens immediately in reader
2. Navigate to EPUB URLs: Type or paste an EPUB URL → Opens automatically
3. Drag & Drop: Drag an EPUB file to any browser tab → Opens and starts reading
4. Drag & Drop option 2: Drag drop an EPUB file onto a browser icon → Opens and starts reading

How it works: The extension uses declarativeNetRequest to detect:

• URLs ending in .epub
• Content with MIME type application/epub+zip or application/epub

When detected, it redirects to the extensions reader page, where you can read the document.

• Header toolbar with navigation controls
• Sidebar with table of contents
• Main reading area with EPUB content
• Zoom controls for text size

• Chrome/Edge: Full support
• Firefox: Full support
• Other Chromium-based browsers: Should work with the Chrome build

• Epub book library
• Download status: This shows the progress of your download
• What you thought was but is not while using the extension