release: v1.2.2

### Added
- Help link in the options page, pointing at the monsender documentation.
### Fixed
- Right-click sends the post, not the raw image file, when monloader's site list is unreachable.
- Pairing prompt now points at monloader's monsender settings, where you approve the request.

Author: leqwin

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [v1.2.2] - 2026-07-21
+### Added
+- Help link in the options page, pointing at the monsender documentation.
+### Fixed
+- Right-click sends the post, not the raw image file, when monloader's site list is unreachable.
+- Pairing prompt now points at monloader's monsender settings, where you approve the request.
+
 ## [v1.2.1] - 2026-07-04
 ### Added
 - Popup button to pause and resume monloader's downloads.

README.md

@@ -1,6 +1,6 @@
 # monsender
 
-A small firefox or chrome extension for [monloader](https://github.com/leqwin/monloader). 
+A small firefox or chrome extension for [monloader](https://github.com/monbooru/monloader). 
 It sends the page you are looking at, a right-clicked image or video, or images you pick from a page scan to your monloader download queue, which pushes them into monbooru.
 
 ## Features
@@ -17,27 +17,32 @@ monsender is a companion browser extension for monloader. It hands the page you'
 ```mermaid
 flowchart LR
     web["- Any booru or gallery supported by gallery-dl<br/>- Direct image URL"]
+    ptr["Hydrus<br/>Public Tag Repository"]
     sender(["<b>monsender</b><br/>browser extension"])
     loader["<b>monloader</b><br/>downloader"]
     booru["<b>monbooru</b><br/>Your self-hosted booru"]
 
     web -->|browse| sender
-    sender -->|REST API| loader
-    web -.->|paste URL| loader
-    loader -->|REST API| booru
+    sender -->|send URL| loader
+    web -->|paste URL| loader
+    loader -->|push images, tags, source| booru
+
+    booru -.->|lookup by hash| loader
+    loader -.->|reverse lookup: md5 + similarity| web
+    ptr <-.->|"sync: sha256 tags + aliases + implications<br/>contribute back (planned)"| loader
 
     classDef hub  fill:#5c6bc0,stroke:#9fa8da,stroke-width:3px,color:#ffffff;
     classDef tool fill:#16161c,stroke:#5c6bc0,stroke-width:1.5px,color:#c8c8c8;
     classDef src  fill:#16161c,stroke:#8888a0,stroke-width:1px,color:#8888a0;
 
     class sender hub;
     class loader,booru tool;
-    class web src;
+    class web,ptr src;
 ```
 
 - **monsender** : this application; sends the URL of the page you're currently browsing to monloader.
-- **[monloader](https://github.com/leqwin/monloader)** : downloader; fetches files and per-post metadata (via gallery-dl) and pushes them into a monbooru gallery over the REST API.
-- **[monbooru](https://github.com/leqwin/monbooru)** : self-hosted booru; organizes, tags, and serves your collection.
+- **[monloader](https://github.com/monbooru/monloader)** : downloader; fetches files and per-post metadata (via gallery-dl) and pushes them into a monbooru gallery over the REST API; also answers monbooru's reverse lookups (boorus, IQDB/SauceNAO, Hydrus PTR) and source refetches.
+- **[monbooru](https://github.com/monbooru/monbooru)** : self-hosted booru; organizes, tags, and serves your collection.
 
 ## Permissions
 
@@ -50,7 +55,9 @@ runtime when you save settings.
 
 <a href="https://addons.mozilla.org/en-US/firefox/addon/monsender/"><img alt="Get the Add-on" height="48" src="https://blog.mozilla.org/addons/files/2020/04/get-the-addon-fx-apr-2020.svg"></a>
 
-Open the extension's options and set your monloader URL and token.
+Open the extension's options, set your monloader URL, and click **connect to monloader**; approve the pairing request in monloader under **Settings -> monsender** (needs monloader v1.2.0 or newer).
+
+See the [monsender documentation](https://monbooru.github.io/mondocs/addons/monsender/index.html) for help.
 
 ## Build
 

REPOSITORY.md

@@ -1 +1 @@
-https://github.com/leqwin/monsender
+https://github.com/monbooru/monsender

VERSION.md

@@ -1 +1 @@
-v1.2.1
+v1.2.2

package.json

@@ -1,6 +1,6 @@
 {
   "name": "monsender",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "Send the current page or its images to your monloader download queue.",
   "private": true,
   "type": "commonjs",
@@ -24,6 +24,6 @@
   "license": "AGPL-3.0-or-later",
   "repository": {
     "type": "git",
-    "url": "https://github.com/leqwin/monsender"
+    "url": "https://github.com/monbooru/monsender"
   }
 }

src/bg.js

@@ -126,14 +126,18 @@ function setupMenus() {
 browser.runtime.onInstalled.addListener(setupMenus);
 browser.runtime.onStartup.addListener(setupMenus);
 
-// A direct-file link classifies as 'image', not 'supported', so it loses to the
-// page - the raw file never wins over the post URL that would carry tags. When
-// monloader is unset or the sites list is undecidable, fall through to the
-// pointed file, which is always sendable.
+// Prefer a linked post, then the page, over the raw file, which carries no tags.
+// A file link ('image') and a positively unlisted host ('unknown') lose to the
+// file; a 'blind' result (no sites list) does not - if the page is a booru its
+// file is likely an unfetchable CDN link, and if not, monloader judges it. With
+// monloader unset or nothing better pointed at, the raw file.
 async function resolveMenuTarget(cfg, info) {
   if (cfg.baseUrl) {
-    if (info.linkUrl && (await ML.sites.sendKind(cfg, info.linkUrl)) === 'supported') return info.linkUrl;
-    if (info.pageUrl && (await ML.sites.sendKind(cfg, info.pageUrl)) === 'supported') return info.pageUrl;
+    for (const cand of [info.linkUrl, info.pageUrl]) {
+      if (!cand) continue;
+      const kind = await ML.sites.sendKind(cfg, cand);
+      if (kind === 'supported' || kind === 'blind') return cand;
+    }
   }
   return info.srcUrl;
 }

src/lib/sites.js

@@ -45,7 +45,9 @@
     const r = await api.listSites(cfg);
     const data = (r && r.ok && r.data) || {};
     const sites = Array.isArray(data) ? data : (data.sites || []);
-    listCache = { baseUrl, at: now, sites };
+    // A failed or empty fetch is not cached, so a transient miss does not stick
+    // for the TTL and blind every send in that window.
+    if (sites.length) listCache = { baseUrl, at: now, sites };
     return sites;
   }
 
@@ -54,17 +56,17 @@
     return matchHost(await fetchSites(cfg), url);
   }
 
-  // Classify a URL for the popup send gate: 'image' (a direct file, no tags),
+  // Classify a URL for the send gate: 'image' (a direct file, no tags),
   // 'supported' (an example host matched, so tags come), 'unsupported' (no host
-  // at all - nothing to enqueue), or 'unknown'. A host that matches no example
-  // is 'unknown', not 'unsupported': an extractor can cover hosts its single
-  // example does not name, so support is undecidable - leave it to the job
-  // outcome rather than block on a guess.
+  // at all - nothing to enqueue), 'blind' (no sites list to consult), or
+  // 'unknown' (a fetched list that just does not name the host). 'unknown' and
+  // 'blind' are both undecidable, but callers treat them apart: an unlisted host
+  // loses to the raw file, a blind one does not.
   async function sendKind(cfg, url) {
     if (urls.isImageUrl(url)) return 'image';
     if (!hostOf(url)) return 'unsupported';
     const list = await fetchSites(cfg);
-    if (!list.length) return 'unknown';
+    if (!list.length) return 'blind';
     return matchHost(list, url) ? 'supported' : 'unknown';
   }
 

src/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "monsender",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "Send the current page or its images to your monloader download queue.",
   "permissions": ["activeTab", "scripting", "storage", "contextMenus"],
   "optional_host_permissions": ["http://*/*", "https://*/*"],

src/options/options.html

@@ -8,12 +8,14 @@
     body { max-width: 680px; margin: 0 auto; padding: 16px; }
     header { display: flex; align-items: center; gap: 8px; margin-bottom: 16px; }
     header strong { font-size: 16px; font-weight: bold; letter-spacing: 2px; text-transform: uppercase; }
+    header .help-link { margin-left: auto; }
   </style>
 </head>
 <body>
   <header>
     <img src="../assets/logo.png" class="logo" alt="" />
     <strong>monsender</strong><span class="muted small">settings</span>
+    <a class="muted small help-link" href="https://monbooru.github.io/mondocs/addons/monsender/index.html" target="_blank" rel="noopener">help</a>
   </header>
 
   <div class="section">

src/options/options.js

@@ -109,7 +109,7 @@
       setFlash((r.data && r.data.error) || (r.networkError ? 'monloader unreachable' : 'pairing request failed'), 'flash-err');
       return;
     }
-    setFlash('approve the request in monloader (settings → authentication), waiting...', 'flash-warn');
+    setFlash('approve the request in monloader (settings -> monsender), waiting...', 'flash-warn');
     const id = r.data.request_id;
     for (let i = 0; i < 60; i++) {
       await sleep(1500);