Scan Behavior

Choose when rclone-jav checks the current page.

Scope

Auto-check every page load Runs on every site. Badge shows "?" when no JAV ID detected. Auto-check on known JAV sites Only fires on host patterns listed below.

Known site patterns

Comma- or newline-separated. Bare domain matches site + any subdomain (clearjav.com covers www.clearjav.com).

Navigation types

Full page loads Runs when the browser reports the page has finished loading. SPA and history URL changes Runs when a site changes URL without a full reload, including browser back/forward on some sites.

Manual controls

Toolbar icon popup Click the rclone-jav icon to run a check on the active tab. Right-click context menu Keyboard shortcut (Alt+J) Rebind at brave://extensions/shortcuts.

Saved.

Overlays

In-page toast notifications after auto-trigger scans.

Show overlay on match Hover to pause countdown. Auto-check only.

Position

Top-Left Top-Right Bottom-Left Bottom-Right

Duration (sec)

Subtle glow

Blur (soft) 10 px Spread (size) 0 px Opacity 0.35

Preview — top-right

✓ IPZZ-860 — 1 hit(s)

IPZZ-860 [4K].mkv

Path: cq:JAV/ClearJAV/...

TARGET 5.93 GiB

Show overlay on no match Off by default. Auto-check only.

Position

Top-Left Top-Right Bottom-Left Bottom-Right

Duration (sec)

Subtle glow

Blur (soft) 10 px Spread (size) 0 px Opacity 0.35

Preview — top-right

✗ START-489 — NOT IN LIBRARY

Scanned: cq:JAV

Saved.

Site Extraction

For sites where the JAV ID isn't in the page title, point at a DOM element. Selector runs document.querySelector and extracts textContent.

Host pattern	CSS selector(s)

Built-in presets

clearjav.com → div.meta-chip > h3.meta-chip__value

Saved.

Matching Rules

Normalize odd IDs and teach rc-jav how multipart filename suffixes should stay distinct.

Built-in ID rules

FC2-?PPV-?(\d{4,}) → FC2-PPV-$1 — handles FC2PPV4903171, FC2-PPV4903171, FC2-PPV-4903171

FC2-(\d{4,}) → FC2-PPV-$1 — handles bare site labels like FC2-1841460

_A / _B multipart suffixes are distinct parts in rc-jav duplicate/cache ID detection.

Test ID extraction

Paste a page title, DOM text, URL fragment, or filename. Uses the current custom normalizer rows below plus built-in extraction rules.

Custom ID normalizers

Pattern (regex)	Replacement

Part detectors

Built-in and custom Python regexes run against the filename stem. Capture group 1 must be the part number or a single part letter. Built-ins are shown here so you can see what is already covered before adding a custom detector.

Built in

Custom

Host searches and cache rebuilds receive these saved rules. Direct CLI use can store the same list as part_patterns in config.json or pass repeatable --part-pattern.

Saved.

Cache & Scans

Choose lookup mode, inspect cache state, and run cache rebuild jobs.

Lookup mode

Quick mode bypasses cache and uses rclone --include directly — fastest for single-ID lookups. ~1–2s per call. Disable to use the cache (faster on warm cache, requires --scan to keep fresh).

Use --quick mode (live rclone lookup, no cache)

Cache status

Inspect the current cache.json remotes, scan times, file counts, and skipped filename samples.

Stale after hours Used for cache warnings in the extension. Freshness does not change search results.

Cache rebuild

Refresh the cache from the configured scan roots. Incremental rebuilds only ask rclone for recently changed files.

Scan job

Follow the current or last cache scan job and clear old job history after it is no longer useful.

Saved.

Duplicate Review

Review cached duplicate groups and tune the KEEP ranking that picks the surviving file.

Duplicate review

Review cached duplicate groups before acting. Keep/delete suggestions follow rc-jav rules; catalog rows remain reference-only.

Review opens in a focused window so large duplicate groups do not stretch this page.

Keep ranking

Controls how rc-jav picks the KEEP file when duplicates are found. Changes take effect immediately — no rescan required.

How it works: Video files in VIP folders win first. .ts files rank below other video containers. After that, files within size tolerance of the largest are treated as equal-size, then ranked by format preference. Remaining ties broken by resolution tag, then filename length. With tolerance = 0 (default), size always decides first.

VIP folders

drag to reorder · top wins first · ClearJAV is the default direct-rip VIP folder

Size tolerance MiB — files within this range of the largest are considered equal-size

Format preference

drag to reorder · top = highest priority

Tie-breaks Prefer file with resolution tag [1080p]

Prefer longer filename (more metadata)

Library Issues

Find cache-only filename hygiene issues. Rename canonical-name fixes now; review missing resolution tags for later processing.

Library issues

Find files with non-canonical names and missing final resolution tags like BLK-474.mp4. Rename suggestions are computed from cache — no network required.

Setup

Script location and settings backup. Native host registration + extension ID live in Diagnostics.

rc-jav script path

Folder containing rc-jav.py, or full file path. Leave blank for the host default.

Alerts

Send a Discord webhook on native-host errors (disconnects, timeouts, exceptions). Rate-limited to 1 alert per 10 minutes — same as the Windows notification. Leave URL blank to disable.

Both paths fire on real errors — test each to confirm Discord receives them.

PC label (optional, embedded in alerts so you can tell which PC fired)

Backup before moving

Extension settings and native messaging permissions are tied to the extension ID. Export before moving, reloading, or reinstalling. See docs/EXTENSION_ID.md for the stable-ID workflow.

Saved.

Library Profiles

Named source and target remote sets for switching libraries from the popup.

Saved.

Diagnostics

Check setup health, runtime dependencies, native host registration, and recent search behavior.

Setup health

Quick read on current lookup mode, pause state, active profile, cache freshness, and native host registration.

Runtime

Verifies Python, rclone, rc-jav, config, cache, and WinCatalog files.

Native messaging log

Last 200 RPC calls to the native host — action, latency, response size, and any error/disconnect reason. Use this when "Error when communicating with the native messaging host" shows up in Check Library or the popup.

errors only

Native host registration

Checks the manifest, extension ID permission, and Windows registry entries used by Brave/Chrome native messaging.

Extension ID: —

Debug Tools

Standalone diagnostic surfaces moved out of the main Diagnostics pane. Search troubleshooting bench + recent search/page-check activity log. Not part of the maintenance workflow.

Search troubleshooting

Paste an ID, page title, DOM text, URL fragment, or filename. The bench extracts an ID, then compares LIVE and CACHE lookup paths for that ID under the active library profile.

Recent activity

Short local history of page checks and popup searches. Stores the extracted ID, outcome, page context, mode, and timing summary. Search-trigger events only — deletion actions are not recorded here.

Deletion

When enabled, the popup adds a delete button for matched files. Every delete still requires typing the exact filename to confirm.

Enable

Enable file deletion from popup

Mode

Move To Trash Permanent Delete

Trash mode runs rclone moveto into the trash dir + YYYY-MM-DD/ subdir. Reversible until cleared. Permanent runs rclone deletefile — cloud Drives may still keep a 30-day recycle bin.

Trash directory

Saved.