What is NH Reader?

NH Reader is a lightweight, modern, cross-platform client for the adult manga archive nhentai.net. It is not a website clone: it ships a custom UI, Mihon-inspired thumb-friendly navigation, Dynamic UI Scaling, and a materially better search/filter and global blacklist experience than the site can offer, backed by the site’s own public API and imported metadata (galleries, tags, languages, categories, artists, characters, parodies).

• 👋 Browse & discover — New (home), Popular, tag pages, everything lazy-loaded with image-proxy caching.
• 📐 Dynamic UI Scaling — window-adaptive column calculation and row fitting so there is never an empty card space.
• 📱 Mihon-style floating bottom navigation — thumb-friendly, floating bottom bar with a 4px corner radius and elevated backdrop blur, optimized for touch screens and desktop displays alike.
• 🪟 Native window chrome & in-app top bar — native OS decorations with window titlebar, coupled with an in-app top bar for branding, quick search, blacklist badge, and account controls.
• 🔍 Search that actually works — a filter drawer (text, language, category, per-type tag include/exclude, page ranges, six sorts) compiled into native nhentai query syntax, so you can cut a giant haystack down to exactly what you want.
• 🛡️ A blacklist you can trust — global, persistent, applied server-side (-tag: excludes) and client-side (hide/blur), with a master toggle. It never silently breaks the grid.
• 🔒 Private by default & versatile account sync — no accounts required, no servers, no telemetry. Favorites, history, blacklist, and settings are stored locally in an ambiguous database.sqlite database. An optional account sign-in modal supports both official API Keys (bypasses Cloudflare CAPTCHAs) and direct credentials for live profile rendering and server-synced blacklists.
• 📦 Native packaging — platform-native NSIS and WiX MSI installers on Windows (supporting both per-user and per-machine scopes), DMG on macOS, deb/AppImage on Linux, APK on Android, and iOS archives/IPAs.
• 🌐 Speaks your language — the interface defaults to your system language and can be changed in Settings. Complete 100% UI localization with automatic fallback to your system locale and drop-in language packs for community contributions. See Localization.
• ⚡ Official archive downloads & background services — official pre-built gallery archives via POST /api/v2/galleries/{id}/download (ZIP/CBZ with streaming progress), background image prefetch, LRU cache eviction down to 85% of storage budget, SQLite VACUUM compaction, account sync, and periodic Popular refreshes.

18+ only. This software is for adults. You confirm you are of legal age to view adult content. See the Terms of Service.

📦 Platform support

[!WARNING] Platform Testing Notice (Android, macOS & iOS): The maintainer does not possess physical macOS or Android test hardware. While Tauri 2 build toolchains are configured, these builds are community-supported and untested. iOS builds require macOS, Xcode, and valid Apple signing credentials.

🧭 Getting around

• Getting Started — first run, API key, what to expect.
• Installation & Maintenance — installing, updating, uninstalling, portable mode, and mobile sideloading.
• Search & Filters — the query engine, full reference.
• Blacklist — the blacklist, in depth.
• Reader & Galleries — detail pages and the reader.
• Localization — changing the app language, and adding a new one.
• Architecture — how the pieces fit together.

💡 Quick facts

• Stack: Tauri 2 (Rust reqwest) backend + SvelteKit static SPA (Svelte 5 runes, strict TypeScript) + plain CSS design tokens (no UI framework).
• Persistence: SQLite-backed KV cache (src/lib/cache.ts → database.sqlite) for favorites, history, blacklist, settings and the API key, plus an on-disk image cache (cache/images) and a downloads/ folder.
• Rebranded & Decoupled: Product is NH Reader — NH Reader.exe, window title “NH Reader”, identifier net.nh-reader.client, database database.sqlite.

🔗 Links

• Repository
• Releases
• Changelog
• Privacy
• Terms
• Security
• nhentai.net — the site this client talks to.

📚 Documentation Index

• Core: Home · Getting Started · Installation & Maintenance
• App Features: Search & Filters · Blacklist · Favorites & History · Reader & Galleries · Settings & API Key · Localization
• Architecture & Development: Architecture · Backend (Rust) · Frontend (SvelteKit) · Packaging & Bundling · Development & Contributing
• Reference: Security · Privacy · Troubleshooting · FAQ

NH Reader — a lightweight, modern, cross-platform client for nhentai.net.

Documentation Home · Repository · Releases · Security · Privacy · TOS · License