Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/farique1/diffusion-browser
An easy way to view the images and metadata generated by Stable Diffusion's Automatic1111 WebUI
https://github.com/farique1/diffusion-browser
ai ai-art dalle dalle2 diffusion image-generation midjourney stable-diffusion webui
Last synced: 2 months ago
JSON representation
An easy way to view the images and metadata generated by Stable Diffusion's Automatic1111 WebUI
- Host: GitHub
- URL: https://github.com/farique1/diffusion-browser
- Owner: farique1
- Created: 2022-09-21T19:08:54.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-03-19T22:09:02.000Z (10 months ago)
- Last Synced: 2024-08-08T00:43:49.830Z (6 months ago)
- Topics: ai, ai-art, dalle, dalle2, diffusion, image-generation, midjourney, stable-diffusion, webui
- Language: Python
- Homepage:
- Size: 8.31 MB
- Stars: 37
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- project-awesome - farique1/diffusion-browser - An easy way to view the images and metadata generated by Stable Diffusion's Automatic1111 WebUI (Python)
README
# 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**](#Changes).
> On [Embedders](Embedders/README.md) 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](https://pillow.readthedocs.io/en/stable/)** 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**](#Paths-requester).
- *config button.*
Change Diffusion Browser's settings.
[**More below**](#Configuration).
- *Image preview.*
Display the currently selected image.
`Click` to open a [window with the full sized image](#Full-sized-image-view).
`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**](#The-information-viewer).
- *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:
```yaml
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: /.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](https://github.com/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.