Diffusion Browser

v3.1
An easy way to view embedded image metadata of some AI generators.

Smarter
Diffusion Browser now builds a database with all images information and saves it for later use.

Faster
The images are loaded on the fly when the program is first opened and on a few other occasions. The loading is threaded for faster response.

Still working to make images load even faster.

More versatile
You can set several folders where to look for images and set subfolder lookup individually.

Planned
Allow loading and saving multiple projects
Allow for multiple projects with different configurations
Add hearts to the images
Add stars to the images
Add tags to the images
Create image sets
Mute folders to hide them without having to rebuild the database
Manage the parameters list inside the program
Refresh the parameters without having to rebuilding the database
Allow the consoluidation of multiple parameters into a single label
Image viewer improvements with next/previous buttons and more
Show all data available for a given parameter
Find images and select format by their content not their extensions
Undock and dock the image and inforormation viewers
Make the metadata reading functions more independent to facilitate future implementations
More

Changes.

On Embedders there are scripts to embed information from some generators that do not embed them.
Four versions of Fooocus embedders and probably outdated versions of invoke-ai and sd-webui.

Diffusion Browser uses the Pillow module.

Main Interface

(From top left, clockwise):

Number of images found.
Image paths pull down box.
Paths to look for for the images.
Click to chose an specific path to view.
"all paths" will look into all available paths.
refresh button.
Refresh the grid to sync added/deleted images on the configured paths.
New images will be sorted according to their timestamps.
open path button.
Open the file explorer pointing to the currently selected path.
paths button.
Opens the path requester.
More below.
config button.
Change Diffusion Browser's settings.
More below.
Image preview.
Display the currently selected image.
Click to open a window with the full sized image.
Shift+click or right click to open the image on the default system viewer.
Information viewer.
Display the embedded image information along with some extra content.
More below.
save info button.
Save the information of the info window to a text file with the same name as the image on the same folder.
Right click to chose a different name.
show in folder button.
Open the file explorer pointing to the currently selected image.
overlay button
Overlay the parameter chosen on the parameter box to the grid images.
all parameters or an empty box will clear the overlay.
Right click or shift+click will also clear the overlay.
Sort button
Sort the grid images according to the parameter chosen on the parameter box.
Click again to reverse the sort.
all parameters or an empty box will sort by timestamp.
Right click or shift+click will also sort by timestamp.
Parameters pull down box
A pull down box containing all the parameters available.
Used to narrow the search or expose matches and to select the sort or overlay information.
If using the path parameter, a path on the search box will be normalized.
all parameters or an empty box will reset the functions.
Search entry box
Enter the search string here.
Return will show only the images matching the search.
Shift+return will expose the search match.
Control+return will clear the search.
Control+shift+return will clear the expose.
search button
Will search the images based on the search box entry.
Shift+click/shift+return/shift+space will clear the search without erasing the search box.
Control+click/control+return/control+space will invert the search match.
Alt+click/alt+return/alt+space will search for the exact match.
Alt+control+click/alt+control+return/alt+control+space will search for the inverted exact match.
expose button
Will expose the images based on the search box entry.
All non-matching images will be grayed out.
Shift+click/shift+return/shift+space will clear the expose without erasing the search box.
Control+click/control+return/control+space will invert the expose match.
Alt+click/alt+return/alt+space will expose the exact match.
Alt+control+click/alt+control+return/alt+control+space will expose the inverted exact match.
Image grid
Show all images found on the current paths and subfolders.
Click to select an image.
Once clicked, use the arrow keys to navigate the grid.
Double click/return/space opens the full version on the internal viewer.
Shift+double click/shift+return/shift+pace opens the full version on the default system viewer.
You can select multiple images to perform bath operations. Most menu items and keyboard shortcuts will affect all selected images.
Shift+arrows toggle selects next image.
Shift+click select multiple images.
Control+click toggle selected image.
Right click opens a context menu with functions for this image instead of the selected one.
Clicking the image name on the context menu will copy its path.
The context menu contains:
- The image name
  open image(s) internal
  open image(s) in system
  show image(s) in folder
  copy image(s) to folders
  copy image batch to folder
  save info
  save info as
  copy info to clipboard

Some more keyboard shortcuts:
Control+c: Copy the selected image information to the clipboard.
Control+f: Shows the current image on its folder.
Control+p: Shows the current path.
Control+i: Save the current info box content to a text file with the image name.
Control+shift+i: Save the current info box content to a text file asking for a name.
Control+s: Copy the selected image to another folder.
Shift+control+s: Copy all selected images to a single folder.
Control+o: Sort the images by the chosen parameter.
Control+shift+o: Sort the images by timestamp.
Control+l: Overlays the selected parameter on the grid images.
Control+shift+l: Clears the overlayed parameters.
Control+r: Refresh new/deleted images in the current path.
PageUp/PageDown: Scroll the image grid by one page.
Home: Go to the top of the grid.
End: Go to the bottom of the grid.
Alt+up: Go to the image one page above.
Alt+down: Go to the image one page below.
Control+up: Go to the first image.
Control+down: Go to the last image.
Esc: Cancel the progress when loading images. The images loaded so far are kept. The loading can be resumed with the refresh button.

Full sized image view

The window can be resized and will show the image seed and file name.
Esc closes the window if selected.

Paths requester

Paths can be added, changed, opened and deleted.
Toggle subfolders to enable recursion on that path.
Toggle active to enable or disable that path.
Double clicking on their columns will also toggle them.
Double clicking a path name will change it.
Return/space on a selected path will toggle subfolders.
Shift+return/Shift+space on a selected path will toggle active.
You can shift select multiple paths to perform an action.
Click the headers to sort.
Accepting this requester with different paths will rebuild the program database.

Configuration

The following can be configured:
The number of grid columns.
The number of grid rows.
Each grid image size.
The preview image size.
The height of the buttons (to compensate for font sizes).
The font name.
The font size.
The font weight.
The Background color.
The Main color.
The 1st accent color.
The 2nd accent color.
The alert color.

The get font buttons all take to the same font requester.
The configuration will be saved on an .ini file.
If the interface exceeds the screen size a warning will be given.

The information viewer

Example:

prompt: infinite jest book cover  
seed: 3547671229  
sampler: Euler a  
steps: 20  
cfg scale: 7  
size: 512x512  
model hash: 7460a6fa  
  
source: automatic1111  
real_size: 512 x 512  
format: png  
created: 05-10-2022 15:32:53  
path: <PATH TO>/<IMAGE>.png

To help visualize the parameters and its values, they are presented on different colors. The information window also reorders the parameters on a more intuitive way and display further information.
To this end, the parameters are identified and stored on a file called parameters.txt inside \Projects\Default for further use.
You can edit this file to change the order they appear on the information window.
When new images are cataloged, a message will be shown if new parameters are discovered. They will be automatically added to parameters.txt before the empty separator. They will also be copied to the clipboard.
On the information window:
Use the mouse wheel to scroll.
Selected text will be automatically copied to the clipboard.
Right click to copy all content.
Triple click selects and copy a single parameter.
The lines are reordered for a better presentation.
If no compatible parameter is found, the raw information (if any) will be displayed under embedded info:.
Some parameters have added numbers to keep their order.

The default parameters are:

embedded info, raw prompt, raw negative prompt, prompt, negative prompt,  
negative_prompt, seed, sampler, sampler_name, steps, ddim_steps, ddim_eta,  
cfg scale, cfg_scale, cfgscale, width, height, size, initimg, strength,  
denoising strength, denoising_strength, first pass size, mask blur, n_iter,  
iterations, batch_size, batch size, batch pos, grid, batch, fit, progress_images,  
toggles, resize_mode, gfpgan_strength, upscale_level, upscale_strength, target,  
model, model hash, clip skip, model 1, upscale 1, visibility 1, model 2, upscale 2,  
visibility 2, version, fooocus v2 expansion, styles, performance, resolution,  
sharpness, guidance scale, adm guidance, base model, refiner model, refiner switch,  
scheduler, lora 1, weight 1, lora 2, weight 2, lora 3, weight 3, lora 4, weight 4,  
lora 5, weight 5, lora weight 1, lora name 1, lora weight 2, lora name 2,  
clipPoints, metadata scheme, lora_combined_1, refiner_switch, loras,  
prompt_expansion, adm_guidance, full_negative_prompt, full_prompt, guidance_scale,  
base_model_hash, base_model, refiner_model, created_by, user, lora hashes,  
metadata_scheme,  , source, real_size, format, created, path

Changes

v3.1

Added support for Fooocus and Fooocus a1111 native embedded metadata
Paths requester
- Toggle active or inactive folders
- Double clicking on subfolders or active on the paths requester will toggle them
- Double clicking on the path name will change it
- RETURN, SPACE on the paths requester will toggle subfolders
- SHIFT+RETURN, SHIFT+SPACE on the paths requester will toggle active
- Button to change the selected path
Image grid
- Right click an image now selects it
- SHIFT+UP became ALT+UP
- SHIFT+DOWN became ALT+DOWN
- Multi select images
  - SHIFT+UP add select up
  - SHIFT+DOWN add select down
  - SHIFT+LEFT add select left
  - SHIFT+RIGHT add select right
  - shift+click select more
  - control+click select toggle
  - Menu title copy all selected
  - Menu item perform on all images
  - Keyboard shortcuts affects all selected images
Removed seed from the internal image viewer header
Optimizations
- Load images one by one instead of by rows (preparing for better optimizations)
- Functions to consolidate selected and unselected button state
Several small tweaks on the GUI
- Added Scrollbar to the information window
- Themed the scrollbars
- Exchanged open path and paths buttons positions
- Moved refresh and open path buttons
- Menu appearance
- Some state color changes
Added save batch to folder menu item
- SHIFT+CTRL+S activate batch copy
Paths combobox now show all paths containing images
Metadata errors now are displayed bunched together.
Metadata reading is more robust
Added a program icon

v3.0 (beta)

Save image information database for later retrival
Image loaded on the fly, threaded for speed
Multiple paths with individual subfolder selection
Several new keyboard commands
search and expose by exact match

v2.3

Sort by parameters
Show parameter overlay on the grid
Right click image preview to open in system default viewer
Page up and page down scroll grid by page
Right click on the info box copy all its information
New context menu items
New keyboard shortcuts
Save image parameters information to a file
Show parameters on Automatic1111 Extras modules ordered
Control+button invert search and expose matches
Right click+button clears expose/search/overlay/sort
Show raw image information if no compatible parameter found
Better information parsing
Better internal data representations
Better config handling
Several config bug fixes
Alert color if config entry is invalid
Small GUI fixes

v2.2

ESC cancels image loading
Shift-clicking the preview image opens it in the default system viewer
Shift+double click/return/space on a grid image opens it on the default system viewer
Right click grid images opens a context menu with some functions on that image
Ctrl+c copy the selected grid image to a folder
Show folder now selects the folder
Show in folder now selects the image
Show folder, show in folder and view in system now working on Linux and Mac OS
Mouse wheel now working on Linux and Mac OS
Automatically add new parameters to parameters.txt
Better embedded information parsing
Catch errors loading bad image files
Main widow resizable to avoid problem with window managers
Fixed image viewer window aspect ratio bug

v2.1

Small interface improvements
Better arrow keys navigation
Selected image now highlighted on the grid
Return/space/double click a grid image opens the full version
Esc closes the full image window if selected
Search and expose images
Do not show grid progress while loading anymore but it's faster
Refresh (!) now only updates the new/deleted images.
Better configuration handling
Resizable font requester and configuration windows
Bigger font requester
Font preview while browsing
The preview text on the font requester can be changed
Arrows to change the size on the font requester

Linux stuff

Installation (optional):

This will copy the program to a folder in the home directory and will put a desktop shortcut in the systems directory so every start menu and app launcher will find Diffusion Browser.
Leave Diffusion-Browser.desktop and linux-install.sh in the main Diffusion Browser folder and run linux-install.sh.
To uninstall type:
rm -r $HOME/Diffusion-Browser
rm ~/.local/share/applications/Diffusion-Browser.desktop

For KDE users if main program window is buggy:

Press ALT + F3
Select "More Actions"
Select "Configure Special Windoww Settings"
Add Property
Size
Enter desired Size

Acknowledgments

Many thanks to RandomLegend not only for extensive testing, bug reporting and great feature ideas but also for actually contributing most of the Linux code and stuff.

Diffusion Browser is offered as is, with no guaranties whatsoever, use at your own discretion.
Enjoy and send feedback.
Thanks.

farique1 / diffusion-browser Goto Github PK