A desktop utility designed to automatically harvest Danbooru character tags, filter for visual traits, and build structured YAML wildcard libraries for Stable Diffusion.
Manually copying character tags (Hair color, eye color, costume specifics) for hundreds of characters is tedious. This tool automates the entire process:
- Input a Series (e.g.,
genshin impact). - Fetch every character in that series.
- Scrape their visual traits (Hair, Eyes, Wings, Horns, etc.).
- Export a clean, ready-to-use YAML file for your wildcard library.
Traverses Series (Copyright) -> Character -> Traits.
- Example:
Genshin Impact→Raiden Shogun→long hair, purple hair, purple eyes, large breasts, mole, braid.
- Noise Reduction: Automatically filters out non-descriptive tags. Focuses strictly on physical attributes (hair color, eye color, animal ears, etc.).
- Consistency Checks: Prioritizes specific posts (tagged with
1girl,1boy, orsolo) to ensure the tags represent the character's core design rather than a niche variant.
Generates structured YAML files compatible with combinatorial prompt generation.
- Dynamic Root Keys: Customize the top-level key (e.g., set to
__character__for immediate use). - Merge Functionality: Update your existing wildcard lists without wiping out manual changes.
Important
You must have the .NET 8.0 SDK installed to build or run this application.
This project includes a GitHub Actions workflow for automated cross-platform builds. To build manually:
dotnet publish -c Release -r win-x64 -p:PublishSingleFile=true --self-contained true -o ./publish/windotnet publish -c Release -r linux-x64 -p:PublishSingleFile=true --self-contained true -o ./publish/linuxdotnet publish -c Release -r osx-arm64 -p:PublishSingleFile=true --self-contained true -o ./publish/mac-armdotnet publish -c Release -r osx-x64 -p:PublishSingleFile=true --self-contained true -o ./publish/mac-intelNote
The build commands above generate a portable executable in the ./publish folder with all dependencies embedded. No installation required!
Type the target copyright tag (e.g., pokemon, blue archive) into the search field and click Fetch.
A tree view will populate with found characters.
- Check the characters you want to include in your wildcard.
- Uncheck generic or unwanted entries (e.g.,
pokemon_(creature)).
Click Process. The tool will scrape the most descriptive tags for every selected character.
Tip
Monitor the Debug Log overlay or the console for real-time scraping status.
Click Export YAML.
- Root Key: Enter the trigger word you want to use in your prompts (e.g.,
my_characters). - Save: The resulting file can be placed directly into your Dynamic Prompts
wildcardsdirectory.
Genshin Impact:
- Amber: brown eyes, long hair, ribbon, goggles...
- Lisa: green eyes, witch hat, purple dress...
Powered by the open-source community:
Thanks for visiting!
