rclone-jav

Brave extension that extracts JAV IDs from the active page and checks them against your local rc-jav library via a native-messaging Python host.

Setup: see INSTALL.md. This file documents how it works once installed.

Architecture

Brave tab title (e.g. "MILK-257")
  ─► content/background script extracts ID
  ─► chrome.runtime.connectNative("com.rcjav.host")
  ─► rcjav-host.bat  →  rcjav-host.py
  ─► python rc-jav.py --search MILK-257 --basic --no-color
  ─► result back through the port
  ─► popup / notification / badge

Long-lived port: Brave keeps the host process alive while the connection is open, so subsequent lookups don't pay Python startup cost.

Triggers (all available, enable any combination in Options)

Trigger	Behavior
Auto-check every page load	Fires chrome.tabs.onUpdated. Badge shows hit count or ? when no JAV ID detected. Noisy.
Auto-check on known JAV sites	Same as above but gated by host patterns (e.g. *.javdb.com).
Toolbar icon popup	Click the icon → popup can run a check on the active tab. The Scan Behavior toggle gates popup auto-check.
Right-click context menu	"rclone-jav: check this page". Shows a desktop notification.
Keyboard shortcut (Alt+J)	Rebind at brave://extensions/shortcuts.

Enable them all to compare — they don't conflict.

ID extraction

Uses site adapters, URL text, and the page title plus ID normalizers. Common title forms include:

• MILK-257 → MILK-257
• MILK257 → MILK-257
• Some site - MILK-257 [4K] → MILK-257

Search behavior

By default the extension passes --quick to rc-jav (single-ID live rclone lsjson --include, ~1–2s, fresh data, no cache). Uncheck Use --quick mode in options to use the cache (faster on warm cache, may be stale).

Files

manifest.json             MV3 manifest
background.js             service worker, native-messaging port, triggers
content.js                page extraction, element picker, and in-page overlays
popup.html / .css / .js   click-the-icon UI
options.html / .js        trigger toggles + known-site patterns
icons/                    extension icons
host/
  rcjav-host.py           native messaging host (length-prefixed JSON)
  rcjav-host.bat          shim so the manifest path is stable
  install-host.ps1        writes the manifest into Brave's NM dir
  register-host.bat       prompts for ID, calls install-host.ps1
  com.rcjav.host.json     generated by install-host.ps1 (UTF-8 no BOM)
  logs/                   host logs and delete audit log
  state/                  scan progress state
docs/
  INSTALL.md              setup guide
  README.md               this file
  EXTENSION_ID.md         extension ID stability notes

Security

• The host manifest's allowed_origins is pinned to your extension ID. Only that extension can connect.
• No network ports opened.
• Host only spawns python rc-jav.py …; no shell, no arbitrary code execution.

Troubleshooting

Quick reference — full troubleshooting in INSTALL.md.

• Badge ? → no JAV ID in title.
• Badge ! → host error. Read host\logs\rcjav-host-stderr.log.
• "host unreachable" → re-run install-host.ps1, fully restart Brave.