haukesomm/apple-photos-export

GitHub: haukesomm/apple-photos-export

一款用 Rust 编写的命令行工具,可安全地将 macOS Photos 图库中的照片和视频导出到本地目录,支持多种组织结构和同步功能。

Stars: 26 | Forks: 3

# apple-photos-export ![Rust](https://img.shields.io/badge/Rust-d6a672?style=for-the-badge&logo=rust) 此实用程序可将 Apple Photos 图库中的所有图像和视频导出到本地目录以进行备份。该程序以只读方式访问图库,不会对其进行任何修改。 ## 亮点 该程序的功能包括(但不限于): - 列出图库中的所有相册 - 将 Photos 图库中的所有图像和视频导出到本地目录 - 支持不同的导出相册结构,例如: - 扁平化(默认) - 按相册 - 按年/月 - 按年/月/相册 - 恢复将资产导入图库时使用的原始文件名 - 同步模式: - 跳过已导出的资产 - 删除不再属于图库的现有资产 - 处理 JPEG/RAW 对 - Dry-run 模式,无需实际复制任何文件即可测试导出 ## 兼容性 已在以下 macOS 版本上进行了简要的兼容性测试: | Generation | Version | Compatibility | |------------|---------|---------------| | Tahoe | 26.3 | ✅ | | Tahoe | 26.2 | ✅ | | Tahoe | 26.1 | ❓ | | Tahoe | 26.0 | ✅ | | Sequioia | 15.6 | ✅ | | Sequioia | 15.5 | ❓ | | Sequioia | 15.4 | ❓ | | Sequioia | 15.3 | ❓ | | Sequioia | 15.2 | ❓ | | Sequioia | 15.1 | ❓ | | Sequioia | 15.0 | ❓ | | Sonoma | 14.6 | ❌ | | Sonoma | 14.5 | ❌ | | Sonoma | 14.4 | ❌ | | Sonoma | 14.3 | ❌ | | Sonoma | 14.2 | ❌ | | Sonoma | 14.1 | ❌ | | Sonoma | 14.0 | ❌ | 图例:兼容 (✅),尚未测试 (❓),不兼容 (❌) ## 更新日志 有关每个版本之间所做更改的概述,请查看发布页面。 ## 安装 此应用程序的构建版本会在发布时自动发布。您可以在相应的 GitHub 发布版本中找到附带的二进制文件。 在 macOS 上,安装此应用程序的首选方式是通过 Homebrew: ``` $ brew install haukesomm/repo/apple-photos-export ``` 当然,也可以在本地构建最新的提交,无需任何特殊操作: ``` cargo build ``` ## 用法 ### 列出相册 ``` $ apple-photos-export list-albums ``` ### 导出资产 ``` $ apple-photos-export export [OPTIONS] ``` 使用 `apple-photos-export export --help` 查看可用配置选项的列表。 #### 示例 以下片段展示了如何从 Photos 图库导出资产的示例,可用作入门参考。
示例用法片段 ##### 按年/月/相册结构进行完整导出 - 导出所有内容,包括隐藏的资产 - 恢复将资产导入图库时使用的原始文件名 - 按 `年/月/相册` 结构对资产进行分组 - 包含每个资产的原始版本和编辑版本 - 展平相册结构 $ apple-photos-export export -Mrfe ##### 仅包含属于一个或多个相册的资产 - 导出所有_属于_给定相册(在此例中为 `700` 和 `701`)的资产 - 相册 ID 可通过 `list-albums` 命令获取 $ apple-photos-export export -a=700,701 ##### 排除属于至少一个给定相册的资产 - 导出所有_不属于_任何给定相册(在此例中为 `700` 和 `701`)的资产 - 相册 ID 可通过 `list-albums` 命令获取 $ apple-photos-export export -A=700,701
## 贡献 随时欢迎对本项目做出贡献! 🎉 在提交 PR 时,请考虑以下要求: 1. 本项目使用约定式提交信息。如果您提交 PR,请确保您的提交结构符合要求。
标签:Apple Photos, Dry-run, HTTP工具, Mac工具, Rust, Sequoia, Tahoe, 二进制发布, 只读访问, 可视化界面, 图片整理, 媒体库管理, 开源工具, 数字取证, 数据备份, 数据迁移, 数码资产管理, 文件同步, 文档结构分析, 照片导出, 相册管理, 网络流量审计, 自动化脚本, 视频导出, 通知系统