<h1 id="wildcard-gallery-v2-github">Wildcard Gallery V2 [<a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/tree/main">Github</a>]</h1><h2 id="what-is-this">What is this</h2>This Automatic1111 extension primary adds a new extra networks gallery for wildcards along with preview thumbnails and other features for an enhanced wildcards management and user experience.<h2 id="installation">Installation</h2><ul><li><code>git clone</code> this repo to the <code>extensions</code> folder in your Web UI installation, or paste the its link to the <code>extensions/Install form URL</code> tab in WebUi</li><li>if you have the old Wildcard Gallery V1 extention consider removing before installing the new one (this a whole rebase from V1 so a clean reinstall is remcommended)<ul><li>make sure to backup a copy the folders <code>metadata</code> and <code>cards</code> if you already have those populated then copy them back to the new extension folder afterward</li></ul></li></ul><h2 id="requirements">requirements</h2><ul><li>This extension extends on the wildcard functionality so it goes without saying that you already have the <a target="_blank" rel="ugc" href="https://github.com/adieyal/sd-dynamic-prompts">sd-dynamic-prompts</a> extension in your WebUi ecosystem if not then you'll need to install the .</li><li>This extension was made with Gradio 3.x in mind things may break with higher versions</li></ul><h2 id="settings">Settings</h2><ul><li>to limit indexation to specific wildcard branches you can add the parent activation path wildcard to the Whitelist (default behavior)</li><li>important!! you wont see any wildcard in the gallery unless you add its file name to whitelist in the webui settings and restart it</li><li>to exclude wildcards from indexation you can add their activation path to the Blacklist</li><li>you can toggle the Downscale preview images to resize and compress generated previews to take far less size on the disk</li></ul><a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/ml0.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/ml0.jpg" /></a><h2 id="wildcard-filter-tab">Wildcard Filter Tab</h2><h3 id="overview">Overview</h3>The Wildcard Filter Tab is the most notable addition in Version 2 of the Wildcard Gallery addon. Without the limitations of the previous Extra Network subtab, this tab introduces a wide range of powerful features, such as:<ul><li>More advanced card filtering options</li><li>A cleaner, more resource-efficient viewer</li><li>Real-time preview channel switching</li><li>Card tagging support</li><li>Live card selection for operations (e.g., export, preview generation, tag editing)</li><li>Wildcard creation directly from within the WebUI</li></ul><hr /><h3 id="tab-layout">Tab Layout</h3>The layout is intentionally simple and includes:<ul><li>Filtering Options Handles the creation and execution of filtering queries. <a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/ml1.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/ml1.jpg" /></a></li><li>Cards ViewerDisplays filter results as cards, paginated (typically 25 per page).<ul><li>Allows card selection for future operations</li><li>Enables card creation</li><li>Includes a Viewer Options subsection for tag visibility, preview cycling, and card grouping</li></ul></li><li>Operations Sections Contains actions for selected cards or the entire wildcard dictionary.</li></ul><hr /><h3 id="terminology">Terminology</h3><ul><li>Preview Channel: A named profile that contains a different set of preview images for the wildcard dictionary. Used to visualize how wildcards behave in various prompt scenarios.</li><li>Tag Group: A logical collection of tags that share display properties (e.g., color, masking behavior).</li><li>Wildcard Sequence: An ordered set of wildcards under a shared parent, executed in a chained manner. Designed for niche cases like prompt-based storytelling.</li></ul><hr /><h3 id="filter-modes">Filter Modes</h3>Mode: <code>wildcard</code><ul><li>The simplest mode. Displays a searchable dropdown of all wildcards in the dictionary.</li><li>You can select one or multiple cards.</li><li>Optionally extend the filter to include all cards with the same parent as the selected one.</li></ul><a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/ml7.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/ml7.jpg" /></a><a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/ml8.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/ml8.jpg" /></a>Mode: <code>selector text</code><ul><li>Uses selector-style input (e.g., <code>__parentA/parentB/exampleCard__</code>) to filter results.</li><li>Wildcards can be targeted directly or via wildcard globbing:<ul><li><code>__parentA/parentB/*__</code> will show all cards under <code>parentB</code>.</li></ul></li><li>Supports multiple comma-separated selectors (e.g., <code>__x/y/*__, __z/card__</code>).</li></ul>Mode: <code>tags</code><ul><li>Filters cards based on custom user-defined tags.</li><li>Supports Inclusion Logic:<ul><li><code>AND</code>: All specified tags must be present in a card.</li><li><code>OR</code>: Any of the specified tags can be present.</li></ul></li><li>Tags placed in the Excluded dropdown will be used to reject cards with those tags.</li></ul><a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/ml10.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/ml10.jpg" /></a>Mode: <code>prompt search</code><ul><li>The most specific and niche mode. Filters based on the card’s internal prompt text.</li><li>Supports Included and Excluded comma-separated terms (unordered).</li></ul><a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/ml11.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/ml11.jpg" /></a><a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/ml12.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/ml12.jpg" /></a><hr /><h3 id="cards-viewer">Cards Viewer</h3>This is where you'll interact with filtered results in the form of cards.<ul><li>Uses pagination to ensure performance even with large datasets.</li><li>Selection mode defaults to Stacked, but can be changed to Single in the top-right corner of the viewer.</li></ul><hr /><h3 id="viewer-options">Viewer Options</h3>Additional utilities can be accessed from the collapsed section above the card viewer:<ul><li>Card Stacking Level Groups cards based on their parent rank.<ul><li>E.g., setting stacking to 3 will group <code>parentA/parentB/parentC/Card1</code> and <code>.../Card2</code> under a shared <code>parentC/*</code> stack.</li><li>Selecting a stack selects all cards within it.</li><li>Changing stacking level does not reset card selections.</li></ul><a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/ml4.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/ml4.jpg" /></a> <a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/ml5.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/ml5.jpg" /></a></li><li>Tag Masking Allows hiding or decluttering tags on cards based on their tag group settings.</li><li>Selected Preview Channel Lets you cycle through different preview images per card based on the chosen channel.</li></ul><hr /><h3 id="card-detail-panel">Card Detail Panel</h3>When you select a card, details and actions become available on the left-side panel.Actions (available for single or multiple selections): <a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/ml3.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/ml3.jpg" /></a><ul><li>Copy to Clipboard: Copies the wildcard activation text for manual prompt use.</li><li>Edit Card Tags:<ul><li>Add/remove tags using the dropdown or by typing a new one.</li><li>"Add Tag" attaches the tag; "Remove Tag" detaches it.</li></ul></li><li>Favorite: Adds cards to your favorites list.</li><li>Remove: Currently disabled until card editing is fully implemented.</li></ul>Information: <a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/ml2.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/ml2.jpg" /></a><ul><li>Tags: Full list of card tags (ignores masking).</li><li>Card Path: The virtual path of the card in the dictionary.</li><li>Prompt: The raw prompt text embedded in the wildcard.</li><li>File: The physical location of the wildcard file.</li><li>Protected: Indicates whether the card is protected from editing (feature not yet implemented).</li><li>Channels: Lists which preview channels contain this card.</li></ul><hr /><h3 id="operations-sections">Operations Sections</h3><ul><li>Import Wildcard Pack: Imports a Wildcard Pack zip into the dictionary (including all of it metadata and perviews)</li><li>Export as Wildcard Pack: Export the selected cards (or all filtered results) as a valid Wildcard Pack</li><li>Tag Groups: Create new Tag Groups or edit existing ones by adding member tags and setting tag colors</li><li>Misc Actions<ul><li>Rebuild Wildcard Dictionary: rescan for changes and builds an up to date wildcard dictionary (think of it as a refresh action)</li><li>Collect Redundant Thumbnails Files: round up all images that don’t correspond to any existing entry in the "USER_OUTPUT/STRAY_RESOURCES" folder.</li><li>Collect Thumbnails: collects copies of selected cards thumbnails from the active channel in "USER_OUTPUT" folder.</li><li>Nullify Thumbnails: Sets the thumbnails for selected cards thumbnails in the active channel so that they can be skipped with batch generating perviews.</li><li>Remove Thumbnails: Clears the thumbnails for selected cards thumbnails in the active channel.</li></ul></li></ul><h2 id="wildcard-preview-utils">Wildcard Preview Utils</h2>This is a txt2img script used in conjunction with the Wildcard Filter Tab to automate preview generation and deployment for multiple wildcards within the dictionary. It also provides additional utilities depending on the selected script mode.<a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/tr (2).jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/tr (2).jpg" /></a><a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/tr (1).jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/tr (1).jpg" /></a><ul><li>Disabled: Bypasses script logic and generates images normally.</li><li>Batch Prompting: Uses the selected (or filtered) wildcards from the Wildcard Filter Tab to generate images for each wildcard individually.<ul><li>Setting Prompt Usage Mode to Combine Cards will instead generate a single image using all selected wildcards.</li></ul></li><li>Sequence Generation: Generates all images for a sequence-type wildcard in the correct order.<ul><li>Simply select any wildcard that belongs to the sequence — the entire sequence will be generated automatically.</li></ul></li><li>Preview Generation: Generates and assigns preview images to the selected (or filtered) wildcards.<ul><li>Make sure to switch to the channel where you want the resulting image(s) to be saved.</li><li>Enabling Override Existing Previews will force regeneration and replacement of previews for all selected wildcards, even if they already have a preview in the chosen channel.</li><li>Simplified Usage Steps:<ol><li>Select the desired cards in the Wildcard Filter Tab.</li></ol><a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/st1.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/st1.jpg" /></a><ol><li>Add the base positive and negative prompts for image generation.</li></ol><a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/st2.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/st2.jpg" /></a><ol><li>Activate the Wildcard Preview Utils script, choose Preview Generation, and set the desired channel for output.<ul><li>You can also check how many cards are included in the generation queue by clicking Count Selected Cards.</li></ul></li></ol><a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/st3.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/st3.jpg" /></a><ol><li>Click Generate and wait for the generation queue to finish.</li><li>Back in Wildcard Filter Tab, confirm that previews were assigned by switching to the correct channel.<ul><li>(Sometimes you may need to deselect and reselect a card for the info to refresh.)</li></ul></li></ol><a target="_blank" rel="ugc" href="https://github.com/navimixu/wildcard-gallery/blob/main/screenshots/st4.jpg"><img src="https://github.com/navimixu/wildcard-gallery/raw/main/screenshots/st4.jpg" /></a></li></ul></li></ul>

Files with SHA256: acbc5790af54f55f7026df3e6acf5d2f42668efa72515df011641d19d5645848