<h1 id="stable-diffusion-prompt-reader-4inix0r3k"><a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader">Stable Diffusion Prompt Reader</a></h1>Github Repo: <img src="https://img.shields.io/github/stars/receyuki/stable-diffusion-prompt-reader?style=social" alt="preview badge" /><a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader">https://github.com/receyuki/stable-diffusion-prompt-reader</a><a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/blob/master/README.zh-Hans.md">简体中文</a><a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/releases/latest"><img src="https://camo.githubusercontent.com/bdf2d208096d374786c38ff484f2941dd725198ff06faf9d6b8cbe25f8038a7c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f646f776e6c6f6164732f7265636579756b692f737461626c652d646966667573696f6e2d70726f6d70742d7265616465722f746f74616c" alt="GitHub releases" /></a> <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/blob/master/LICENSE"><img src="https://camo.githubusercontent.com/dc5def4b4db8b871cbf3c520de502799715e8fbc3f4174a1b659320f160d4c23/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7265636579756b692f737461626c652d646966667573696f6e2d70726f6d70742d726561646572" alt="GitHub" /></a> <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/releases/latest"><img src="https://camo.githubusercontent.com/691dd25dbc94d9add8a8fd1304c3314a85ee5ab5cc23d9d67290437c15e243f4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f7265636579756b692f737461626c652d646966667573696f6e2d70726f6d70742d726561646572" alt="GitHub release (latest by date)" /></a> <a target="_blank" rel="ugc" href="https://pypi.org/project/sd-prompt-reader/"><img src="https://camo.githubusercontent.com/e0895f029de6db1f9353e21ba0e2eae91bca4dbe0c925ad3ef02f55bd9658494/68747470733a2f2f696d672e736869656c64732e696f2f707970692f762f73642d70726f6d70742d726561646572" alt="PyPI" /></a> <a target="_blank" rel="ugc" href="https://github.com/psf/black"><img src="https://camo.githubusercontent.com/5bf9e9fa18966df7cb5fac7715bef6b72df15e01a6efa9d616c83f9fcb527fe2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f64652532307374796c652d626c61636b2d3030303030302e737667" alt="Code style: black" /></a> <a target="_blank" rel="ugc" href="https://camo.githubusercontent.com/6ec05103651cce18813d7ded585d67708d211675c9bd4d930c4aacd830f45328/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f706c6174666f726d2d77696e646f77732532302537432532306d61636f732532302537432532306c696e75782d6c6967687467726579"><img src="https://camo.githubusercontent.com/6ec05103651cce18813d7ded585d67708d211675c9bd4d930c4aacd830f45328/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f706c6174666f726d2d77696e646f77732532302537432532306d61636f732532302537432532306c696e75782d6c6967687467726579" alt="platform" /></a>The SD Prompt Reader is now available as a ComfyUI node. Check out the <a target="_blank" rel="ugc" href="https://github.com/receyuki/comfyui-prompt-reader-node">ComfyUI Prompt Reader Node</a> for more information.A simple standalone viewer for reading prompts from Stable Diffusion generated image outside the webui.There are many great prompt reading tools out there now, but for people like me who just want a simple tool, I built this one.No additional environment or command line or browser is required to run it, just open the app and drag and drop the image in.<h2 id="features-4uv184x3z">Features</h2><ul><li>Support macOS, Windows and Linux.</li><li>Provides both GUI and CLI</li><li>Simple drag and drop interaction.</li><li>Copy prompt to clipboard.</li><li>Remove prompt from image.</li><li>Export prompt to text file.</li><li>Edit or import prompt to images</li><li>Vertical orientation display and sorting by alphabet</li><li>Detect generation tool.</li><li>Multiple formats support.</li><li>Dark and light mode support.</li></ul><h2 id="supported-formats-65juvpa9m">Supported Formats</h2><ul><li><a target="_blank" rel="ugc" href="https://github.com/AUTOMATIC1111/stable-diffusion-webui">A1111's webUI</a><ul><li>PNG</li><li>JPEG</li><li>WEBP</li><li>TXT</li></ul></li><li><a target="_blank" rel="ugc" href="https://github.com/easydiffusion/easydiffusion">Easy Diffusion</a><ul><li>PNG</li><li>JPEG</li><li>WEBP</li></ul></li><li><a target="_blank" rel="ugc" href="https://github.com/Stability-AI/StableSwarmUI">StableSwarmUI</a>*<ul><li>PNG</li><li>JPEG</li></ul></li><li><a target="_blank" rel="ugc" href="https://github.com/Stability-AI/StableSwarmUI">StableSwarmUI (prior to 0.5.8-alpha)</a>*<ul><li>PNG</li><li>JPEG</li></ul></li><li><a target="_blank" rel="ugc" href="https://github.com/MoonRide303/Fooocus-MRE">Fooocus-MRE</a>*<ul><li>PNG</li><li>JPEG</li></ul></li><li><a target="_blank" rel="ugc" href="https://novelai.net/">NovelAI (stealth pnginfo)</a><ul><li>PNG</li><li>WEBP</li></ul></li><li><a target="_blank" rel="ugc" href="https://novelai.net/">NovelAI (legacy)</a><ul><li>PNG</li></ul></li><li><a target="_blank" rel="ugc" href="https://github.com/invoke-ai/InvokeAI">InvokeAI</a><ul><li>PNG</li></ul></li><li><a target="_blank" rel="ugc" href="https://github.com/invoke-ai/InvokeAI">InvokeAI (prior to 2.3.5-post.2)</a><ul><li>PNG</li></ul></li><li><a target="_blank" rel="ugc" href="https://github.com/invoke-ai/InvokeAI">InvokeAI (prior to 1.15)</a><ul><li>PNG</li></ul></li><li><a target="_blank" rel="ugc" href="https://github.com/comfyanonymous/ComfyUI">ComfyUI</a>*<ul><li>PNG</li></ul></li><li><a target="_blank" rel="ugc" href="https://drawthings.ai/">Draw Things</a><ul><li>PNG</li></ul></li><li>Naifu(4chan)<ul><li>PNG</li></ul></li></ul>* Limitations apply. See <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader#TXT">format limitations</a>.If you are using a tool or format that is not on this list, please help me to support your format by uploading the original file generated by your tool to the <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/issues">issues</a>, thx.For ComfyUI users, the SD Prompt Reader is now available as a ComfyUI node. The <a target="_blank" rel="ugc" href="https://github.com/receyuki/comfyui-prompt-reader-node">ComfyUI Prompt Reader Node</a> is a subproject of this project, and it is recommended to embed the <a target="_blank" rel="ugc" href="https://github.com/receyuki/comfyui-prompt-reader-node#prompt-saver-node--parameter-generator-node">Prompt Saver node</a> in the <a target="_blank" rel="ugc" href="https://github.com/receyuki/comfyui-prompt-reader-node">ComfyUI Prompt Reader Node</a> within your workflow to ensure maximum compatibility.<h2 id="download-6fmc70ib8">Download</h2><h3 id="for-windows-users-oxv7dpbdk">For Windows users</h3>Download executable from above or from the <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/releases/latest">GitHub Releases</a><h3 id="for-macos-users-k48wofemk">For macOS users</h3>Download executable from above or from <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/releases/latest">GitHub Releases</a>Install via Homebrew CaskYou may also install SD Prompt Reader via <a target="_blank" rel="ugc" href="http://brew.sh/">Homebrew</a> cask.<pre><code>brew install --no-quarantine receyuki/sd-prompt-reader/sd-prompt-reader</code></pre>The parameter <code>--no-quarantine</code> is used since the SD Prompt Reader is currently unsigned as I mentioned <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader#sd-prompt-readerapp-is-damaged-and-cant-be-opened-you-should-move-it-to-the-trash">here</a><h3 id="for-linux-users-(not-regularly-tested)-gi3j1uedi"><a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader#for-linux-users-not-regularly-tested">For Linux users (not regularly tested)</a></h3><h2 id="usage-zjup7a6yd">Usage</h2><h3 id="read-prompt-td9ypyrr2">Read prompt</h3><ul><li>Open the executable file (.exe or .app) and drag and drop the image into the window.</li></ul>OR<ul><li>Right click on the image and select open with SD Prompt Reader</li></ul>OR<ul><li>Drag and drop the image directly onto executable (.exe or .app).</li></ul><h3 id="export-prompt-to-text-file-qr8uputwk">Export prompt to text file</h3><ul><li>Click "Export" will generate a txt file alongside the image file.</li><li>To save to another location, click the expand arrow and click "select directory". <img src="https://github.com/receyuki/stable-diffusion-prompt-reader/raw/master/images/export.png" alt="export" /></li></ul><h3 id="remove-prompt-from-image-0g1j4voc1">Remove prompt from image</h3><ul><li>Click "Clear" will generate a new image file with suffix "_data_removed" alongside the original image file.</li><li>To save to another location, click the expand arrow and click "select directory".</li><li>To overwrite the original image file, click the expand arrow and click "overwrite the original image". <img src="https://github.com/receyuki/stable-diffusion-prompt-reader/raw/master/images/remove.png" alt="export" /></li></ul><h3 id="edit-image-2t6f8ccns">Edit image</h3>Please note that the edited image will be written in A1111 format, it meaning that image in any format will become A1111 format after editing.<ul><li>Click "Edit" to enter edit mode.</li><li>Edit the prompt directly in the textbox or import a metadata file in txt format.</li><li>Click "Save" will generate a edited image file with suffix "_edited" alongside the original image file.</li><li>To save to another location, click the expand arrow and click "select directory".</li><li>To overwrite the original image file, click the expand arrow and click "overwrite the original image". <img src="https://github.com/receyuki/stable-diffusion-prompt-reader/raw/master/images/save.png" alt="save" /></li></ul><h3 id="copy-as-single-line-prompt-t1stg747f">Copy as single line prompt</h3>Copy image prompt and setting in a format that can be read by <a target="_blank" rel="ugc" href="https://github.com/AUTOMATIC1111/stable-diffusion-webui/wiki/Features#prompts-from-file-or-textbox">Prompts from file or textbox</a><a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/tree/v1.3.2#copy-as-single-line-prompt">Supported parameters</a><ul><li>Click the expand arrow and click "single line prompt".</li><li>Paste it into the textbox below the webui script "Prompts from file or textbox". <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/raw/master/images/single_line_prompt.png"><img src="https://github.com/receyuki/stable-diffusion-prompt-reader/raw/master/images/single_line_prompt.png" alt="single line prompt" /></a></li></ul><h3 id="comfyui-sdxl-workflow-jkl3dpch3">ComfyUI SDXL workflow</h3>The SDXL workflow does not support editing. If necessary, please remove prompts from image before edit. If the image's workflow includes multiple sets of SDXL prompts, namely Clip G(text_g), Clip L(text_l), and Refiner, the SD Prompt Reader will switch to the multi-set prompt display mode as shown in the image below. There are two interface options available for the multi-set prompt display mode, and you can switch between them using buttons. <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/raw/master/images/comfyui_sdxl.png"><img src="https://github.com/receyuki/stable-diffusion-prompt-reader/raw/master/images/comfyui_sdxl.png" alt="comfyui_sdxl.png" /></a><h2 id="cli-n7ncv7tay"><a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/tree/v1.3.5#cli">CLI</a></h2><h2 id="format-limitations-8537193dk">Format Limitations</h2><h3 id="txt-3d98coyxr">TXT</h3><ol><li>Importing txt file is only allowed in edit mode.</li><li>Only A1111 format txt files are supported. You can use txt files generated by the A1111 webui or use the SD prompt reader to export txt from A1111 images</li></ol><h3 id="stableswarmui-9sxc5zalu">StableSwarmUI</h3>StableSwarmUI is still in the Alpha testing phase, and its format may change in the future. I will keep track of upcoming updates of StableSwarmUI.<h3 id="comfyui-wkiyggvzb">ComfyUI</h3><ol><li>If there are multiple sets of data (seed, steps, CFG, etc.) in the setting box, this means that there are multiple KSampler nodes in the flowchart.</li><li>Due to the nature of ComfyUI, all nodes and flowcharts in the workflow are stored in the image, including those that are not being used. Also, a flowchart can have multiple branches, inputs and outputs. (e.g. output hires. fixed image and original image simultaneously in a single flowchart) SD Prompt Reader will traverse all flowcharts and branches and display the longest branch with complete input and output.</li><li><a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader#comfyui-sdxl-workflow">ComfyUI SDXL workflow</a></li><li>When custom nodes are used or when the workflow becomes overly complex, there is a high probability that metadata may not be correctly read. This is because ComfyUI does not store metadata but only the complete workflow. It is recommended to embed the <a target="_blank" rel="ugc" href="https://github.com/receyuki/comfyui-prompt-reader-node#prompt-saver-node--parameter-generator-node">Prompt Saver node</a> in the <a target="_blank" rel="ugc" href="https://github.com/receyuki/comfyui-prompt-reader-node">ComfyUI Prompt Reader Node</a> within your workflow to ensure maximum compatibility.</li></ol><h3 id="easy-diffusion-25i888e4c">Easy Diffusion</h3>By default, Easy Diffusion does not write metadata to images. Please change the Metadata format in settings to embed to write the metadata to images<h3 id="fooocus-mre-v3q46cy3b">Fooocus-MRE</h3>Since the original version of <a target="_blank" rel="ugc" href="https://github.com/lllyasviel/Fooocus">Fooocus</a> does not support writing metadata to image files, SD Prompt Reader only supports images generated by <a target="_blank" rel="ugc" href="https://github.com/MoonRide303/Fooocus-MRE">Fooocus MoonRide Edition</a>.<h2 id="faq-as6a4o4ff">FAQ</h2><h3 id="malware-alert-vjcmnvsl5">Malware Alert</h3>The false positive reported by some anti-malwares is caused by the packaging tool pyinstaller which is a common issue for pyinstaller users. I spent a lot of time trying to fix the Windows Defender false positive before, but I couldn't do it for every antivirus software. So, you can either trust Windows Defender or use the instruction for Linux users to use this app.<h3 id="&quot;sd-prompt-reader.app&quot;-is-damaged-and-can't-be-opend.-you-should-move-it-to-the-trash-xifb492l3">"SD Prompt Reader.app" is damaged and can't be opend. You should move it to the Trash</h3>This is a very common macOS issue when you run non appstore apps, and developers must pay $99 per year to Apple to eliminate this issue. You can choose to Allow Apps from Anywhere in security &amp; privacy settings which can be dangerous. The way I prefer is to remove the quarantine attributes.<ol><li>Open Terminal from the Applications folder.</li><li>Type in the following command and hit Enter.<code>xattr -r -d com.apple.quarantine /path/to/app.app</code>In my case it's<code>xattr -r -d com.apple.quarantine /Applications/SD\ Prompt\ Reader.app</code></li></ol>If you are still concerned about the security of the app you can use the instruction for Linux users to use this app.<h2 id="todo-uqmacc2uk">TODO</h2><ul><li>Batch image processing tool</li><li>Gallery/Folder view</li><li>User preference</li></ul><h2 id="credits-swtyt4hxg">Credits</h2><ul><li>Inspired by <a target="_blank" rel="ugc" href="https://github.com/AUTOMATIC1111/stable-diffusion-webui/">Stable Diffusion web UI</a></li><li>App icon generated using Stable Diffusion with <a target="_blank" rel="ugc" href="https://huggingface.co/jvkape/IconsMI-AppIconsModelforSD">IconsMI</a></li><li>Special thanks to <a target="_blank" rel="ugc" href="https://github.com/Azusachan">Azusachan</a> for providing SD server</li><li>The NovelAI stealth pnginfo parser is based on <a target="_blank" rel="ugc" href="https://github.com/NovelAI/novelai-image-metadata">the official metadata extraction script of NovelAI</a></li></ul>

Stable Diffusion Prompt Reader

Starting from v1.3.5, the command line tool has been added to the SD Prompt Reader on all platforms, please see the <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader?tab=readme-ov-file#cli">CLI section</a> for details.The SD Prompt Reader is now available as a ComfyUI node. Check out the <a target="_blank" rel="ugc" href="https://github.com/receyuki/comfyui-prompt-reader-node">ComfyUI Prompt Reader Node</a> for more information.A simple API document will be added to the README later.Changes since 1.3.4<ul><li>Add new icons</li><li>Add support for NovelAI stealth pnginfo <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/discussions/71">#71</a> <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/issues/73">#73</a></li><li>Add support for postprocessing/extras in A1111 webUI</li><li>Add <code>A1111 webUI (Postprocessing)</code> for generation tool detection</li><li>Add CLI <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader/discussions/69">#69</a></li><li>Add CLI/GUI detection mechanism</li><li>Add a separate CLI executable for Windows</li><li>Add parsing success determination mechanism to the ComfyUI parser <a target="_blank" rel="ugc" href="https://github.com/receyuki/comfyui-prompt-reader-node/issues/68">receyuki/comfyui-prompt-reader-node#68</a></li><li>Add functionality to export/copy metadata for ComfyUI images that cannot be parsed</li><li>Add user-friendly warnings</li><li>Add Logger</li><li>Fix display glitch caused by switching setting modes</li><li>Fix support for uppercase suffix images</li><li>Fix the handling of empty images</li><li>Fix the handling of parsing exceptions</li><li>Update pillow to 10.3.0</li></ul>For macOS usersIf you previously installed SD Prompt Reader via <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader#install-via-homebrew-cask">Homebrew</a> cask, you can upgrade with<pre><code>brew upgrade sd-prompt-reader</code></pre>For Linux users (and other users)If you previously installed SD Prompt Reader with <a target="_blank" rel="ugc" href="https://github.com/receyuki/stable-diffusion-prompt-reader#install-with-pip-or-pipx">pip or pipx</a>, you can upgrade with<pre><code>pip install --upgrade sd-prompt-reader</code></pre>or<pre><code>pipx upgrade sd-prompt-reader</code></pre>

Files with SHA256: f3c56060f3499d2047f106f7da62e4203858b411722e6e161e898b7ad86f46d4