Skip to content

LordKa-Berlin/ImagePromptViewer

Repository files navigation

🖼️ ImagePromptViewer

Version: 1.8.0.0
Release Date: 2025-04-08
Codename: Master9 Stable
Author: LordKa-Berlin
License: CC BY-NC 4.0


🔍 What is ImagePromptViewer?

ImagePromptViewer is a lightweight, powerful image viewer tailored for AI-generated images that contain embedded prompt metadata.
Its core purpose is to extract and display the full prompt structure used during image generation — including the Prompt, Negative Prompt, and Generation Settings — directly from PNG and JPEG files.

It supports images generated by tools such as Forge, ComfyUI, InvokeAI, Fooocus, DiffusionBee, AUTOMATIC1111, and others.

Whether you're curating datasets, analyzing generation details, or exploring how images were created —

ImagePromptViewer helps you uncover the embedded intelligence behind every AI image.

Sorry for the exuberant text, it was created by an AI 😄


✨ Key Features

  • 🖼️ Image Viewer with adjustable thumbnail sizes
  • 📥 Reads embedded prompts from PNG and JPEG
  • 🧠 Parses Prompt / Negative Prompt / Settings separately
  • 🗂️ Folder & Subfolder navigation
  • 🔍 Filter by keywords, file size, date, and prompt content
  • 🧾 LoRA & weight highlighting in prompt text
  • 🖥️ Fullscreen mode with quick delete/copy options
  • 🗑️ Safe deletion to Recycle Bin
  • 🕘 History of recently opened folders

📷 Screenshots

🖼️ Main Window

Main Window

🖼️ Fullscreen Mode

Fullscreen Mode

🖼️ UI Scaling

UI Scaling


⚙️ Installation & Usage

Requirements

  • Python 3.7 or higher
  • OS: Windows, Linux, macOS

Installation

pip install tkinterdnd2 Pillow screeninfo send2trash piexif

💡 Note: All required modules will be checked and automatically installed when the script starts. Manual installation using the command above is only necessary if you prefer to set them up in advance or want to avoid auto-installation at runtime.

Start the App

python ImagePromptViewer-1.8.0.0.py

🧪 Prompt Extraction Details

  • 📖 Extracts full generation info: Prompt, Negative Prompt, and Settings
  • PNG: Reads from parameters, description, prompt, or info dictionary
  • JPEG: Extracts from EXIF.UserComment (supports common variants)
  • Extraction logic: Stable Diffusion format aware (e.g. WebUI & Forge)

🧰 Advanced Features

Filtering

  • 🔤 Filter by prompt content, file name, or settings
  • 📆 Filter by date or file size
  • 👁️ Active filter indicator in GUI

Fullscreen

  • Prompts displayed over full image
  • Supports: delete, copy path, scrollable text fields
  • Ideal for reviewing generations in detail

🧪 Help Improve ImagePromptViewer

ImagePromptViewer is still in an early development stage and may not yet support all prompt embedding formats used by various AI image generation tools.

If you encounter a file where the prompt is not detected or displayed correctly, please send:

  • 🖼️ The image file
  • 🧾 A note stating which tool was used to generate it

📧 to lordkaberlin@gmail.com

This helps improve future compatibility and ensures more formats can be supported in upcoming versions.

Thank you for contributing to the improvement of ImagePromptViewer!

⚠️ Known Limitations

  • 📅 Date range filtering is still experimental
  • 🖼️ Large folders (>4000 images) may affect performance
  • 🔄 Some rare prompt formats may be unsupported (yet)

💬 Feedback & Contributions

Feel free to:


📜 License

This project is licensed under the
Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)
See LICENSE.md for full details.


Developed with care by LordKa-Berlin — keeping prompt history alive.


---

About

A Python script to display PNG images (e.g. from StableDiffusion) and extract prompt, negative prompt, and settings from text chunks. Offers fullscreen mode, a thumbnail preview, plus copy or open images in the system’s viewer.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages