iCloud照片下载器中的文件命名策略详解

iCloud照片下载器中的文件命名策略详解

icloud_photos_downloader A command-line tool to download photos from iCloud 项目地址: https://gitcode.com/gh_mirrors/ic/icloud_photos_downloader

前言

iCloud照片下载器是一款专门用于从iCloud下载照片和视频的工具。在实际使用过程中，文件的命名和组织方式直接影响后续的管理和使用体验。本文将全面解析该工具提供的各种文件命名策略，帮助用户根据自身需求定制下载文件的存储方式。

目录结构设置

基本概念

默认情况下，工具会根据照片的创建日期自动创建层级目录结构，格式为年/月/日。这种结构符合大多数用户按时间整理照片的习惯。

自定义目录结构

从1.7.0版本开始，工具支持通过--folder-structure参数完全自定义目录结构：

1. 禁用目录结构：使用none值可将所有文件下载到同一目录
2. 自定义格式：支持Python的strftime格式化语法，例如：
   • {:%Y}：四位年份
   • {:%m}：两位月份
   • {:%d}：两位日期
3. 多语言支持（1.22.0+）：通过--use-os-locale参数可使用系统本地化设置，特别适用于月份名称等需要本地化的场景

使用示例

# 使用中文环境下载并按"年/月"结构组织
LC_ALL=zh_CN.UTF-8 icloudpd --use-os-locale --folder-structure "{:%Y年/%m月}"

文件重名处理策略

问题背景

当不同照片具有相同文件名时，工具提供了多种处理方案：

可用策略（1.20.0+）

1. 默认策略：name-size-dedup-with-suffix

   • 自动在重名文件后添加文件大小作为后缀
   • 例如：IMG_1234-67890.JPG

2. 唯一ID策略：name-id7

   • 为每个文件添加7位唯一标识符
   • 例如：IMG_1234_QAZXSW.JPG

Live Photos处理方案

特殊考虑

Live Photos由静态图片和动态视频两部分组成，需要特殊处理命名冲突问题。

可用策略（1.18.0+）

1. 原始命名：original

   • 视频文件与静态图片同名
   • 需配合name-id7策略避免冲突

2. 后缀命名（默认）：suffix

   • 从静态图片名派生视频文件名
   • 例如：IMG_1234.HEIC对应IMG_1234_HEVC.MOV
   • 仅适用于HEIC格式的静态图片

Unicode字符处理

默认行为

出于兼容性考虑，工具默认会移除文件名中的Unicode字符（如中文、日文等）。

保留选项（1.18.0+）

通过--keep-unicode-in-filenames参数可保留原始文件名中的Unicode字符，适合需要保持原文件名完整性的场景。

最佳实践建议

1. 个人照片库：推荐使用默认的日期目录结构，配合name-size-dedup-with-suffix策略
2. 专业摄影：考虑使用name-id7策略确保每个文件有唯一标识
3. 多语言环境：启用--use-os-locale获取本地化的月份名称
4. Live Photos管理：根据后续使用场景选择适当的命名策略

通过合理组合这些选项，用户可以创建既符合个人习惯又便于长期维护的照片存储方案。

icloud_photos_downloader A command-line tool to download photos from iCloud 项目地址: https://gitcode.com/gh_mirrors/ic/icloud_photos_downloader