# Meta Converter

## 概要

Meta Converter は、AI生成画像のメタデータをできるだけ保持したまま、複数の画像を PNG / WEBP / JPG に変換するためのツールです。

入力形式は PNG / WEBP / JPG に対応しています。出力形式は PNG / WEBP / JPG / 入力形式と同じ から選択できます。

## 対応AIメタデータ

- **A1111 WebUI**: PNG / WEBP / JPG  
  変換後も PNGInfo などで生成情報を読み込めるよう、メタデータを保持します。
- **ComfyUI**: PNG / WEBP / JPG  
  JPG 本体では `prompt` を優先して保持し、巨大な `workflow` は容量内に収まる場合のみ保持します。JPG への変換では、ワークフローを JSON ファイルとして別出力することもできます。設定で ON / OFF を切り替えられます。
- **NovelAI**: PNG / WEBP / JPG  
  JPG への変換では、メタデータ保持用の小さな `_meta` ファイルを別出力できます。設定で ON / OFF を切り替えられます。

## 動作環境

- Windows 10 / 11 64bit
- メモリ 8GB 以上推奨

## インストール

1. ダウンロードした ZIP ファイルを展開します。
2. 展開したフォルダ内の `Meta_Converter.exe` を実行します。

## アンインストール

展開したフォルダを削除するとアンインストールできます。

## 基本的な使い方

1. 画像が入ったフォルダを選択するか、画像ファイルまたはフォルダをドラッグアンドドロップします。
2. 出力形式、変換品質、サイズ縮小、ファイルサイズ最適化などを必要に応じて設定します。
3. `変換開始` ボタンをクリックします。

## 製品版と体験版の違い

体験版には以下の制限があります。

- 1回の処理可能枚数: 8枚まで

## 起動オプション

```text
Meta_Converter.exe <Directory path>
```

指定したディレクトリを入力フォルダとして起動します。

```text
Meta_Converter.exe <File path> [File path...]
```

指定したファイルを選択した状態で起動します。複数ファイルを指定できます。

## CLI変換

`--input` などのCLI専用オプションを指定すると、GUIを開かずにコマンドラインから変換できます。

```text
Meta_Converter.exe --input "C:\images" --output "C:\out" --to jpg --quality 90
```

```text
Meta_Converter.exe --input "C:\images\a.png" --input "C:\images\b.webp" --same-dir --to png
```

```text
Meta_Converter.exe --input "C:\images" --from png,webp,jpg --to webp --quality 80 --webp-lossless
```

```text
Meta_Converter.exe --input "C:\images" --output "C:\out" --to same --quality 85
```

```text
Meta_Converter.exe --input "C:\images" --output "C:\out" --to same --quality 80 --optimize-file-size
```

### CLIオプション

| オプション | 内容 |
| --- | --- |
| `--input`, `-i` | 入力ファイルまたは入力フォルダを指定します。複数指定できます。 |
| `--output`, `-o` | 出力フォルダを指定します。`--same-dir` 使用時は指定できません。 |
| `--same-dir` | 各入力ファイルと同じ場所に出力します。 |
| `--from` | 入力形式を指定します。`all`, `png`, `webp`, `jpg`, または `png,webp,jpg` のように指定できます。不正な形式名はエラーになります。 |
| `--to` | 出力形式を指定します。`png`, `webp`, `jpg`, `same` に対応します。`same` は入力形式と同じ形式で出力します。 |
| `--quality` | 変換品質を `0` - `100` で指定します。初期値は `80` です。 |
| `--resize` | サイズ縮小率を `10` - `100` で指定します。初期値は `100` です。 |
| `--optimize-file-size` | ファイルサイズ最適化を有効にします。ファイルサイズを小さく保存します。PNGは色数減を行います。 |
| `--webp-lossless` | WEBP出力時に可逆圧縮を使用します。 |
| `--delete-original` | 変換成功後に元ファイルを削除します。 |
| `--recursive` / `--no-recursive` | フォルダ入力時にサブフォルダを含めるか指定します。初期値は `--recursive` です。 |
| `--novelai-meta` / `--no-novelai-meta` | JPG出力時にNovelAI用 `_meta` ファイルを生成するか指定します。初期値は `--novelai-meta` です。 |
| `--comfyui-json` / `--no-comfyui-json` | JPG出力時にComfyUI workflow JSONを別出力するか指定します。初期値は `--comfyui-json` です。 |
| `--error-log-dir` | エラーログの保存先フォルダを指定します。 |
| `--log-file` | CLIログをテキストファイルへ保存します。 |
| `--json-report` | 処理結果をJSONファイルへ保存します。 |
| `--version` | バージョンを表示します。 |
| `--help` | ヘルプを表示します。 |

PowerShellで現在のフォルダにあるEXEを実行する場合は、PowerShellの仕様により `.\Meta_Converter.exe` のように `.\` を付けてください。GUI版EXEのままCLIモードを実行するため、環境によってはCMDやPowerShellが終了を待たない場合があります。その場合は `start /wait` や PowerShell の `Start-Process -Wait` を使用してください。

## 更新履歴

- v1.00 (2025/05/11) - 初回リリース  
  https://note.com/nekzuk/n/nf7481fbb6cf0
- v2.00 (2025/08/15) - Eagle 対応ほか  
  https://note.com/nekzuk/n/n58408ce641a8
- v2.50 (2025/09/18) - ComfyUI 対応ほか  
  https://note.com/nekzuk/n/nb337180883e3
- v3.00 (2025/11/07) - NovelAI 対応ほか  
  https://note.com/nekzuk/n/na7837cdb4a7b
- v3.50 (2026/02/04) - NovelAI WebP 対応  
  https://note.com/nekzuk/n/nf8f1cad57493
- v4.00 (2026/06/19) - JPG入力追加、CLI対応、圧縮対応結可
  https://note.com/nekzuk/n/nf6e3ea75825b
  
## サポート

不具合や質問は Booth のメッセージまたは X からご連絡ください。
