OSXPhotos:macOS 照片库的命令行管理工具

发布时间:2026/7/3 8:00:49
OSXPhotos:macOS 照片库的命令行管理工具 文章目录OSXPhotosmacOS 照片库的命令行管理工具能做什么模板系统是亮点安装和使用适合谁用OSXPhotosmacOS 照片库的命令行管理工具用 Mac 的人照片库里多少都攒了几千上万张照片。时间一长想找某张特定的照片或者把照片按某种规则导出来光靠 Photos 自带的功能就很吃力。OSXPhotos 这个项目就是为了解决这类问题而生的。它是一个 Python 写的命令行工具能直接读取 Apple Photos 的数据库查询照片的各种元数据也能批量导出照片。项目在 GitHub 上有 3,640 个 Star算是一个小众但实用的工具。能做什么OSXPhotos 的核心能力是查询和导出。查询方面它能读取 Photos 数据库里几乎所有的元数据文件名、文件路径、关键词标签、人脸信息、相册归属、拍摄地点、拍摄时间这些都能作为查询条件。比如你想找出所有标记了旅行关键词的照片或者找出某个特定人物的所有照片一条命令就能搞定。导出方面它的灵活性比 Photos 自带的导出功能强很多。你可以自定义导出的目录结构和文件命名规则。比如按年月日分文件夹按国家分文件夹甚至按关键词分文件夹都可以通过模板系统实现。文件名也能自定义可以用照片标题、原始文件名或者组合多种字段。它还支持导出编辑前后的照片、Live Photo 的视频部分、RAWJPEG 配对文件这些细节处理得很到位。模板系统是亮点OSXPhotos 最有意思的设计是它的模板系统。很多操作都支持用模板字符串来指定输出格式比如{created.year}/{created.month}会自动替换成照片的拍摄年份和月份。模板字段很多覆盖了照片的各类元数据。模板还支持设置默认值和简单的条件逻辑。比如照片有标题就用标题做文件名没有标题就用原始文件名。这种设计让批量处理变得灵活不需要写额外的脚本。安装和使用安装方式有好几种推荐用 uv 这个 Python 包管理工具一行命令就能装好。也可以用 Homebrew、pip 或者 MacPorts。如果不想装 Python 环境还可以下载预编译的可执行文件。用法上主要就是osxphotos export和osxphotos query两个命令。export 负责导出照片query 负责查询数据库。两个命令的选项都很多export 有超过 100 个选项。项目提供了详细的教程和文档可以通过osxphotos tutorial和osxphotos docs查看。系统支持方面macOS Sierra 到最新的 Tahoe 都能用Linux 上也能运行部分功能。很多高级功能只在 macOS 上可用比如和 Photos 应用的交互操作。Python 版本要求 3.10 到 3.14。适合谁用这个工具适合有大量照片需要管理的 Mac 用户。特别是那些想把照片从 Photos 里导出来做备份、迁移、或者整理的人。如果你只是偶尔导几张照片Photos 自带的导出就够了。但如果你有上万张照片想按某种规则批量导出OSXPhotos 能省很多时间。它也提供了 Python API程序员可以在自己的代码里调用做更复杂的自动化处理。比如写脚本定期备份照片库或者把照片元数据导出成 JSON 做分析。项目维护得不错文档齐全还有 Reddit 社区可以交流。对于 macOS 上的照片管理需求这是一个靠谱的选择。eddit 社区可以交流。对于 macOS 上的照片管理需求这是一个靠谱的选择。