用 exiftool 修复 Google Takeout 照片日期:实测命令和坑
实测过的 exiftool 命令:把 Google Takeout .json 里的 photoTakenTime 和 GPS 写进照片,修正 Windows 文件日期,处理被截短的附属文件名。
exiftool 可以免费修好 Google Takeout 的导出。一条命令把每个 .json 附属文件里的 photoTakenTime 复制进照片的 DateTimeOriginal 和文件日期,再加四个参数就能写入 GPS 位置。大多数照片这样就好了。被截短的附属文件名、(1) 重复、-edited 副本和视频,要加上下面的额外步骤才不会漏掉。这页的每条命令都用 ExifTool 13.59 在一个 Takeout 样例文件夹上实测过。
不想用命令行的话,直接跳到文末的图形界面方案。
这些命令解决什么问题
Google Takeout 给你的每张照片旁边都有一个小 .json 文件:
IMG_1234.jpg
IMG_1234.jpg.supplemental-metadata.json
附属文件里,真实的拍摄时间是 photoTakenTime.timestamp,即 1970 年以来的秒数,按 UTC 计;位置是 geoData.latitude 和 geoData.longitude。很多照片文件内部根本没有日期,比如截图、聊天软件里的图片,以及在 Google 相册里改过日期的照片。电脑只好显示下载那天。exiftool 能读 JSON 文件,把这些值当作标签使用:PhotoTakenTimeTimestamp、GeoDataLatitude、GeoDataLongitude 和 Description。
2024 年以前的导出,附属文件叫 IMG_1234.jpg.json;新的叫 .supplemental-metadata.json。格式详解见 supplemental-metadata.json 是什么。
第 1 步:安装 exiftool
- Windows: 从 exiftool.org 下载 Windows 的 zip,解压,把
exiftool(-k).exe改名为exiftool.exe。放进 PATH 里的某个文件夹,或者放在Takeout所在的文件夹里。 - Mac:
brew install exiftool,或者用 exiftool.org 上的安装包。 - Linux:
sudo apt install libimage-exiftool-perl(Debian、Ubuntu)或sudo dnf install perl-Image-ExifTool(Fedora)。
用 exiftool -ver 确认装好了。
第 2 步:把所有分卷解压到同一个文件夹
exiftool 读不了 zip 里面的文件。把所有 Takeout 分卷解压到同一个文件夹,得到一个 Takeout/Google Photos 文件夹。一张照片和它的附属文件常常分在不同的分卷里。做法见 Google Takeout 多个 zip 分卷怎么解压。
第一次在副本上操作。 exiftool 会直接改写你的文件。
第 3 步:给 exiftool 找不到的附属文件改名
主命令根据照片的文件名拼出附属文件名。有三类附属文件会打破这个规则,在真实的导出里通常有几百个。下面这个 Bash 脚本先把它们改成标准名字(Mac 终端、Linux,或 Windows 上的 Git Bash 和 WSL)。在 Takeout 所在的文件夹里运行:
cd "Takeout/Google Photos"
# 1. 重复照片:IMG_1234.jpg.supplemental-metadata(1).json -> IMG_1234(1).jpg.supplemental-metadata.json
find . -name '*(*).json' | while IFS= read -r j; do
n=$(echo "$j" | sed -E \
-e 's/\.([A-Za-z0-9]+)\.supplemental-metadata\(([0-9]+)\)\.json$/(\2).\1.supplemental-metadata.json/' \
-e 's/\.([A-Za-z0-9]+)\(([0-9]+)\)\.json$/(\2).\1.json/')
[ "$n" != "$j" ] && mv -n "$j" "$n"
done
# 2. 截短的文件名:Google 把附属文件名在 .json 之前截到 46 个字符
find . -type f ! -name '*.json' | while IFS= read -r p; do
[ -e "$p.supplemental-metadata.json" ] || [ -e "$p.json" ] && continue
f="$(basename "$p").supplemental-metadata"
c="$(dirname "$p")/${f:0:46}.json"
[ -e "$c" ] && mv -n "$c" "$p.supplemental-metadata.json"
done
# 3. 旧格式:IMG_1234.jpg.json -> IMG_1234.jpg.supplemental-metadata.json
find . -type f -name '*.json' ! -name '*.supplemental-metadata.json' ! -name 'metadata.json' | while IFS= read -r j; do
p="${j%.json}"
[ -e "$p" ] && [ ! -e "$p.supplemental-metadata.json" ] && mv -n "$j" "$p.supplemental-metadata.json"
done
cd ../..
跑完之后,几乎每个附属文件都叫 <照片文件名>.supplemental-metadata.json,一个命令模式就能全部找到。mv -n 不会覆盖任何文件。每种情况的解释见 ExifTool 和 supplemental-metadata.json(英文)。
在没有 Bash 的 Windows 上,可以跳过这一步。主命令照样能修好附属文件名是标准名字的照片,剩下的第 7 步会列出来。
第 4 步:把日期和 GPS 写进照片
这是主命令,用于 Mac 和 Linux 终端:
TZ=Europe/Paris exiftool -r -d %s \
-tagsfromfile "%d/%F.supplemental-metadata.json" \
"-DateTimeOriginal<PhotoTakenTimeTimestamp" \
"-CreateDate<PhotoTakenTimeTimestamp" \
"-FileModifyDate<PhotoTakenTimeTimestamp" \
'-GPSLatitude<${GeoDataLatitude;$_=undef if $_==0}' \
'-GPSLatitudeRef<${GeoDataLatitude;$_=undef if $_==0}' \
'-GPSLongitude<${GeoDataLongitude;$_=undef if $_==0}' \
'-GPSLongitudeRef<${GeoDataLongitude;$_=undef if $_==0}' \
-ext jpg -ext jpeg -ext png -ext heic -ext gif \
-overwrite_original "Takeout/Google Photos"
每一部分的作用:
TZ=Europe/Paris指定把 UTC 时间戳换算成当地时间时用的时区。换成大多数照片拍摄地的时区,比如在中国拍的就用TZ=Asia/Shanghai。见下文的时区一节。-r包含所有子文件夹。-d %s告诉 exiftool 读到的值是秒数。-tagsfromfile "%d/%F.supplemental-metadata.json"指定附属文件:%d是照片所在的文件夹,%F是完整的文件名。- 三行日期分别写入拍摄时间、EXIF 创建时间和文件修改时间。
- 四行 GPS 复制位置。
$_=undef if $_==0这一段跳过 Google 写成0.0的照片,0.0的意思是「没有位置」。不加的话,这些照片会落到西非外海上。南北纬、东西经由数字的正负自动决定。 -overwrite_original让 exiftool 不要给每个文件留一个_original副本。
我们的测试里,一张时间戳为 2019 年 7 月 14 日 10:05 UTC 的照片,拍摄时间写成了 12:05,对巴黎的夏天是正确的。坐标为 0.0 的照片写上了日期、没有写 GPS,其他照片都得到了正确的位置。
如果看到 "Error opening file ... supplemental-metadata.json" 这样的警告,意思是某张照片在这个名字下没有附属文件。第 7 步会把这些文件找出来。
Windows:在命令提示符里做同样的事
在 Takeout 所在的文件夹里打开命令提示符,整行粘贴:
exiftool -r -d %s -tagsfromfile "%d/%F.supplemental-metadata.json" "-DateTimeOriginal<PhotoTakenTimeTimestamp" "-CreateDate<PhotoTakenTimeTimestamp" "-FileModifyDate<PhotoTakenTimeTimestamp" "-FileCreateDate<PhotoTakenTimeTimestamp" "-GPSLatitude<${GeoDataLatitude;$_=undef if $_==0}" "-GPSLatitudeRef<${GeoDataLatitude;$_=undef if $_==0}" "-GPSLongitude<${GeoDataLongitude;$_=undef if $_==0}" "-GPSLongitudeRef<${GeoDataLongitude;$_=undef if $_==0}" -ext jpg -ext jpeg -ext png -ext heic -ext gif -overwrite_original "Takeout\Google Photos"
和 Mac 版的区别:
-FileCreateDate设置资源管理器里显示的「创建日期」。只有 Windows(和 Mac)上有这个日期。- 命令提示符里全部要用双引号。在 PowerShell 里,GPS 那几个参数要改用单引号,因为 PowerShell 自己会解释
$_。 - exiftool 用电脑的时区设置。运行前把 Windows 的时区设成大多数照片的拍摄地。
- 写进
.bat文件时,%d、%F和%s要写成%%d、%%F和%%s。
这篇文章没能在 Windows 上实际运行这条命令。只有 Windows 才有的部分是 -FileCreateDate,官方文档说明它在 Windows 上可用。
第 5 步:编辑过的副本
IMG_1234-edited.jpg 没有自己的附属文件,它和原图共用一个。原图处理完之后,从每张原图复制日期和 GPS:
find "Takeout/Google Photos" -name '*-edited.*' | while IFS= read -r f; do
exiftool -tagsfromfile "${f/-edited/}" -DateTimeOriginal -CreateDate -FileModifyDate -GPS:all -overwrite_original "$f"
done
第 6 步:视频
MP4 和 MOV 的日期存在 QuickTime 标签里,按 UTC 存。-api QuickTimeUTC 让 exiftool 正确换算:
exiftool -r -d %s -api QuickTimeUTC \
-tagsfromfile "%d/%F.supplemental-metadata.json" \
"-CreateDate<PhotoTakenTimeTimestamp" "-ModifyDate<PhotoTakenTimeTimestamp" \
"-TrackCreateDate<PhotoTakenTimeTimestamp" "-MediaCreateDate<PhotoTakenTimeTimestamp" \
"-FileModifyDate<PhotoTakenTimeTimestamp" \
-ext mp4 -ext mov -overwrite_original "Takeout/Google Photos"
在 Windows 上,加上 "-FileCreateDate<PhotoTakenTimeTimestamp",并写成一行。实况照片的视频片段通常没有附属文件,见 Takeout 里的实况照片(英文)。
第 7 步:找出还没有日期的照片
exiftool -r -if 'not $DateTimeOriginal' -p '$Directory/$FileName' -ext jpg -ext jpeg -ext png -ext heic "Takeout/Google Photos"
这条命令列出所有仍然没有拍摄时间的照片。在 Windows 上,条件和 -p 后面的文字要用双引号。剩下的通常是完全没有附属文件的照片(见 有些照片没有 JSON(英文)),以及需要手动配对的怪名字。
可选:照片说明
你在 Google 相册里写的说明也在附属文件里:
exiftool -r -tagsfromfile "%d/%F.supplemental-metadata.json" "-ImageDescription<Description" "-XMP-dc:Description<Description" -ext jpg -ext heic -P -overwrite_original "Takeout/Google Photos"
-P 保留第 4 步设置的文件日期。之后任何往照片里写东西的 exiftool 命令,如果不加 -P,都会把文件修改时间重置成现在。
时区的坑
附属文件里存的是 UTC 的一个精确时刻。DateTimeOriginal 存的是不带时区的挂钟时间。exiftool 用运行时电脑的时区在两者之间换算。在上海 11:05 拍的照片,电脑设成北京时间就得到 11:05,设成纽约时间就变成前一天晚上。在别的时区拍的旅行照片,会差出两地的时差。只靠附属文件没法知道当地时间,所以没有完美的修法。已经带着相机日期的照片如果不想动,在第 4 步的命令里加上 -if 'not $DateTimeOriginal'。见 Takeout 照片的时间为什么差了几个小时。
图形界面方案
如果上面这些看起来要花一个晚上,确实要。不敲命令也能得到同样结果的办法有两个。
处理 Google Takeout 导出:Takeout JSON Metadata Fixer(Windows 和 Mac)。把 zip 文件拖进去,它给每张照片配上附属文件,包括截短的名字、(1) 重复、编辑过的副本、视频和实况照片的视频片段,写入拍摄日期、GPS 位置和文件日期。同一次运行里还能按年/月分文件夹、按日期重命名,并且可以先试运行。全程离线。前 500 张照片免费;高级版一次性 19.99 美元。
处理任何照片,不只是 Takeout:还是同一个软件。 Windows 版 Takeout JSON Metadata Fixer 有一个「选中的照片」标签页。点「选择图库文件夹…」选好文件夹,选中照片,再点「编辑」,就能设置拍摄日期、平移时间、修正时区、从文件名读日期、设置文件日期,或者在地图上放一个位置。它内部用的是 exiftool,每次修改都能撤销。前 100 次编辑免费,同一个高级版也会解锁其余的编辑。只想要编辑功能的话,还有一个更小的纯编辑软件 Photo Date & Metadata Editor。它和免费的 ExifToolGUI 有什么不同,见 exiftool 图形界面:Windows 上不用命令改照片日期。
完整的下载流程见 Google 相册怎么下载全部照片;几种工具的对比见 GooglePhotosTakeoutHelper 有替代品吗。
常见问题
exiftool 提示某个附属文件 "No writable tags set from",什么意思?
找到了附属文件,但里面没有可写的内容,或者文件名模式指向了一个不存在的文件。相册文件夹里的 metadata.json 也会引起这个提示,可以忽略。
exiftool 能直接处理 zip 文件吗?
不能。先把所有分卷解压到同一个文件夹。
写入日期会降低照片画质吗?
不会。exiftool 只重写元数据,图像数据不动。见 修改照片日期会降低画质吗。
该用 photoTakenTime 还是 creationTime?
photoTakenTime。creationTime 是照片上传到 Google 的时间,常常晚好几年。
为什么 -if 要用在照片上,而不是 JSON 上?
-if 条件检查的是正在被写入的照片,不是附属文件。所以上面的 GPS 命令把 0.0 的过滤写在了复制参数里面。