Shamela EPUB Exporter

A tool to download books from the Shamela Library into EPUB files locally. Available as browser extension, desktop app, and Android app.

Downloads

Disclaimer:

• This software is freeware and open source and is only intended for personal or educational use.

Features

• Creates an EPUB3 RTL standard book.
• Bulk Downloading: Queue multiple books at once.
• Automatically adds a page for book information.
• Table of contents with nested chapters (or a flat option).
• Adds volume and page number footer per page.
• Sanitizes book HTML and converts inline colors to CSS classes.
• Optional footnote (hamesh) popup conversion for easier navigation.
• Smart Background Processing: Handles tab limits and notifies you when finished.
• Local BOK Converter: Open local .bok files directly.
• Analyze books/volumes and preview content before export.
• Export .bok content to EPUB, PDF, or HTML.
• Batch convert multiple BOK books in one run.
• BOK EPUB exports are EPUBCheck-safe and parity-stable.
• Desktop app save dialog includes ZIP filter support.

Installation

Development build (unpacked)

mise x pnpm -- pnpm run dev

Load the extension from:

.output/chrome-mv3-dev

Production build (unpacked)

mise x pnpm -- pnpm run build

Load the extension from:

.output/chrome-mv3

Usage

1. Open the extension popup.
2. Paste book URLs or IDs (one per line).
3. Click بدء (Start).
4. The extension will queue and process them one by one.
5. You'll receive a system notification when each download completes.

Development

This project uses mise for tool versions and environment setup.

1. Install mise.
2. Run mise install in the repo root.
3. Start the dev server:

mise x pnpm -- pnpm run dev

Technology Stack

• TypeScript + Svelte 5 (UI)
• WXT + Vite (extension tooling)
• Tailwind CSS (styles)
• JSZip (EPUB packaging)
• Wuchale (i18n)

Acknowledgements

This project relies on several open-source tools:

• Svelte
• WXT
• Vite
• Tailwind CSS
• JSZip
• Wuchale

Privacy

See PRIVACY.md.