# 🦌 Network Commander — v1.0.0

**A model browser that keeps up with your library — however big it's gotten.**

If you've got hundreds (or thousands) of LoRAs, the built-in Extra Networks panel stops being a tool and starts being an apology. Network Commander replaces it with a **fast, dense, actually-searchable** browser for your checkpoints, LoRAs, and embeddings — one that stays instant whether you have 20 models or 3,000.

It reads the metadata you already have on disk (from **Civitai Helper** or the **Civitai Downloader** browser plugin) — previews, base model, trigger words, tags, hashes, CivitAI links — and makes **zero network calls** to do it. Lightweight, dependency-free, vanilla JS. Same deer, same philosophy as its siblings.

---

## ⚡ Built for big libraries

Density isn't a nice-to-have here — it's the entire reason the extension exists. So it's fast where it counts:

- **Virtualized scrolling** keeps only the on-screen cards in the DOM, so a grid of thousands scrolls like a grid of twenty. (Real-world: a 3,883-model library — 314 checkpoints, 3,483 LoRAs, 86 embeddings — indexed in well under a second on a warm cache.)

- A **full tab** with a master-detail layout: a resizable, collapsible **folder tree** on the left, a reflowing **card grid** on the right.

- A **zoom slider** to size the cards, a **grid ↔ list** toggle for compact scanning, and sorting by name, date added, size, downloads, or **recently / most used**.

- **Thumbnails you can actually see** — pulled straight from your existing preview files.

---

## 🔎 Search that actually finds things

The headline complaint about Extra Networks is "it doesn't work." The headline promise here is that you'll never say "I couldn't understand it" either.

- **Just start typing** — matches names, folders, and trigger words. fox, fox girl, "red dress".

- **Filter with word:value** — base:pony, folder:anime, tag:style, trigger:* (has any trigger), fav:true, dup:true, note:*.

- **Do more with less** — fox -realistic to exclude, base:pony OR base:sdxl for either.

- **Numbers & dates** — size:>1gb, downloads:>1000, modified:>=2026-07-01.

- A **metadata facet bar** turns base models and CivitAI tags into clickable chips (with live counts) — "show me only my artist styles" is one click.

- A **plain-language "?" help card** lays it all out with examples you can click to try instantly.

Matches are highlighted right on the cards, so you can see why something showed up.

---

## 🖱️ Find it, click it, it's in your prompt

Each type does the sensible thing — the built-in panel always conflated these:

- **LoRA** — left-click inserts <lora:name:weight> and its trigger words; right-click sends it to the **negative** prompt.

- **Embedding** — left-click for positive, right-click for negative.

- **Checkpoint** — click to **switch the active model** (Forge loads it on your next generate; the active card is badged so you always know what's live).

Every insertion is **comma-safe** — words land cleanly separated with a trailing comma and never a double, so you're not forever cleaning up after it. Prefer to stack a bunch at once? **Multi-select** and bulk-insert, with toggles for tags-only, triggers-only, or both.

And you don't have to leave txt2img to do any of it: a **dockable quick-insert side panel** rides along on the generation page — search and insert without switching tabs, then slide it away.

---

## 🖼️ Every model's gallery — and one-click reproduce

Click **⛶** on any card to open its image browser: flip through the model's saved art with ‹ / › and arrow keys. Any image that carries a saved prompt is marked — and for those you get:

- **⤓ Reproduce** — drops the full recipe into your prompt boxes at once: prompt, negative, **seed**, steps, CFG, size, and clip-skip.

- Load / append prompt or negative individually, or grab **just the seed** with 🎲.

- A **🌐 View on CivitAI** link straight to the model's page.

It's the fastest path from "I like that example image" to "now make one like it."

---

## ⭐ Make it yours

Lightweight organization that rides on top of your files without touching them:

- **★ Favorites** — star models, filter to just them, or search fav:true.

- **Usage tracking** — sort by **recently used** and **most used**, built automatically as you insert.

- **Notes & tags** — jot a note or add your own tags on any model (searchable via note: and tag:), stored in a portable userdata.json keyed by hash so it survives folder reshuffles.

---

## 🧹 Housekeeping built in

- **Rescan** (incremental or full) to pick up new downloads — incremental is near-instant.

- **🗑️ Delete to Recycle Bin** — a two-step armed click on the card (so it's never a slip), sending the model to the Windows Recycle Bin, fully restorable.

- **📂 Open folder** in Explorer, right on the card.

- **⧉ Duplicate finder** — dup:true surfaces the same file saved in two places, so you can reclaim space.

- **🔞 NSFW blur** toggle — blurs flagged previews, with a hover-to-peek.

- **Version chips** disambiguate same-named models ("v2.0", "v6B") at a glance.

---

## 🧩 Reads what you already have

Network Commander doesn't ask you to re-tag or re-organize anything. It reads the sidecar metadata that **Civitai Helper** and the **Civitai Downloader** plugin already drop next to your models — .civitai.info, .json, and preview images — and builds a fast local index from it. **No API keys, no downloads, no network calls, no database.** Your files are never modified.

It's **symlink-friendly** (great if you keep your real model files shielded behind linked category folders), discovers your model directories from your WebUI's own settings, and tolerates the odd mis-encoded sidecar that trips other scanners up.

> **There is deliberately no downloader.** Missing models point you to their CivitAI page — you grab them yourself, drop them in, hit **Rescan**, done. No API-key juggling, no unsafe pickles.

---

## 🧩 Part of the Commander family

Network Commander is the third deer — each stands alone, but together they cover **authoring → capturing → browsing**:

- **🦌 Prompt Commander** — turns your prompt into draggable, weightable bubbles: reorder, weight, ghost, and rename tokens with clicks and scrolls.

- **🦌 State Commander** — save your entire generation state as reloadable snapshot cards, with categories, search, and side-by-side compare.

- **🦌 Network Commander** (you're here) — the fast, spacious model browser with real search and one-click insert.

Three deer, one workflow.

---

## 📦 Installation

Place the sd-webui-network-commander folder in your WebUI's extensions/ directory (the folder name matters — preview images are served from that path) and restart. On first launch it quietly indexes your library in the background — it never blocks the UI.

**No dependencies, no build step, no API keys.** Built and tuned on **Forge / Forge-Neo**, with Auto1111 supported.

**Get the most out of it:** run **Civitai Helper** on an existing library, or grab your models with the **Civitai Downloader** browser plugin — either one drops the metadata Network Commander reads, and both are free.

---

## 💡 Why use it

Extra Networks was designed for a folder of a few dozen models. If your library outgrew that years ago, browsing it became a chore — tiny thumbnails, a search that barely searches, and no way to see base model, triggers, or which ones you actually use. Network Commander treats a large library as the normal case, not the edge case:

- Find the right LoRA by base model, style tag, or trigger word — not by remembering its filename

- Insert it (with its triggers, comma-clean) without leaving your prompt

- Reproduce a model's example image in one click

- Star, note, and track what you actually reach for

- Reclaim space by finding duplicates, and clean up safely to the Recycle Bin

Bug reports, suggestions, and feature requests always welcome. 🦌