haukesomm/apple-photos-export
GitHub: haukesomm/apple-photos-export
一款用 Rust 编写的命令行工具,可安全地将 macOS Photos 图库中的照片和视频导出到本地目录,支持多种组织结构和同步功能。
Stars: 26 | Forks: 3
# apple-photos-export

此实用程序可将 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 图库导出资产的示例,可用作入门参考。
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-export标签:Apple Photos, Dry-run, HTTP工具, Mac工具, Rust, Sequoia, Tahoe, 二进制发布, 只读访问, 可视化界面, 图片整理, 媒体库管理, 开源工具, 数字取证, 数据备份, 数据迁移, 数码资产管理, 文件同步, 文档结构分析, 照片导出, 相册管理, 网络流量审计, 自动化脚本, 视频导出, 通知系统