# image_meta_data

**Repository Path**: samwan_9996/image_meta_data

## Basic Information

- **Project Name**: image_meta_data
- **Description**: A Go project for handling image metadata
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-14
- **Last Updated**: 2025-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 图片信息查看及处理工具

一个用Go语言编写的工具，用于查看和处理图片元数据，特别优化了对Stable Diffusion生成图片的支持。

## 功能特点

- 📝 显示图片基本信息（尺寸、格式等）
- 🎨 提取Stable Diffusion生成参数
  - 模型名称
  - 正向提示词
  - 反向提示词
  - 完整参数（Steps、Sampler、CFG等）
- 🧹 支持移除图片元数据
- 💾 支持PNG和JPEG格式
- 🖥️ 支持命令行和交互模式
- 🔍 支持通配符批量处理

## 安装

### 从源码编译

```bash
# 克隆仓库
git clone https://gitee.com/samwan_9996/image_meta_data.git

# 进入项目目录
cd image_meta_data

# 编译
go build
```

### 下载预编译版本

访问 [发布页面](https://gitee.com/samwan_9996/image_meta_data/releases) 下载最新版本。

## 使用方法

### 基本用法

1. 显示图片信息：
```bash
# 显示单个文件信息
./image_meta_data -i image.png

# 显示多个文件信息
./image_meta_data -i image1.png image2.png

# 使用通配符处理多个文件
./image_meta_data -i *.png                # 处理当前目录所有PNG文件
./image_meta_data -i /path/to/images/*.{png,jpg}  # 处理指定目录下的所有PNG和JPG文件
```

2. 移除元数据：
```bash
# 移除单个文件的元数据
./image_meta_data -r image.png

# 指定输出文件名
./image_meta_data -r -o output.png image.png

# 指定输出目录
./image_meta_data -r -d output_dir image.png

# 使用通配符批量移除元数据
./image_meta_data -r -d cleaned_images *.png  # 处理所有PNG文件并保存到cleaned_images目录
```

### 交互模式

### 图形界面（GUI）模式
1. 启动GUI：
```bash
./image_meta_data
 ```

2. 主要功能：
   - 打开文件夹浏览图片
   - 查看图片详细信息
   - 支持列表视图和缩略图视图
   - 文件鼠标右键操作：
     - 打开所在文件夹
     - 复制文件
     - 移动文件
     - 删除文件

## 输出图片信息示例
```plaintext
=== 图片信息 ===

文件名:
example.png

图片尺寸:
512x768

文件格式:
PNG

模型:
example_model_v1.0

正向提示词:
best quality, masterpiece, 4k, extremely detailed face...

反向提示词:
lowres, bad anatomy, bad hands...

完整参数:
Steps: 20, Sampler: DPM++ SDE, CFG scale: 8.0...
 ```

## 注意事项
1. 使用 -r 选项时，输出文件会自动添加"_nometa"后缀（除非指定了输出文件名）
2. 当处理多个文件时， -o 选项会被忽略
3. 可以同时指定多个文件进行批处理
4. 支持使用通配符（如 *.png 、 *.{png,jpg} ）批量处理文件
5. 程序会自动识别文件格式并使用相应的处理方法
6. Windows命令行执行如果没有出现窗口,请尝试set DISPLAY=:0, 再运行程序
7. 图形界面鼠标右键操作会直接删除文件而不会放到回收站或者废纸篓,请谨慎操作

## 版本历史
### v0.3.0 (2025-03-26)
- 新增图形界面（GUI）模式
- 支持文件操作（复制、移动、删除）
- 支持两种视图模式（列表视图和缩略图视图）
- 新增状态栏显示操作进度
- 支持自定义主题
### v0.2.0 (2025-03-14)
- 改进PNG元数据读取功能
- 优化输出格式
- 添加完整的SD参数支持
### v0.1.0
- 初始版本发布
- 基本的图片信息显示功能
- 元数据移除功能
## 贡献
欢迎提交Issue和Pull Request！

## 许可证
[Apache License 2.0](LICENSE)