CivArchive
    Preview 2133224
    Preview 2133235

    A tiny script for AI images created by AUTOMATIC/stable-diffusion-webui

    For Linux and Windows. It operates stand alone. Now support PNG and JPEG

    github https://github.com/yui-tan/pyPromptChecker

    pyPromptChecker binary edition no longer has any requirements.

    source code edition still require Python 3.x

    If you do not wish to use the binary edition,
    please run install.sh/install.bat file again after the upgrade to enable support for JPEG format files.

    What's next

    • Please check the disabled menu names in the main menu

    If you have any feedback, additional feature requests, or specific file formats you'd like me to support, please feel free to let me know. first come, first served.

    Supports

    • Stable Diffusion Webui

      • Extras

      • Hires.fix

      • Dynamic Thresholding (CFG fix) extension

      • CFG auto

      • CFG scheduling

      • Add Network extension

      • ControlNet extension

      • Tiled diffusion extension

      • Regional prompter extension

    • Image format

      • PNG

      • JPEG

    How to Install

    Binary edition (both Linux and Windows users)

    1. Download the binary packages from here or github.

    2. Extract pyPromptChecker-bin directory to any location of your choice.

    3. Optionally, shortcut or desktop files for enable drag-and-drop functionality.

    4. Execute pyPromptChecker or pyPromptChecker.exe by double-click.

    5. If you are Linux user, you can delete pyPromptChecker.exe file.

    6. If you are Windows user, you can delete pyPromptChecker file.

    Source code edition for Linux

    git clone https://github.com/yui-tan/pyPromptChecker
    cd pyPromptChecker/install
    ./install.sh

    if you want to update.

    cd /path/to/pyPromptChecker
    git pull

    Source code edition for Windows

    1. Make sure you've got Python 3.x hanging around.

    2. Download the packages.

    3. Extract the packages to a location of your choice as 'pyPromptChecker'.

    4. Run pyPromptChecker/install/install.bat file.

    5. Don't miss a single word of the words that pop up on the screen, before going wild in the comments.

    How to Update

    Using "git clone" during Installation

    cd /path/to/pyPromptChecker
    git pull

    Using Packages during Installation:

    1. Download the latest package.

    2. Extract the new package to a location of your choice, but not the installed directory.

    3. Overwrite the following files and directories from the extracted package.

    /pyPromptChecker/lib

    /pyPromptChecker/__init__.py

    /pyPromptChecker/main.py

    1. If necessary, also consider overwriting 'config.ini'.

    2. You might realize that it's pretty much the same thing as doing 'git pull'

    How to Uninstall

    Just delete entire directory.

    Description

    [1.3.0] - 2023/08/21

    Added

    • Provided a binary edition (for Linux and Windows users)

    • Added support for JPEG format.

    • Added Thumbnail View mode.

    • Added the feature to select images with thumbnail and generate JSON output.

    • Added menu button.

    Changed

    • Removed the description from the ini file. It has been relocated doc/description.md.

    • Enabled direct navigation to the selected tab without the need to press the 'Jump to' button.

    • Adjusted the shown position of toasts from around buttons to the centre of the window.

    • Enable Tab Navigation if the number of tabs is greater than the value specified in 'TabNavigationMinimumTabs' in 'config.ini', not 5.

    Fixed

    • Fixed an issue of 'MoveDelete' feature would overwrite files with the same name in the destination.

    • As a temporary measure, the feature has been disabled when there is a file with the same name in the destination.

    • If specify a directory that have only directories, the script will crash.

    Deprecated

    • Discontinued the value of 'ModelHashExtractor' in 'config.ini'. It will now always be active.

    • Removed the 'ModelHashExtractor' button. It has been relocated to the menu.

    • Removed the 'Reselect' button. It can now be found in the menu.

    If you do not wish to use the binary edition,
    please run install.sh/install.bat file again after the upgrade to enable support for JPEG format files.

    FAQ

    Comments (5)

    mnemicAug 21, 2023· 1 reaction
    CivitAI

    Great work with the viewer:

    Here's a few suggestions if you're looking for feedback (ignore if not):
    - It would be great if it worked to drag/drop images onto the .exe to open them.
    - The tabs at the bottom (Prompts / Hires.fix / CFG scale fix / Lora), if you stay in the tab whenever you move between images.

    - The open images tabs quickly becomes useless. I suggest a vertical tab bar, or an "open files" list with a scrollbar, for many open files.

    - When clicking the image to open it up in a separate window, this stretches when maximized to fullscreen.

    - When clicking the image to open it up in a separate window, it doesn't switch to the next image when you switch tabs (I think it would be nice if it did). Then you could open an image on another monitor, and switch tabs with the main app on the other if you have a 2-monitor setup.

    - I would love some way to display data for "all open files". i.e. a mode where I can see 'all prompts for all files', or 'all CFG scales', or something like this. To view much data at a glance.

    Yui_tan
    Author
    Aug 22, 2023

    Thank you for your feedback !

    But I'm not a native English speaker, so please forgive any mistakes in my English.

    - drag/drop

    Enabling direct drag and drop to exe isn't too difficult, though. I'll add it to my to-do list for the next minor update.

    Actually, even now, if you pass the file path with the "-f" parameter, it will be processed using that file path.

    So, if you create a shortcut and provide it with the "-f" parameter, you should be able to drag and drop files onto the shortcut.

    By the way, if you set it to "-d", you will be able to drag and drop a single directory.

    - The tabs at the bottom

    I didn't understand the situation, maybe due to my poor English skills....

    I would like to know more about it.

    - The open images tabs

    I thought the combo box and thumbnails would compensate for that inconvenience...

    I will consider making the user experience a bit more convenient.

    - Stretches when maximized to fullscreen

    I hadn't noticed that.

    I'll try to fix that as soon as possible.

    - When clicking the image to open it up in a separate window

    I noticed this after the release yesterday and thought it was a bothersome!

    It's been fixed, so just wait for the next minor update.

    - Display data for "all open files"

    It will be available along with the search window.

    However, this isn't going to be done any time soon, so I hope you'll wait a bit.

    I appreciate your feedback.

    Please continue support to pyPromptChecker!

    mnemicAug 22, 2023

    @Yui_tan Thanks for your reply.
    The -f works for me. -d does not work. It would be great if there was an -fd mode where both can work.
    If it works directly on the .exe, or a shortcut (without the parameter), it will help the program as this is how others tend to work. Preferably you can detect a folder or directory drop and give the user the correct mode.

    Tabs at the bottom:
    If you have many images open, and you click on the "Hires.fix / CFG scale fix"-tab at the bottom. You now see the hires settings for this image.
    Then switch to another open image. Now it goes back to the "Prompts"-tab at the bottom. This makes it hard to compare "Hires.fix" settings from file to file.
    My wish is that it does not go back to PROMPTS tab when you switch image. Instead it stays in the same bottom-tab as before.

    Let me know if I don't make sense. Maybe I can make a video showing it.

    Combo Box / Thumbnail / Tabs:
    You are right. This is a better solution. It may not be a perfect one, but it's better already.
    It's hard to get an overview with file names. A normal file browser-type file list is easier to understand for me. Or vertical tabs. But it's not 100% necessary.

    Keep up the great work!

    Yui_tan
    Author
    Aug 23, 2023

    @mnemic 

    Sorry, but there's a bug with the "-d" option....

    Probably the next minor update will allow you to drag and drop files into the .exe and fix bug too.

    However, you may have to wait a little while to make it OK even if you mix directories and files.

    Tabs at the bottom:

    Definitely!

    But it's possible that not everyone will share the same opinion.

    That's why I'm planning to introduce a feature that will accommodate this.

    Combo Box / Thumbnail / Tabs:

    I will continue to work on improvements.

    However, my current limitations in skills are the biggest obstacle right now.....

    Thank you for your feedback.

    Your words have truly been inspiring!

    mnemicAug 23, 2023

    @Yui_tan When in doubt: Add it as an option! If possible, allow both behaviors.

    Good luck and don't hesitate to ping me and ask for more feedback or suggestions!

    Other
    Other

    Details

    Downloads
    154
    Platform
    CivitAI
    Platform Status
    Available
    Created
    8/21/2023
    Updated
    5/13/2026
    Deleted
    -

    Files

    pypromptchecker_v130.zip

    Mirrors

    CivitAI (1 mirrors)

    Available On (1 platform)

    Same model published on other platforms. May have additional downloads or version variants.