Google フォトのエクスポート→gpthの利用で苦労した話

Googleフォトのデータを整理しようと思い立ち、Google Takeout でエクスポートした写真を Google Photos Takeout Helper（gpth） で整頓しようとしたところ、予想外のトラブルにどっぷりハマりました。

結論から言うと、フォルダ名が原因で gpth が動かないという、かなり気づきにくい落とし穴でした。 同じ状況で困っている人の助けになればと思い、今回の体験をまとめておきます。

■ 発生したエラー：「I couldn't find any D」

gpth を実行すると、毎回このメッセージで止まってしまいました。

I couldn't find any D: reasons for this may be:

 - you've already ran gpth and it moved all photos to output

 - your Takeout doesn't have any "year folders"

要するに 「年フォルダが見つからない」 と言われているわけですが、実際には Takeout の中に 1970、2003、2005… といったフォルダはちゃんと存在していました。

■ 試したこと（全部ダメ）

• フォルダ名を「2005 年の写真」→「2005」に変更
• 「Google フォト」フォルダを作って年フォルダを入れ直す
• JSONモードで実行
• 管理者権限で実行
• ZIPを再展開
• 最新版（v3.4.3）を使用
• dtplife.com の手順と照合
• ソースコードを読み、フォルダ検出ロジックを追跡

どれも効果なし。

■ 原因：gpthは「Photos from yyyy」形式しか認識しない

最終的に分かったのは、gpthの年フォルダ判定ロジックが “Photos from 2020” のような英語形式を前提にしているということでした。

日本語環境の Takeout では「2005 年の写真」のようなフォルダ名になるため、gpth はそれを年フォルダとして認識できません。

さらに、単に「2005」とリネームしてもダメで、
「Photos from 2005」 のように英語形式にしないと認識されませんでした。

■ 解決方法

✔ 年フォルダをすべて「Photos from yyyy」にリネームする

例：

• 2005 年の写真 → Photos from 2005
• 2010 年の写真 → Photos from 2010
• 2023 年の写真→ Photos from 2023

この形式に揃えたところ、gpth が正常に年フォルダを認識し、無事に処理が完了しました。

■ おわりに

今回のトラブルは、「フォルダ名の仕様」という意外なところに原因がありました。
同じ問題で悩んでいる人の助けになれば嬉しいです。