Metadata-Version: 2.4
Name: geotag
Version: 0.1.0
Summary: Multithread geotagging of photos using EXIF and GPX data
Author-email: mgt <mgt@oi-wiki.org>
License-Expression: MIT
Keywords: geotag,exif,gpx,cli,photo
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: tqdm>=4.67.1

# geotag

基于 exiftool 和 GPX 文件的批量图片地理标记 CLI 工具。

## 特性
- 支持多线程批量处理图片
- 支持灵活的日期表达式过滤（如 `date > 20250101 and date < 20260101`）
- 支持 dry-run 预览
- 自动分发任务到多线程

## 安装

1. 安装 Python 3.12+
2. 安装 exiftool（需加入系统 PATH）
3. 安装本工具：

```sh
pip install .
```

或直接通过 PyPI（发布后）：

```sh
pip install geotag
```

## 用法

```sh
geotag <图片目录> <gpx文件1> [gpx文件2 ...] <日期表达式> [--threads N] [--dry-run]
```

### 示例

```sh
geotag ./photos track1.gpx "date > 20250101"
geotag ./photos track1.gpx track2.gpx "date > 20250101 and date < 20260101" --threads 8
```

- `<图片目录>`：待处理图片的文件夹
- `<gpx文件>`：一个或多个 GPX 轨迹文件
- `<日期表达式>`：如 `date > 20250101` 或 `date > 20250101 and date < 20260101`
- `--threads`：线程数（可选，默认自动）
- `--dry-run`：仅显示将要执行的命令，不实际修改文件

## 日期表达式语法
- 支持 `date >`, `<`, `=`, `>=`, `<=`, `!=` 等比较
- 支持 `and`, `or` 逻辑组合，支持括号
- 日期格式支持：
  - `YYYYMMDD`（如 20250101）
  - `YYYY-MM-DD`、`YYYY/MM/DD`
  - ISO 8601（如 2025-05-25T10:00:00+08:00）
  - Unix 时间戳（秒）

## 依赖
- Python 3.12+
- exiftool

## 发布到 PyPI
1. 安装构建工具：
   ```sh
   pip install build twine
   ```
2. 构建包：
   ```sh
   python -m build
   ```
3. 上传：
   ```sh
   twine upload dist/*
   ```

## License
MIT
