Metadata-Version: 2.4
Name: sdgp
Version: 0.91.0
Summary: sdgp - Stable Diffusion Get Prompt
Author: Twinkle Computing
Author-email: Twinkle Computing <twinkle@twinkle.work>
License-Expression: GPL-3.0-or-later AND LicenseRef-ResistPsychiatricTerror-1.0-or-later
Project-URL: Homepage, https://github.com/ScrapWareOrg/sdgp
Project-URL: Issues, https://github.com/ScrapWareOrg/sdgp
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE.GPLv3
License-File: LICENSE.RPTv1
Dynamic: license-file

[[Installation()](#Installation)] [[sd-get-prompt (Native C Version)](https://github.com/ScrapWare/sd-get-prompt)]
---
# SDGP(Stable-Diffusion-Get-Prompt)

Easy display for Stable Diffusion tEXt(Meitu iTXt) Exif data. Anyone can copy and paste from GTK+ dialog.

Sample picture is Japanese language but everybodは can understanding through SD(Stable Diffusion) icon picture on right click menu.

Showing Creation AI Configuration Info.

-----
# Usage (Python Module)

1. Use as Library

```markdown
from sdgp import sdgp

# return dict of iTXt contents
dict = sdgp(path)
```

2. commandline

```markdown
python -m sdgp -i PATH
```
-----
# Usage (Right Clickable)

How to use?

1. Run to python -m sdgp -i *PATH*

-----
## KDE

1. create .desktop file.
2. place to .kde/share/kde4/services/ServiceMenus/

````markdown
[Desktop Entry]  
Version=1.0  
Type=Application  
Name=sd-get-prompt  
Comment=Get tEXt parametor  
Exec=python -m sdgp -i %f
ServiceTypes=KonqPopupMenu/Plugin  
MimeType=image/png  
Icon=applications-graphics  
Path=  
Terminal=false  
StartupNotify=true  
````

& Apply to KDE Dolphin service dir and good changes.

-----
## XFce

1. Add right-click action for thunar(python -m sdgp -i %f)

![sample](https://raw.githubusercontent.com/ScrapWareOrg/sdgp/refs/heads/main/xfce-sample.png)

-----
## Others

for Other wm(window Manager) and file manager.

1. Should be reading your file manager manpages. May be could under run Linux Mint and other Cinnamon distribution and Gnome Nautilus, measure file manager too.

-----
## Microsoft Windows

GLib and GTK+ needed(MingW, CYgwin, Others).

-----
# <a id="Installation" name="Installation">Installation</a>

This package includes C extensions that require compilation during installation. Therefore, your system needs to have the necessary development environment set up.

---
## Prerequisites for Compilation

Before installing the package, ensure the following development tools and libraries are installed on your system:

 * C/C++ Compiler: Such as GCC on Linux, Clang on macOS, or MinGW-w64 on Windows.
 * pkg-config: A utility used to find compiler and linker flags for installed libraries.
 * GTK 3 Development Files: The development headers and libraries for GTK 3.
 * libpng Development Files: The development headers and libraries for libpng.

---
## Installation Steps

Once the prerequisites are met, you can install the package using pip:
pip install your_package_name

(Replace your_package_name with the actual name of your package on PyPI.)
Detailed Setup Instructions by OS

---
### Linux (Debian/Ubuntu-based)

```
sudo apt update
sudo apt install build-essential pkg-config libgtk-2-dev
```

### Linux (Fedora/RHEL-based)
```
sudo dnf install @development-tools pkg-config gtk2-devel
```

### macOS

You can install the prerequisites using Homebrew:

```
brew install pkg-config gtk+2
```

### Windows

On Windows, we recommend using the MSYS2 environment with the MinGW-w64 toolchain.

 * Download and install MSYS2 from the official MSYS2 website.
 * Open the "MSYS2 MinGW 64-bit" terminal (from your Start Menu).
 * Inside the MSYS2 terminal, update the package lists and install the necessary development packages:
   pacman -Syu

```
pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-pkg-config mingw-w64-x86_64-gtk2
```

 * After installing the prerequisites, you can then run the pip install command from the same MSYS2 MinGW 64-bit terminal.
This README.md content should clearly guide users through the installation process for your package.
