# PNG Metadata Editor v1.0.0

A graphical tool for viewing and editing metadata in PNG files.

![PNG Metadata Editor Screenshot](screenshot.png)

## 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