使用immich-go处理Google相册导出数据的完整指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01029/article/details/148601791

使用immich-go处理Google相册导出数据的完整指南

immich-go An alternative to the immich-CLI command that doesn't depend on nodejs installation. It tries its best for importing google photos takeout archives. 项目地址: https://gitcode.com/gh_mirrors/im/immich-go

前言

对于想要从Google相册迁移数据的用户来说，导出数据的处理一直是个棘手的问题。immich-go项目正是为解决这个问题而生，它能够帮助用户高效、准确地导入Google相册的导出数据。本文将深入解析Google相册导出数据的结构特点，以及immich-go如何处理这些复杂情况。

Google相册导出数据结构解析

基本目录结构

Google相册的导出数据采用了一种特殊的组织方式：

按年份分类的文件夹：包含当年拍摄的所有照片
相册文件夹：每个相册都有独立的文件夹
- 包含一个JSON元数据文件（文件名可能因用户语言而异）
- 相册标题可能为空
- 通常包含相册中的所有图片
- 这些图片通常也会出现在年份文件夹中

特殊文件夹

回收站：文件夹名称随用户语言变化（如Trash、Corbeille等）
失败视频：包含无法读取的视频文件
未命名相册：使用本地化名称加数字标识（如Untitled、Sin título等）

元数据文件分析

每张图片通常都有一个对应的JSON元数据文件，包含以下关键信息：

原始图片名称（可能与导出文件中的名称不同）
拍摄时间（时间戳格式）
GPS坐标信息
是否被删除的标志
是否共享的标志

但需要注意的是，并非所有图片都有对应的JSON文件。

文件名匹配规则

Google相册导出数据中的文件名匹配遵循一些特殊规则：

基本匹配规则：JSON文件名可以比图片文件名长1个字符
同名文件处理：
- 同年拍摄的同名文件会被编号区分
- 例如：IMG_3479.JPG、IMG_3479(1).JPG等
- 对应的JSON文件也会相应编号
编辑后文件：
- 编辑后的图片可能没有对应的JSON文件
- 编辑标记会本地化（如法语使用"-modifié"）

多语言支持问题

Google相册会根据用户语言使用不同的术语：

| 语言 | 相册文件夹名 | 元数据文件名 | 编辑标记 | | ------ | ------------ | ----------------- | -------------- | | 英语 | Google Photos | metadata.json | -edited | | 法语 | Google Photos | métadonnées.json | -modifié | | 意大利语 | Google Foto | metadati.json | -modificato | | 德语 | Google Fotos | Metadaten.json | -bearbeitet |