Prompts Browser Extension 1.1.0

Prompts Browser Extension for the AUTOMATIC1111/stable-diffusion-webui.

1. Installation
2. Known Prompts Browser
3. Active Prompts
4. Adding new prompts to the collection
5. Generating previews for prompts
6. Prompt tools
7. Styles
8. Collection editor
9. Prompt editor
10. Setup window
11. Autocomplite
12. Normalize
13. Collections database

Changes in 1.1.0

⚠️ Previous versions stored collections in the root of the application. Since version 1.1.0 they are now stored in the extension directory. If you used previous versions, you will need to move your collections there. ⚠️

As of version 1.1.0, the extension now works via FastAPI and no longer depends on an additional local server or extension installation location. This will cover more use cases and customizations of the application.

Installation:

1. Make sure you have the latest AUTOMATIC1111/stable-diffusion-webui version instaled. Prompt Browser 1.1.0 was tested and adapted for WebUI versions 1.6.0.

2. Unzip/clone the plugin into the extensions directory. Or install it using WebUI Extensions -> Install from URL tab.

3. On first run in the Prompts Browser Extension directory will be created directory prompts_catalogue with subdirectory myprompts - this will be the first collection of prompts. As well as the directory styles_catalogue where new styles will be stored.

4. With the extension installed, you can add the startup argument to Stable Diffusion WebUI --prompts-browser-readonly. With this argument, the extension client and server will be read-only, which may be desirable when using the extension when hosting the application online.

Important

This extension modifies the DOM directly, without working through any API for such purposes. As such, an update to AUTOMATIC1111/stable-diffusion-webui could potentially break some functionality of this extension until the extension is in turn updated to work with a newer version of WebUI. If something stops working after WebUI update - create a ticket.

Usage:

Known Prompts Browser

1. The known prompts browser will display all known prompts from all the collections added to the prompts_catalogue directory.

2. Click on a prompt to add it to the active prompts.

3. Shift + click: opens prompt edition window.

4. Ctrl/Meta + click: opens the dialog of removing the prompt from the collection (it will be lost).

5. Prompts in the collection can be moved by drag and drop.

6. You can filter prompts using filter params like collection, category, tags (supports autocomplite of known tags) and name.

7. You can change sorting mode in the order drop down menu.

Active Prompts

1. Prompts can be added either manually via the text box or via the Prompt Browser.

2. The order of the Prompts can be changed by dragging them with the mouse.

3. Shift + mouse wheel: will change the weight of the Prompt depending on the direction of the mouse wheel.

4. Ctrl + click: deletes prompt from the active prompts.

5. Double click: opens the Prompt Tools.

Adding new prompts to the collection

1. Enter text in the text box - the text will be divided by the presence of a comma in the prompts in the text box. If you click on the icon of a prompt, it will become the selected one. Now you can generate an image and if any of the currently active prompts is selected there will be a button Save preview above the generated image. By saving the preview, it will be added to the collection, and the preview image for that sample will be added to the collection's preview directory.

2. The Add unknown button above the Prompts entry field opens a window for adding new prompts. In this window you can select new prompts and a collection of prompts, where you can add them with the Add new prompts button. The Toggle all button selects or deselects all new proppts. The All collections toggle switches on or off the check for all possible collections (by default, it is on and only those prompts that are not in any of the possible collections will be displayed).

Generating previews for prompts

1. You can select a prompt, generate an image and click the Save preview button above the generated image to create or replace the preview for that prompt.

2. You can use the Collection editor to generate previews for multiple prompts at once. You can open the Collection editor by clicking the Edit collection button above the list of known prompts. In the Collection editor window, you can click on the preview square of the prompt to mark it. You can also click on the Toggle all button to select all the prompts in the collection. You can also filter the prompts so that only prompts without previews are displayed. To do this, set the filter "exclude - meta - have preview". After that, you can click "Generate" and previews will be generated for all selected prompts one by one.

3. You can select additional styles to be used during autogeneration.

   1. Prompt only - only prompt itself will be used for generating preview.
   2. With current prompt - target prompt will be added to the current prompts in the positive prompts textbox..
   3. With prompt autogen style - If a prompt has a style assigned for autogeneration, it will use that prompt and the assigned style. If the prompt does not have an autogenerate-style, only the prompt itself will be used.
   4. With selected autogen style - the currently selected style in the Autogenerate style field will be used as the style for autogeneration.

Prompt tools

1. If you double-click on the active prompt, the Prompt Tools window will open.

2. A list of active prompts will be displayed at the top, where you can change the selected prompt.

3. Based on categories, tags and name of the prompt, similar prompts will be displayed.

4. Prompts will be sorted by their similarity to the selected prompt according to the selected parameters (tags, categories and name).

5. Clicking on a promt from the list of similar promts will replace the selected promt with the target one.

6. Shift + click on a promt from the list will add the target promt to the active promts (keeping the selected promt).

Styles

1. Above the text box there is a styles button which opens the Styles window.

2. A list of active prompts will be displayed at the top.

3. The current prompts can be saved as a style by typing in the text box above the name of the style and clicking the Save as style button next to it.

4. In the list of style collections, you can select the collection where the style will be saved. You can also select the current generation parameters that will be saved along with the style's prompts (such as negative prompts, size, sampler, etc).

5. "Simple mode" switch changes styles view mode from the simple to the detailed mode.

6. In simple mode you need to select a prompt and then press a needed button at the bottom of the window.

7. Prompts from saved styles can be added to active prompts at the beginning of their list or at the end.

8. The remove button will delete the style from the database (it will be lost).

9. The update button will replace the style's prompts with the current active prompts.

10. The Update preview button will add/replace preview for the style using the currently generated and selected image.

11. In simple mode you can also click with shift key to add style. You can click and hold ctrl/meta key to delete style.

Collection editor

1. You can open the Collection editor by clicking the Edit collection button above the list of known prompts.

2. The collection selected in the collections filter field of known prompts will be opened for editing. If no collection is selected, the first collection from the list of collections will be opened.

3. You can click on the preview square of the prompt to mark it.

4. You can also select/deselect all prompts by clicking on Toggle all.

5. You can filter prompts by using filter menu at the top of the window.

6. You can delete selected prompt by pressing Delete selected button (this will remove them permanently).

7. If you have more than one collection installed, you will have the Collection block available. Selecting another collection and pressing Move or Copy will copy or move the selected props into the selected collection.

8. In the Category block you can select a category and add or remove it from all selected prompts.

9. In the Tags block you can write tags and add or remove them from all selected prompts.

10. In the Autogenerate style you can assign style to be used with preview image autogeneration for this prompt.

11. By pressing Generate button you will start generating preview for all selected prompts. See autogeneration subsection of Generating previews for prompts.

Prompt editor

1. By clicking on prompt in the Known prompts list holding shift key you will open target Prompt Editor window.

2. If you have same prompt in different collections you can switch between them with collection selector near prompt name.

3. If you have more than one collection installed, you can select another collection and copy or move target prompt there.

4. Tags and Categories lists shows prompt tags and collections. You can hold ctrl/meta and click on them to remove them.

5. You can enter new tags and click Add tag button to add them to the target prompt.

6. You can select new category and click Add category to add new category to the target prompt.

7. Autogen - assigns style to be used with prompt preview autogeneration. See autogeneration subsection of Generating previews for prompts.

8. Add at the beginning - if checked will always add prompt to the start of other prompts. By default will add new prompt at the end of active prompts list.

9. Subsequent prompts - prompts to add right after target prompt.

10. Add prompts at the start - prompts to add at the start of the active prompts.

11. Add prompts at the end - prompts to add at the end of the active prompts.

12. Add at the beginning, Subsequent prompts, Add prompts at the start and Add prompts at the end are useful when working with LORAs. For example, if a LORA requires specific prompts for activation, you can assign them to be automatically appended along with the LORA. You can also assign LORA prompt for some prompts if you always want to use them together.

13. You can add comment for the prompt in the comment text area.

14. Press Save to save your changes and close window or cancel to close window without saving.

Setup window

1. Click on Setup button at the top menu to open Setup window.

2. New prompts collections - will open creation of the new prompts collection.

3. New styles collections - will open creation of the new styles collection.

4. Collection name - name of the collection. A directory with the same name will be created.

5. Store format - the way prompts/styles are stored. In the short format all prompts/styles data will be saved in the file data.json. In the expanded format a directory prompts/styles will be added to the collection directory and every prompt/style will be stored as a separate file. The expanded format makes it easier to work with the collection when using version control systems like Git.

6. Below 1 scroll weight - how much weight one mouse wheel movement will change when below weight 1.

7. Above 1 scroll weight - how much weight one mouse wheel movement will change when above weight 1.

8. Transform prompts to lower case - will change prompts in the prompts textarea to be lower case.

9. Spaces in prompts transform - changes the handling of spaces in multiword prompts. Can be Do nothing, To space and To underscore.

10. Show prompt index in database - will display the ordinal id of the prompt in the collection if the collection is selected in the collection filter. Useful when manually sorting prompts within a collection.

Autocomplite

1. When you manually type prompts, a menu with similar prompts from the database of known prompts will be displayed. You can finish a prompt from the autocomplite menu by clicking on it or by selecting it with the up and down arrows and pressing Enter.

Normalize

1. The normalize button is displayed above the positive prompt field. It activates the function of normalization of the entered prompts according to the settings of normalization of prompts set in the Setup window. Useful when inserting prompts from external sources.

Collections database

This extension does not come with a pre-built prompts database. It is up to the user to choose a ready-made database or create their own. Remember that collections goes into the prompts_catalogue directory inside your Stable Diffusion Web UI directory. This directory is being crated after at least one start of SDWebUI with the installed Prompts Browser Extension.

Some existing collections:

1. prompts_portrait - A proof of concept collection for generating character portraits. Comes with tags and categories tagged in.