geotag 0.1.1

Multithread geotagging of photos using EXIF and GPX data

geotag

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

特性

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

安装

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

pip install .

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

pip install geotag

使用 pipx 安装

推荐使用 pipx 进行全局隔离安装：

pipx install geotag

安装后可直接在命令行使用 geotag 命令。

用法

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

示例

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. 安装构建工具：

   pip install build twine
   

2. 构建包：

   python -m build
   

3. 上传：

   twine upload dist/*
   

License

MIT