CBZ Reader

A powerful and fast native CBZ (Comic Book Archive) reader for Obsidian. Read your favorite mangas, comics, and graphic novels directly inside your Obsidian vault with a beautifully crafted, high-performance interface.

✨ Features

1. Native CBZ Support

Seamlessly open and read .cbz files directly from your Obsidian File Explorer. No need to extract files or use external applications. The plugin safely reads the ZIP structure in memory.

2. High-Performance Lazy Loading

Designed to handle massive comic books without crashing your vault. Images are lazily loaded and extracted only when they are about to enter your screen, and automatically unloaded from memory once you scroll past them. This keeps Obsidian lightning-fast and memory-efficient.

3. VS Code-Style Minimap (Smart Scrollbar)

Navigate through hundreds of pages effortlessly using the dynamic Minimap on the right side of the screen.

• Visual Previews: The minimap renders tiny, low-memory canvas thumbnails of the pages so you can see exactly where you are in the comic.
• Smart Thumb Slider: A translucent slider perfectly represents your current viewing area.
• 0-Latency Dragging: Click and drag the slider. The reading view follows your mouse instantly (1:1 pixel mapping) without any jitter or delay, acting exactly like a native scrollbar.
• Click to Jump: Click anywhere on the minimap's background track, and the reader will smoothly scroll to that exact page.
• Auto-Scrolling Track: If you have a massive 200-page comic, the minimap track intelligently scales and scrolls in the opposite direction as you drag, allowing you to traverse from page 1 to 200 in a single smooth mouse drag without running out of screen space.

4. Smooth Scrolling

Enjoy native smooth scrolling when navigating pages or clicking the minimap, providing a premium reading experience.

🚀 How to Use

1. Install and Enable: Once installed, ensure the "CBZ Reader" plugin is enabled in your Obsidian Community Plugins settings.
2. Add a Comic: Drop any .cbz file into your Obsidian Vault folder.
3. Open: Click the .cbz file from the Obsidian File Explorer.
4. Read & Navigate:
   • Scroll naturally using your mouse wheel.
   • Look at the right-side Minimap to see page previews.
   • Click & Drag the minimap slider to quickly scan through pages.
   • Click on a minimap thumbnail to instantly jump to that page.

⚙️ Installation

(Instructions for manual installation if not yet on the Community Plugin directory)

1. Download the latest release (main.js, manifest.json, and styles.css).
2. Create a folder named obsidian-plugins-cbz-reader inside your vault's .obsidian/plugins/ directory.
3. Place the downloaded files into that folder.
4. Reload Obsidian and enable the plugin in the settings.

🆕 What's New in v1.0.3

• Strict CSP Compliance: Fixed a security warning by ensuring no dynamic