108 lines
2.1 KiB
Markdown
108 lines
2.1 KiB
Markdown
# PNG Metadata Editor v1.0.0
|
|
|
|
A graphical tool for viewing and editing metadata in PNG files.
|
|
|
|
|
|
|
|
## Features
|
|
|
|
- View all metadata fields (tEXt, zTXt, iTXt chunks) in PNG files
|
|
- Add, edit, and delete metadata fields
|
|
- Pretty-print JSON-formatted values
|
|
- Copy metadata values to clipboard
|
|
- Visual indication of unsaved changes
|
|
|
|
## Installation
|
|
|
|
### Prerequisites
|
|
|
|
- Python 3.6+
|
|
- Tkinter (usually included with Python)
|
|
|
|
### Dependencies
|
|
|
|
Install required packages using pip:
|
|
|
|
```bash
|
|
pip install pillow pngmeta
|
|
```
|
|
|
|
## Usage
|
|
|
|
1. Run the application:
|
|
```bash
|
|
python png-meta-editor.py
|
|
```
|
|
|
|
2. Open a PNG file using the "Open PNG File" button
|
|
|
|
3. View metadata in the tree view on the left
|
|
4. Select a field to see its full value in the detail pane
|
|
5. Use the buttons to add, edit, or delete fields
|
|
|
|
## Building for Distribution
|
|
|
|
### Using build.py (Recommended)
|
|
|
|
1. First install the required build tools:
|
|
```bash
|
|
pip install pyinstaller
|
|
```
|
|
|
|
2. Build the application for your platform:
|
|
```bash
|
|
python build.py
|
|
```
|
|
|
|
3. The resulting executable will be in the `dist/` directory
|
|
|
|
### Manual PyInstaller Commands
|
|
|
|
#### Windows
|
|
```bash
|
|
pyinstaller --name="PNG Metadata Editor" \
|
|
--windowed \
|
|
--onefile \
|
|
--icon=AppIcon.ico \
|
|
--version-file version.txt \
|
|
png-meta-editor.py
|
|
```
|
|
|
|
#### Mac OS
|
|
```bash
|
|
pyinstaller --name="PNG Metadata Editor" \
|
|
--windowed \
|
|
--onefile \
|
|
--icon=AppIcon.icns \
|
|
--version-file version.txt \
|
|
png-meta-editor.py
|
|
```
|
|
|
|
#### Linux
|
|
```bash
|
|
pyinstaller --name="PNG Metadata Editor" \
|
|
--windowed \
|
|
--onefile \
|
|
png-meta-editor.py
|
|
```
|
|
|
|
## Required Files
|
|
|
|
For building, you'll need:
|
|
- `version.txt` (for version information)
|
|
- `AppIcon.ico` (Windows icon)
|
|
- `AppIcon.icns` (Mac icon)
|
|
- `requirements.txt` (for dependencies)
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License - see [LICENSE](LICENSE) for details.
|
|
|
|
## Author
|
|
|
|
Robert Tusa
|
|
robert@tusa.at
|
|
|
|
## Version History
|
|
|
|
- **1.0.0 (2026-01-05)**: Initial release
|