exportiphoto 项目下载及安装教程

1. 项目介绍

exportiphoto 是一个用于将 iPhoto 库导出为文件夹结构的 Python 脚本。该脚本支持将 iPhoto 中的照片按事件或相册导出，并可以选择将元数据写入导出的图片中。此项目最初由 Derrick Childers 编写，并经过多位开发者的修改和优化，适用于 iPhoto 8.1.2 及更高版本（来自 iLife '09）。

2. 项目下载位置

要下载 exportiphoto 项目，可以通过以下步骤从 GitHub 获取：

1. 打开终端或命令行工具。

2. 使用 git clone 命令下载项目：

   git clone https://github.com/BMorearty/exportiphoto.git
   

   这将把项目文件下载到当前目录下的 exportiphoto 文件夹中。

3. 项目安装环境配置

3.1 系统要求

• macOS 系统（建议 macOS 10.6 及以上版本）
• Python 2.6 或更高版本
• 可选：pyexiv2 库（用于将元数据写入图片）

3.2 安装 Python

确保系统中已安装 Python。可以通过以下命令检查 Python 版本：

python --version

如果未安装 Python，可以从 Python 官方网站 下载并安装。

3.3 安装 pyexiv2（可选）

如果需要将元数据写入图片，需安装 pyexiv2 库。以下是安装步骤：

1. 安装 MacPorts（如果尚未安装）：

   sudo port selfupdate
   sudo port install scons
   sudo port install exiv2
   sudo port install boost +python26
   

2. 下载并安装 pyexiv2：

   git clone https://github.com/LeoHsiao1/pyexiv2.git
   cd pyexiv2
   export CXXFLAGS="-I/opt/local/include"
   export LDFLAGS="-L/opt/local/lib -lpython2.6"
   sudo scons install
   cd /opt/local/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/site-packages/
   sudo mv libexiv2python.dylib libexiv2python.so
   

4. 项目安装方式

1. 进入下载的项目目录：

   cd exportiphoto
   

2. 将 exportiphoto.py 脚本复制到你的工作目录：

   cp exportiphoto.py ~/exportiphoto.py
   

3. 确保脚本具有执行权限：

   chmod +x ~/exportiphoto.py
   

5. 项目处理脚本

5.1 使用方法

运行以下命令来导出 iPhoto 库：

python exportiphoto.py [options] "iPhoto-Library-dir" "destination-dir"

5.2 选项说明

• -a 或 --albums：按相册导出，而不是按事件。
• -m 或 --metadata：将元数据写入导出的图片。
• -f 或 --faces：将人脸信息存储为关键词（需与 -m 一起使用）。
• -q 或 --quiet：静默模式，不输出日志。
• -d 或 --date：不使用日期前缀命名文件夹。
• -o 或 --originals：导出原始图片，而不是编辑后的图片。
• -x 或 --deconflict：避免同名文件夹冲突。
• -y 或 --yeardir：在输出目录中添加年份文件夹。
• -e DATE_DELIMITER 或 --date_delimiter=DATE_DELIMITER：设置日期分隔符（默认是 -）。
• -i 或 --import：从目标目录导入缺失的相册。
• -z IMPORT_FROM_DATE 或 --import_from_date=IMPORT_FROM_DATE：仅导入指定日期之后的文件夹。
• -t 或 --test：测试模式，不实际复制文件或导入文件夹。

5.3 示例

假设你的 iPhoto 库位于 ~/Pictures/iPhoto Library/，你希望将导出的文件夹放在 ~/iPhoto Export/，可以使用以下命令：

python exportiphoto.py "$HOME/Pictures/iPhoto Library/" "$HOME/iPhoto Export"

6. 总结

通过以上步骤，你可以成功下载、安装并使用 exportiphoto 项目，将 iPhoto 库导出为文件夹结构。根据需要，可以选择不同的选项来定制导出过程。