✏️ Edit Page📚 Open Wiki

Documentation Home

Blacklist

Managing and understanding the blacklist in NH Reader

Blacklist

The blacklist is one of the product’s core reasons to exist. The site’s own filtering is a known weakness; the client replaces it with a global, persistent, two-layer blacklist that never leaves you stranded with an empty grid.

🚫 How it works (two layers)

  1. Server-side (query excludes). Every search query the app runs gets your blacklist’s tag exclusions appended (-tag:..., -artist:..., etc.) via buildServerExcludes(). The site itself filters — results genuinely exclude blacklisted content, and remain paginated normally.
  2. Client-side (hide/blur). The grid additionally checks every rendered gallery against the blacklist and hides (or blurs) offending cards. This catches metadata-only cases (e.g. blacklisted text that matches a title) that server-side can’t.

A master toggle switches the entire blacklist on/off instantly — if a search ever feels “too empty,” flip it off and the full unfiltered results come back.

One picture of the two-layer pipeline, including what the master toggle disables:

flowchart TD
    A[Search query] --> B{Master toggle on?}
    B -->|Off| G[Card shown normally]
    B -->|On| C[Append blacklist excludes]
    C -->|Final query| D[API search - site filters]
    D -->|Results| E[Grid checks each gallery]
    E -->|Blocked match| F[Card hidden or blurred]
    E -->|Clean| G

With the toggle off, the whole pipeline is bypassed — the grid shows whatever the site returns.

🛠️ Managing the blocklist

Blacklist in the bottom navigation bar opens the management view:

  • Top-bar quick toggle — the top bar displays a quick blacklist badge with status indicator and active count, enabling instant 1-click toggling.
  • Add a tag — from any gallery (quick-add in the detail page) or manually by name/type (artist, character, parody, group, language, category, tag).
  • Add text patterns — e.g. a series name you’re tired of. Text entries are matched against gallery text fields client-side.
  • Remove / edit entries — inline in the list.
  • Import/export — 1-click JSON export/import of your entire blacklist, accessible directly from the view and Settings Data management.

🕵️ Privacy & where it lives

  • Blacklist entries persist in database.sqlite via the SQLite-backed cache. They never leave your device except as tag-excludes rewritten into a query sent to nhentai.net — the site never sees a “blacklist”, only normal exclude tokens.
  • There is no server-side “blacklist account” unless you also use the optional account / API key account-sync feature (fetch_account_blacklist / update_account_blacklist).
  • When syncing with nhentai.net, the app sends resolved numeric tag IDs directly to POST /api/v2/blacklist, keeping the blacklist strictly isolated from profile metadata, usernames, and favorite tags.

🖼️ Behavior in grids

State Grid behavior
Blacklist on, hidden mode Matching cards are removed entirely — the grid stays clean.
Blacklist on, blur mode Cards remain but are blurred; hover reveals them (nuisance-free).
Blacklist off (toggle) No filtering at all — full unfiltered results.
Direct-link galleries Blacklisting never blocks a gallery you opened directly (detail/reader stay accessible by design) — it governs discovery lists.

⚠️ Edge cases

  • Rare/legacy galleries whose tags diverge from the site metadata still get caught by the client-side text/title matcher.
  • The site has no stable “popularity” sort field — blacklist excludes are query-based and do not affect the available sort orders.
  • If a blacklisted tag is present on a gallery you made a direct link to, the detail page is still accessible by design (see the “Explicitly Not Bugs” blacklist entry in the org bug ledger).

🏗️ Source

  • Store: src/lib/stores/blacklist.svelte.ts
  • Server-side exclude builder: buildServerExcludes() (same module)
  • Tauri commands: fetch_account_blacklist, update_account_blacklist

📚 Documentation Index

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

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