<h1 id="sd-character-finder">SD Character Finder</h1><img src="https://image.civitai.com/xG1nkqKTMzGDvpLrqFT7WA/55714120-6a41-4f61-8f2e-df2ae2bba9e1/original=true/55714120-6a41-4f61-8f2e-df2ae2bba9e1.jpeg" />Extension for Stable Diffusion WebUI and ForgeCan't remember the exact tags for that specific character? Want to generate an image from a series and discover tags you didn't even know existed? Say no more! 🦸‍♂️Your ultimate character encyclopedia directly inside your Stable Diffusion WebUI. Browse over 23,000+ Danbooru/e621 characters without leaving your UI, search by name, tag, or series, preview their thumbnails, and send their perfect prompt tags straight to <code>txt2img</code> with a single click!<hr /><h2 id="features">🎯 Features</h2>⭐ = Core Highlights<h3 id="browse-and-search">🔍 Browse &amp; Search</h3><ul><li>Browse 23,000+ characters (20,000+ Danbooru and 3,000+ e621) directly inside the WebUI — no tab switching! ⭐</li><li>Search by character name, tag, or browse alphabetically by series/franchise</li><li>Use multiple keywords for precise filtering (e.g., <code>miku vocaloid</code> ensures both terms exist)</li><li>High-performance offline SQLite database ensures instant search results without internet dependence ⭐</li><li>Pagination system keeps the UI snappy even when returning thousands of results</li></ul><h3 id="character-info-and-preview">🖼️ Character Info &amp; Preview</h3><ul><li>View high-quality character thumbnails instantly (with color-coded Source Badges).</li><li>Stable visual card grid in Gallery View with responsive layout (desktop and mobile).</li><li>Recently Viewed panel tracks your last 10 clicked characters so you can quickly jump back to them.</li><li>Click any card to load character details and prompt tags.</li><li>Side preview supports Click to expand and opens a large modal image.</li><li>Expandable Live Danbooru Tags menu: dynamically fetch extra character-specific tags from Danbooru (like clothes, eyes, hair) separated into explicit selectable Checkboxes by Category (Copyright, Character, General, Artist, Meta) ⭐</li><li>Automatically sorts appended web-tags following optimal generation standards (NovelAI style formatting).</li><li>Clean, translation-ready interface integrating straight into A1111/Forge standard inputs.</li></ul><h3 id="one-click-prompting">🚀 One-Click Prompting</h3><ul><li>Send to Generate — Instantly replaces your current <code>txt2img</code> prompt with the character's signature tags and automatically switches you to the tab.</li><li>Add to txt2img — Intelligently appends the character tags to your existing prompt ⭐</li><li>Smart Deduplication — Automatically removes duplicate words when enabled in Settings</li><li>Manual Duplicate Mode — Disable deduplication in Settings to force raw append behavior</li></ul><h3 id="configuration">⚙️ Configuration</h3><ul><li>Fully integrated with the native WebUI settings menu (Settings -&gt; Options -&gt; SD Character Finder)</li><li>Configure results per page (<code>5..30</code>), thumbnail sizes, cards per row, deduplication behavior for <code>Add to txt2img</code>, Danbooru API credentials, and default behaviors</li><li>Fast, lightweight, and completely localized</li></ul><hr /><h2 id="installation">📦 Installation</h2><h3 id="inside-sd-webui-(recommended)">Inside SD WebUI (Recommended)</h3><ol><li>Open your WebUI and go to the Extensions tab.</li><li>Click on the Install from URL sub-tab.</li><li>Paste: <a target="_blank" rel="ugc" href="https://github.com/eduardoabreu81/sd-character-finder">https://github.com/eduardoabreu81/sd-character-finder</a></li><li>Click Install.</li><li>Go to the Installed sub-tab and click Apply and restart UI.</li></ol>⚠️ Compatible with AUTOMATIC1111, Forge, and Forge Classic / Neo.<hr /><h2 id="quick-start">🚀 Quick Start</h2><ol><li>Go to the new Danbooru Characters tab in your WebUI.</li><li>Type a character name or tag (e.g., miku, saber, blue hair), or pick a series from the Series Dropdown (e.g., Arknights).</li><li>Click 🔍 Search.</li><li>Click on any character in the results table to see their preview card and tags.</li><li>In Gallery View, click a visual card to select it instantly.</li><li>Click the side preview image (<code>Click to expand</code>) to open a larger modal view.</li><li>Expand Extra tags if you want to pull more specific prompt descriptors directly from the web.</li><li>Click ➡️ Send to Generate or ➕ Add to txt2img to instantly fill your prompt!</li></ol>

SD Character Finder | A1111 & Forge Classic/Neo Extension

v0.5.3 — Hotfix: Startup Crash &amp; Database Lock<ul><li>Startup Crash Fix — Fixed a <code>NameError</code> crash that prevented the Gradio extension from initializing on remote WebUI instances (like RunPod) after the recent pagination updates.</li><li>Database Lock Fix — Disabled WAL mode and added an automatic cleanup routine for orphaned <code>.db-wal</code> and <code>.db-shm</code> files. This permanently prevents the <code>database disk image is malformed</code> error that occurred when updating the extension via <code>git pull</code> on remote servers.</li><li>Gallery History Click — Fixed issue where clicking a character in the "Recently Viewed" list wouldn't load their details.</li></ul>v0.5.2 — History Pagination, Auto-Select &amp; DB Series Rescue<ul><li>DB Series Rescue — Automatically fixed 709 popular characters (including Konosuba, JoJo, Re:Zero) that were missing their franchise metadata entirely by extracting and standardizing their 2nd copyright tag.</li><li>Recently Viewed Extended — Increased history retention limit from 20 to 100 characters and added independent, fully functional pagination controls exclusively inside the "Recently Viewed" tab.</li><li>Auto-Select Search Results — Submitting a search now automatically selects and loads the preview image and attributes of the first resulting character, saving you an extra click.</li></ul>v0.5.1 — Global Pagination &amp; Forge State Saving<ul><li>Global Pagination — Pagination controls (top and bottom) are now truly global, existing outside the "Search Results" tab. This allows seamless page navigation across any visible tab (Search, History, etc.) without losing context.</li><li>Forge State Saving — Added permanent <code>elem_id</code> hooks to all key inputs (Search, Series, Dropdowns). This allows AUTOMATIC1111/Forge's native "Save UI Defaults" feature to reliably serialize and restore your exact filter state across reboots.</li><li>Search Reset Fixes — Fixed a bug where clicking "Clear Search" or "Clear All" would break the Series dropdown by setting it to <code>None</code>. It now correctly resets back to the <code>"All"</code> state.</li></ul>

Files with SHA256: 4c0782dbd81f7e91d2c0d5be55e4d5b945fb1913dcbe9880c01f7de766953811