Diffusion Toolkit

Diffusion Toolkit is an image metadata-indexer and viewer for AI-generated images. It aims to help you organize, search and sort your ever-growing collection.

Usage

Usage should be pretty straightforward, but there are a lot of tips and tricks and shortcuts you can learn. See the documentation for Getting Started

Thanks to Bill Meeks for putting together a demonstration video.

Installation

• Currently runs on Windows only
• Download the latest release
  • Look for > Assets under the latest release, expand it, then grab the zip file Diffusion.Toolkit.v1.x.zip.
• Unzip all the files to a folder
• You may need to install the .NET 6 Desktop Runtime if you haven't already

Build from source

Prerequisites

• Requires Visual Studio 2022
• .NET 6 SDK (includes the desktop runtime)

Building

• Clone this repository
• Run publish.cmd

A folder named build will be created, containing all the necessary files.

Features

• Scan images, store and index prompts and other metadata (PNGInfo)
• Search for your images
  • Using a simple query
  • Using the filter
• View images and the metadata easily
  • Toggle PNGInfo
• Tag your images
  • Favorite
  • Rating (1-10)
  • NSFW
• Sort images
  • by Date Created
  • by Aesthetic Score
  • by Rating
• Auto tag NFSW by keywords
• Blur images tagged as NSFW
  • NSFW
• Albums
  • Select images, right-click > Add to Album
  • Drag and drop images to albums
• Folder View
• View and search prompts
  • List Prompts and usage
  • List Negative Prompts and usage
  • List images associated with prompts
• Drag and Drop
  • Drag and drop images to another folder to move (CTRL-drag to copy)

Supported formats

• JPG/JPEG + EXIF
• PNG
• WebP
• .TXT metadata

Supported Metadata formats

• AUTOMATIC1111
• InvokeAI (Dream/sd-metadata/invokeai_metadata)
• NovelAI
• Stable Diffusion
• SDNext
• EasyDiffusion
• RuinedFooocus
• FooocusMRE
• ComfyUI + SDXL (Work in progress)

You can even use it on images without metadata and still use the other features such as rating and albums!

Screenshots

Keyboard Shortcuts

Make sure the thumbnail view or the preview pane has the focus if the shortcuts don't work.

FAQ

How do I view my image's metadata (PNGInfo)?

With the Preview Pane visible, press I in the thumbnail view or with the Preview Pane in focus to show or hide the metadata. You can also click the eye icon at the botton right of the Preview Pane.

What is Rebuild Metadata and when should I use it?

Rebuild Metadata will rescan all your images and update the database with any new or updated metadata found. It doesn't affect your custom tags (rating, favorite, nsfw).

You only need to Rebuild Metadata if a new version of Diffusion Toolkit comes out with support for metadata that exists in your existing images.

Can I move my images to a different folder?

I you want to move your images to a different folder, but still within a Diffusion folder, you should use the right-click > Move command. This allows Diffusion Toolkit to handle the moving of images, and know to keep all the Diffusion Toolkit metadata (Favorites, Rating, NSFW) intact while moving.

If you use Explorer or some other application to move the files, but still under the Diffusion folders, when you Rescan Folders or Rebuild Images Diffusion Toolkit will detect that the images have been removed, then will detect new files added. You will lose any Favorites, Ratings or other Toolkit-specific information.

Buy me a coffee

I've been told that people should be allowed to buy me a coffee

Beer works too (PayPal)

• I'm feeling generous
• Buy me a 2 craft beers
• Buy me a craft beer
• Buy me 2 local beers