Skip to content

Repository files navigation

MangaReader Logo
MangaReader

A browser-based reader for manga, manhwa, and comics. Runs client-side with no runtime dependencies, opening folders, images, and .cbz files, with GPU sharpening and automatic spread pairing.

Quick Start

1. GitHub Pages (Online)

Use the hosted version directly in your browser here.

2. Installed App (Offline)

Install the hosted version as an app to read offline:

  • Chromium-based browsers (Chrome, Edge, Brave…): Click the install icon in the address bar.
  • Firefox (Windows): Click "Add tab to Taskbar" in the address bar.
  • Safari (macOS): Choose File → Add to Dock.

3. From Source

git clone https://github.com/meangrinch/MangaReader.git
cd MangaReader
npm ci
npm run dev

Features

  • Formats: Open folders, loose images (JPG, PNG, WebP, AVIF, GIF, BMP), and .cbz archives by drag-and-drop or Ctrl+O
  • Chapters: Read each dropped folder or archive as a chapter, back to back in natural order
  • Modes: Switch between Paged and Strip
  • Spreads: Join split two-page spreads automatically by matching their gutters, or force them on (with offset) or off
  • Direction: Read LTR or RTL, picked up from ComicInfo.xml when present
  • Enhancement: Sharpen pages on the GPU with anti-ring Lanczos3 (Sharp) or adaptive sharpening (Extra sharp), in browsers with WebGPU
  • Navigation: Turn pages with arrow keys, Space, PgUp/PgDn, or by clicking either side, with preloading for instant page turns
  • Zoom: Zoom around the cursor with the wheel (Ctrl+wheel sets strip width in Strip mode), toggle 2× with a double-click, and drag to pan
  • Interface: Keep only the page on screen, with an auto-hiding bar, Light/Dark/System themes, and accent colors
  • Privacy: Files never leave the browser, and nothing about them is stored

Support the Project

MangaReader is open-source and free. If it enhances your reading experience, consider supporting its development!

Support on Ko-fi


License & Credits

Releases

Packages

Contributors

Languages