# Edit-Exif

**Repository Path**: byack/edit-exif

## Basic Information

- **Project Name**: Edit-Exif
- **Description**: 暂时只支持修改GPS信息
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-14
- **Last Updated**: 2025-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Edit-Exif - 图片GPS信息编辑工具

## 项目介绍

Edit-Exif 是一个用于批量编辑图片 Exif GPS 信息的命令行工具。它可以直接修改指定文件夹中所有图片的 GPS 坐标信息，同时保留其他所有元数据不变，直接修改原始文件，保持文件创建时间等属性不变。

### 主要特点

- 批量处理整个文件夹中的图片
- 支持递归处理子文件夹
- 可设置纬度、经度和海拔高度
- 保留原始图片的其他所有元数据
- 直接修改原文件，不创建副本
- 支持 JPG、JPEG、TIFF、TIF 格式图片

## 安装方法

### 环境要求

- Python 3.6 或更高版本
- 依赖库：Pillow, piexif

### 安装步骤

1. 克隆或下载本项目到本地

2. 安装依赖库

```bash
pip install -r requirements.txt
```

或直接安装所需依赖：

```bash
pip install pillow>=9.0.0 piexif>=1.1.3
```

3. 确保脚本具有执行权限

```bash
chmod +x edit_exif_gps.py
```

## 使用方法

### 基本用法

```bash
python edit_exif_gps.py 图片文件夹路径 --lat 纬度值 --lon 经度值 [--alt 海拔高度] [--recursive]
```

### 参数说明

- `图片文件夹路径`：必填，包含需要处理的图片的文件夹路径
- `--lat`：必填，纬度值（十进制格式，如: 39.9042）
- `--lon`：必填，经度值（十进制格式，如: 116.4074）
- `--alt`：可选，海拔高度（米，默认为0）
- `--recursive` 或 `-r`：可选，是否递归处理子文件夹中的图片

### 使用示例

1. 修改单个文件夹中所有图片的GPS信息：

```bash
python edit_exif_gps.py ./photos --lat 39.9042 --lon 116.4074
```

2. 修改文件夹及其子文件夹中所有图片的GPS信息，并设置海拔：

```bash
python edit_exif_gps.py ./photos --lat 39.9042 --lon 116.4074 --alt 43.5 --recursive
```

## 注意事项

- **此工具会直接修改原始图片文件**，请在使用前备份重要图片
- 只有 JPG、JPEG、TIFF、TIF 格式的图片支持 Exif 修改，其他格式会被自动跳过
- 纬度和经度使用十进制格式（非度分秒格式），北纬和东经为正值，南纬和西经为负值，[高德地图经纬度拾取](https://lbs.amap.com/tools/picker)
- 海拔高度单位为米，海平面以上为正值，海平面以下为负值

## 常见问题

### Q: 如何查看图片的当前GPS信息？

A: 您可以使用许多图片查看工具或专业的Exif查看器，如ExifTool、图片属性查看器等。

### Q: 为什么有些图片处理失败？

A: 可能的原因包括：图片文件损坏、图片被锁定或没有写入权限、图片格式虽然是支持的扩展名但内部格式不兼容等。

### Q: 如何批量清除图片的GPS信息？

A: 您可以使用本工具，但不设置有效的GPS坐标（例如设置为0,0），或者使用专业的Exif编辑工具。

## 许可证

本项目采用 MIT 许可证。