89 lines
1.7 KiB
Markdown
89 lines
1.7 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
|
|
|
|
### Mac OS (using py2app)
|
|
|
|
1. First install the required build tools:
|
|
```bash
|
|
pip install py2app
|
|
```
|
|
|
|
2. Build the application bundle:
|
|
```bash
|
|
python setup.py py2app
|
|
```
|
|
|
|
3. The resulting .app bundle will be in the `dist/` directory
|
|
|
|
### Windows (using PyInstaller)
|
|
|
|
```bash
|
|
pyinstaller --name="PNG Metadata Editor" \
|
|
--windowed \
|
|
--onefile \
|
|
--icon=AppIcon.ico \
|
|
png-meta-editor.py
|
|
```
|
|
|
|
### Linux (using PyInstaller)
|
|
|
|
```bash
|
|
pyinstaller --name="PNG Metadata Editor" \
|
|
--windowed \
|
|
--onefile \
|
|
png-meta-editor.py
|
|
```
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License - see [LICENSE](LICENSE) for details.
|
|
|
|
## Author
|
|
|
|
Robert Tusa
|
|
[Your Contact Information]
|
|
|
|
## Version History
|
|
|
|
- **1.0.0 (2026-01-05)**: Initial release
|