Web Comic Reader

Modern web-based comic book reader for CBR, CBZ, and CBT files with library management and reading progress tracking.

About this fork

This fork is used to allow opening a comic book via ?url=... parameter (relative or absolute on same server), and create packages for use in other projects.

The assets/ files are available as:
* PHP composer package: mikespub/web-comic-reader, or
* NPM javascript package: @mikespub/web-comic-reader.

Features

- Modern UI
- Library Mode - Select your comics folder once, access anytime with persistent folder access
- Reading Progress - Automatically saves your last read page and scrolls to it when you reopen
- Thumbnail Previews - Auto-generated cover thumbnails for quick comic recognition
- Recently Read - Quick access to your last 5 comics with progress indicators
- Quick Read Mode - Upload and read individual files without library setup
- Client-Side Only - All processing happens in your browser, no server uploads required
- Offline Support - Works completely offline after initial load

Usage

$3

1. Click "Select Comics Folder"
2. Choose your comics folder and grant permission
3. Browse your library with thumbnails and progress tracking
4. Click any comic to read
5. Your progress is automatically saved

$3

1. Click "Quick Read"
2. Upload a single CBR/CBZ/CBT file
3. Read immediately (progress won't be saved)

Getting Started (Development)

$3

- A local web server (Python's http.server, Node's http-server, etc.)
- For Library Mode: HTTPS server setup

$3

``bash

Clone or download the repository

git clone
cd Web-Comic-Reader

Start a local server (choose one):

Python 3

python -m http.server 8000

Python 2

python -m SimpleHTTPServer 8000

Node.js http-server

npx http-server -p 8000

PHP

php -S localhost:8000
`

Visit http://localhost:8000 in your browser. Only Quick Read mode will work.

$3

To enable Library Mode with folder access, you need HTTPS:

Option 1: Using nginx-proxy (Recommended for local development)
1. Set up nginx-proxy with SSL certificates
2. Configure proxy to your local server
3. Access via https://yourdomain.test

Option 2: Using mkcert for local HTTPS
`bash


Install mkcert

macOS

brew install mkcert

Create local CA

mkcert -install

Generate certificate

mkcert localhost 127.0.0.1

Use with your server (example with http-server)

npx http-server -p 8000 -S -C localhost+1.pem -K localhost+1-key.pem
`

$3

`
├── index.html # Main HTML file
├── assets/
│ ├── css/
│ │ └── styles.css # All styles and theming
│ └── js/
│ ├── script.js # Main application logic
│ └── uncompress/
│ └── uncompress.js # Archive extraction
├── README.md
└── LICENSE
`

$3

- Reading progress is stored in localStorage (key: comic_reader_userpref)
- Folder handles are stored in IndexedDB (database: ComicReaderDB)
- Thumbnails are base64-encoded JPEG stored in localStorage
- Uses vanilla JavaScript (no jQuery required)

Requirements

- Modern browser with File System Access API support (Chrome, Edge, Opera)
- HTTPS required for Library Mode (folder access)
- For Quick Read Mode, HTTP is sufficient

Browser Compatibility

$3

✅ Fully Supported:
- Chrome/Chromium (desktop)
- Microsoft Edge (desktop)
- Opera (desktop)

❌ Not Supported:
- Safari (macOS & iOS) - Apple has not implemented this API due to privacy/security concerns
- Firefox - Partially supported behind flags, not production-ready
- All iOS browsers (Chrome, Firefox, Edge on iOS) - Use Safari's engine, inherit same limitations

📝 Note: Safari and unsupported browsers will automatically fall back to Quick Read mode only. Users can still read comics by uploading individual files, but library features and progress tracking won't be available.

Supported Formats

- .cbr - Comic Book RAR
- .cbz - Comic Book ZIP
- .cbt` - Comic Book TAR

Technical Details

- Pure client-side processing (no server required)
- Reading progress stored in localStorage
- Folder handles stored in IndexedDB
- Thumbnails generated using Canvas API
- lightGallery for image viewing with zoom and fullscreen

Credits

- Uncompress.js - Archive extraction
- lightGallery - Image gallery and viewer
- Dropzone.js - File upload handling

License

This project is licensed under the MIT License - see the LICENSE file for details.