Takeout JSON
FR

exiftool et Google Takeout : les commandes testées pour les dates

Commandes exiftool testées qui copient photoTakenTime et le GPS des .json de Google Takeout dans vos photos, sous Windows aussi, noms coupés compris.

exiftool peut réparer gratuitement un export Google Takeout. Une commande copie photoTakenTime de chaque sidecar .json dans le DateTimeOriginal de la photo et dans la date du fichier, et quatre arguments de plus ajoutent la position GPS. Cela marche pour la plupart des photos. La commande rate les noms de sidecar coupés, les doublons (1), les copies -edited et les vidéos, sauf si vous ajoutez les étapes ci-dessous. Chaque commande de cette page a été testée avec ExifTool 13.59 sur un dossier Takeout d'exemple.

Si vous préférez éviter la ligne de commande, passez directement aux solutions avec interface graphique, en bas de page.

Le problème que les commandes résolvent

Google Takeout vous donne chaque photo à côté d'un petit fichier .json :

IMG_1234.jpg
IMG_1234.jpg.supplemental-metadata.json

Ce sidecar contient la vraie date de prise de vue sous photoTakenTime.timestamp, un nombre de secondes depuis 1970 en UTC, et le lieu sous geoData.latitude et geoData.longitude. Beaucoup de photos n'ont aucune date à l'intérieur du fichier : captures d'écran, images de messagerie, et tout ce que vous avez redaté dans Google Photos. Votre ordinateur affiche alors le jour du téléchargement. exiftool sait lire les fichiers JSON et présente ces valeurs comme des balises : PhotoTakenTimeTimestamp, GeoDataLatitude, GeoDataLongitude et Description.

Les exports d'avant 2024 nomment le sidecar IMG_1234.jpg.json. Les plus récents utilisent .supplemental-metadata.json. supplemental-metadata.json expliqué décrit le format, et pourquoi la date est fausse explique le problème de départ.

Étape 1 : installer exiftool

  • Windows : téléchargez le zip Windows sur exiftool.org, décompressez-le et renommez exiftool(-k).exe en exiftool.exe. Placez-le dans un dossier du PATH, ou dans le dossier qui contient Takeout.
  • Mac : brew install exiftool, ou le paquet d'installation d'exiftool.org.
  • Linux : sudo apt install libimage-exiftool-perl (Debian, Ubuntu) ou sudo dnf install perl-Image-ExifTool (Fedora).

Vérifiez avec exiftool -ver.

Étape 2 : décompresser toutes les parties dans un seul dossier

exiftool ne lit pas l'intérieur des fichiers zip. Décompressez toutes les parties de Takeout dans le même dossier, pour obtenir un seul dossier Takeout/Google Photos. Une photo et son sidecar sont souvent dans des parties différentes. Google Takeout en plusieurs fichiers zip montre comment faire.

Travaillez sur une copie la première fois. exiftool écrit dans vos fichiers.

Étape 3 : renommer les sidecars qu'exiftool ne trouve pas

La commande principale trouve chaque sidecar en construisant son nom à partir du nom de la photo. Trois sortes de sidecars cassent ce principe, et dans un vrai export ce sont des centaines de fichiers. Ce script Bash (Terminal sur Mac, Linux, ou Git Bash et WSL sous Windows) les renomme d'abord au nom standard. Lancez-le dans le dossier qui contient Takeout :

cd "Takeout/Google Photos"
# 1. Doublons : 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. Noms coupés : Google coupe le nom du sidecar à 46 caractères avant .json
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. Ancien style : 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 ../..

Après cela, presque chaque sidecar s'appelle <nom de la photo>.supplemental-metadata.json, et un seul motif de commande les trouve tous. mv -n n'écrase jamais un fichier. exiftool et supplemental-metadata.json (en anglais) explique chaque cas.

Sous Windows sans Bash, vous pouvez sauter cette étape. La commande principale corrige quand même chaque photo dont le sidecar porte le nom standard, et l'étape 7 liste les autres.

Étape 4 : copier la date et le GPS dans les photos

Voici la commande principale, pour le terminal Mac et 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"

Ce que fait chaque morceau :

  • TZ=Europe/Paris fixe le fuseau horaire utilisé pour transformer l'horodatage UTC en heure locale. Prenez le fuseau où la plupart de vos photos ont été prises. Voyez la section sur le fuseau horaire plus bas.
  • -r inclut tous les sous-dossiers.
  • -d %s indique à exiftool que la valeur lue est un nombre de secondes.
  • -tagsfromfile "%d/%F.supplemental-metadata.json" désigne le sidecar : %d est le dossier de la photo, %F son nom complet.
  • Les trois lignes de date écrivent la date de prise de vue, la date de création EXIF et la date de modification du fichier.
  • Les quatre lignes GPS copient la position. Le morceau $_=undef if $_==0 saute les photos auxquelles Google a donné 0.0, ce qui veut dire « pas de lieu ». Sans lui, ces photos atterrissent dans l'océan, au large de l'Afrique de l'Ouest. exiftool déduit N/S et E/O du signe du nombre.
  • -overwrite_original empêche exiftool de laisser une copie _original de chaque fichier.

Dans notre test, une photo avec un horodatage de 10 h 05 UTC le 14 juillet 2019 a reçu une date de prise de vue à 12 h 05, ce qui est juste pour Paris en été. Une photo avec des coordonnées 0.0 a reçu sa date et aucun GPS, et les autres ont reçu la bonne position.

Des avertissements comme « Error opening file ... supplemental-metadata.json » signifient qu'une photo n'a pas de sidecar sous ce nom. Ce sont les fichiers que l'étape 7 retrouve.

Attention : certains guides conseillent d'ajouter -if '$GeoDataLatitude ne 0' pour filtrer les lieux vides. Cela ne marche pas. Une condition -if est testée sur la photo, pas sur le JSON. C'est pour cela que la commande ci-dessus filtre les 0.0 à l'intérieur de l'argument de copie. Plus de détails dans photos sans localisation GPS.

Sous Windows : la même chose dans l'invite de commandes

Ouvrez l'invite de commandes dans le dossier qui contient Takeout et collez ceci sur une seule ligne :

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"

Ce qui change par rapport à la version Mac :

  • -FileCreateDate règle la date de création qu'affiche l'Explorateur Windows. Cette balise n'existe que sous Windows (et sur Mac).
  • L'invite de commandes demande des guillemets doubles partout. Dans PowerShell, mettez plutôt des guillemets simples autour des arguments GPS, car PowerShell interprète lui-même $_.
  • exiftool utilise le fuseau horaire réglé sur le PC. Réglez Windows sur le fuseau où la plupart des photos ont été prises avant de lancer la commande.
  • Dans un fichier .bat, écrivez %%d, %%F et %%s au lieu de %d, %F et %s.

Nous n'avons pas pu lancer cette version sous Windows pour cet article. La seule partie propre à Windows est -FileCreateDate, dont la documentation indique qu'elle y fonctionne. Pour le reste de la démarche sous Windows, voyez modifier la date des photos Google Takeout sous Windows.

Étape 5 : les copies retouchées

IMG_1234-edited.jpg n'a pas de sidecar à elle. Elle partage celui de l'original. Une fois les originaux traités, copiez la date et le GPS depuis chaque original :

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

Étape 6 : les vidéos

Les MP4 et MOV gardent leurs dates dans des balises QuickTime, enregistrées en UTC. -api QuickTimeUTC indique à exiftool de convertir correctement :

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"

Sous Windows, ajoutez "-FileCreateDate<PhotoTakenTimeTimestamp" et mettez tout sur une ligne. Les clips de Live Photos n'ont en général pas de sidecar ; voyez les Live Photos dans Takeout (en anglais).

Étape 7 : trouver ce qui reste sans date

exiftool -r -if 'not $DateTimeOriginal' -p '$Directory/$FileName' -ext jpg -ext jpeg -ext png -ext heic "Takeout/Google Photos"

Cette commande affiche chaque photo qui n'a toujours pas de date de prise de vue. Sous Windows, mettez des guillemets doubles autour de la condition et du texte de -p. Ce qui reste, ce sont en général des photos sans aucun sidecar (certaines photos n'ont pas de JSON, en anglais) et des noms bizarres à relier à la main.

En option : la légende

La description que vous avez tapée dans Google Photos se trouve aussi dans le sidecar :

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 garde la date de fichier réglée à l'étape 4. Toute commande exiftool ultérieure qui écrit dans les photos remet la date de modification du fichier à maintenant, sauf si vous ajoutez -P.

Le piège du fuseau horaire

Le sidecar contient un instant exact en UTC. DateTimeOriginal contient une heure d'horloge, sans fuseau. exiftool passe de l'un à l'autre avec le fuseau de votre ordinateur au moment où vous lancez la commande. Une photo prise à 12 h 05 à Paris ressort à 12 h 05 si l'ordinateur est réglé sur Paris, et à 06 h 05 s'il est réglé sur New York. Les photos de voyages dans d'autres fuseaux seront décalées de la différence. Le sidecar seul ne permet pas de connaître l'heure locale, donc il n'existe pas de correction parfaite.

Si vous voulez laisser tranquilles les photos qui ont déjà une date d'appareil, ajoutez -if 'not $DateTimeOriginal' à la commande de l'étape 4. Ici, la condition porte bien sur la photo, donc elle fait ce qu'on attend. Voyez fuseau horaire des photos Takeout.

Les solutions avec interface graphique

Si les étapes ci-dessus ressemblent à une soirée de travail, c'est qu'elles en sont une. Il existe deux façons d'obtenir le même résultat sans taper de commande.

Pour un export Google Takeout : Takeout JSON Metadata Fixer (Windows et Mac). Vous déposez les fichiers zip, sans les décompresser. L'application relie chaque photo à son sidecar, y compris les noms coupés, les doublons (1), les copies retouchées, les vidéos et les clips de Live Photos, et écrit la date de prise de vue, la position GPS et les dates du fichier. Dans le même passage, elle peut classer en dossiers Année/Mois et renommer par date, avec un essai à blanc d'abord. Elle fonctionne hors ligne. Les 500 premières photos sont gratuites ; Premium coûte 19,99 $ une seule fois.

Pour n'importe quelles photos, pas seulement Takeout : la même application. Takeout JSON Metadata Fixer pour Windows a un onglet Photos sélectionnées. Vous cliquez sur Choisir le dossier…, sélectionnez des photos et cliquez sur Modifier. Vous réglez alors la date de prise de vue, décalez l'heure, corrigez le fuseau horaire, lisez la date dans le nom du fichier, réglez les dates du fichier ou placez un lieu sur une carte. Elle utilise exiftool à l'intérieur, et chaque modification peut être annulée. Les 100 premières modifications sont gratuites, et le même Premium débloque la suite. Si vous voulez seulement l'édition, il existe aussi une application plus petite, réservée à l'édition : Photo Date & Metadata Editor (en anglais). exiftool interface graphique sous Windows la compare avec ExifToolGUI, qui est gratuit, et alternative simple à exiftool montre les tâches courantes sans commande.

D'autres outils gratuits existent aussi : GooglePhotosTakeoutHelper et immich-go. Google Photos Takeout Helper : quelle alternative les compare. Pour tout le parcours, du téléchargement à la vérification, voyez télécharger Google Photos avec les bonnes dates.

Questions fréquentes

exiftool affiche « No writable tags set from » pour un sidecar. Que signifie ce message ?

Le sidecar a été trouvé mais n'a rien donné à écrire, ou le motif de nom désignait un fichier qui n'existe pas. Les fichiers metadata.json des albums déclenchent aussi ce message et peuvent être ignorés.

exiftool fonctionne-t-il sur les fichiers zip ?

Non. Décompressez d'abord toutes les parties dans un seul dossier.

Écrire la date réduit-il la qualité de la photo ?

Non. exiftool réécrit les métadonnées et ne touche pas aux données de l'image.

Faut-il utiliser photoTakenTime ou creationTime ?

photoTakenTime. creationTime est la date d'envoi de la photo vers Google, souvent des années plus tard.

Pourquoi mettre -if sur la photo et pas sur le JSON ?

Une condition -if est testée sur la photo en cours d'écriture, pas sur le sidecar. C'est pour cela que les commandes GPS ci-dessus filtrent les valeurs 0.0 à l'intérieur de l'argument de copie.