Télécharger Toutes les Photos et Vidéos

Téléchargez toute votre bibliothèque PixelUnion sur votre ordinateur avec immich-archiver ou Immich Go

Vous pouvez télécharger toute votre bibliothèque de photos et vidéos PixelUnion sur votre propre ordinateur. C’est utile lorsque vous souhaitez :

  • Conserver une copie locale de vos médias en plus de votre bibliothèque PixelUnion
  • Télécharger vos données avant de supprimer votre compte
  • Transférer votre bibliothèque vers un autre service
  • Garder une copie hors ligne de vos souvenirs

Il existe deux outils pour cela :

  • immich-archiver est développé et maintenu par PixelUnion. Utilisez-le pour une copie simple de toute votre bibliothèque. C’est celui que nous recommandons.
  • Immich Go est un outil communautaire offrant davantage d’options de filtrage, comme le téléchargement d’albums, de tags ou de plages de dates précis. Il est actuellement affecté par un bogue, décrit plus bas.

Les deux outils nécessitent une clé API, commencez donc par là.

Étape 1 : obtenez votre clé API

  1. Connectez-vous à votre domaine PixelUnion (par exemple https://votrenom.pixelunion.eu)
  2. Cliquez sur votre icône de profil en haut à droite
  3. Sélectionnez Paramètres du compte
  4. Allez dans Clés API
  5. Cliquez sur Nouvelle clé API
  6. Donnez-lui un nom explicite (par exemple « Outil de téléchargement »)
  7. Copiez la clé API générée, vous en aurez besoin à l’étape suivante

⚠️ Important : gardez votre clé API en sécurité et ne la partagez avec personne. Vous pourrez la révoquer plus tard si nécessaire.

immich-archiver (recommandé)

immich-archiver copie chaque photo et vidéo de votre chronologie dans des dossiers classés par date sur votre disque, et écrit à côté de chacune un fichier .json contenant toutes les métadonnées dont nous disposons : date de prise de vue, appareil photo, position GPS, appartenance aux albums, visages et notes.

Sur votre disque, cela ressemble à ceci :

PixelUnion-Backup/2005/2005-06/IMG_0001.jpg
PixelUnion-Backup/2005/2005-06/IMG_0001.jpg.json

Relancez-le plus tard et il ne téléchargera que les nouveautés, la mise à jour de votre copie est donc rapide.

Étape 2 : téléchargez immich-archiver

  1. Rendez-vous sur la page des versions d’immich-archiver
  2. Téléchargez le fichier correspondant à votre système :
    • Windows : immich-archiver_..._windows_amd64.exe
    • macOS (Apple Silicon) : immich-archiver_..._darwin_arm64
    • macOS (Intel) : immich-archiver_..._darwin_amd64
    • Linux : immich-archiver_..._linux_amd64 (ou linux_arm64 sur un Raspberry Pi par exemple)
  3. Déplacez le fichier téléchargé dans le dossier où vous voulez votre sauvegarde
  4. Renommez-le en immich-archiver (sous Windows, immich-archiver.exe). Le nom téléchargé contient le numéro de version, et le renommer permet de garder les commandes ci-dessous identiques lors des mises à jour.

Les versions macOS sont signées et notarisées auprès d’Apple, elles s’exécutent donc sans avertissement de sécurité.

Sous macOS et Linux, vous devez rendre le fichier exécutable une fois. Ouvrez un terminal dans ce dossier et lancez :

chmod +x immich-archiver

Étape 3 : lancez-le

Ouvrez un terminal dans le dossier contenant le fichier :

  • Windows : clic droit sur le dossier → « Ouvrir dans le terminal »
  • macOS : ouvrez l’application Terminal, tapez cd suivi d’un espace, faites glisser le dossier dans la fenêtre et appuyez sur Entrée
  • Linux : ouvrez un terminal et placez-vous dans le dossier

Lancez ensuite l’outil en remplaçant les valeurs par les vôtres :

Windows :

.\immich-archiver.exe --url https://votrenom.pixelunion.eu --api-key VOTRE_CLE_API --dir .\PixelUnion-Backup

macOS/Linux :

./immich-archiver --url https://votrenom.pixelunion.eu --api-key VOTRE_CLE_API --dir ./PixelUnion-Backup

Remplacez votrenom.pixelunion.eu par votre propre domaine et VOTRE_CLE_API par la clé de l’étape 1.

Pour éviter de saisir votre clé à chaque fois, vous pouvez définir des variables d’environnement : IMMICH_URL, IMMICH_API_KEY et IMMICH_DIR. Une fois définies, lancer immich-archiver seul suffit.

Options utiles

OptionCe qu’elle fait
--dry-runAffiche ce qui serait téléchargé sans rien enregistrer
--verboseAffiche une ligne par fichier au lieu d’un compteur global
--path-template "{year}/{month}/{day}"Change la structure des dossiers. Par défaut {year}/{year}-{month}
--include-sharedTélécharge aussi les albums partagés avec vous, dans un dossier shared-with-me distinct
--concurrency 8Télécharge plus de fichiers à la fois. Par défaut 4
--retries 5Réessaie plus souvent les téléchargements échoués. Par défaut 3

Lancez l’outil avec --help pour voir tout ce qu’il propose.

Immich Go (pour le filtrage avancé)

Immich Go est un outil en ligne de commande développé par la communauté. Il propose des filtres qu’immich-archiver n’a pas encore, comme limiter le téléchargement à certains albums, tags ou une plage de dates.

Bogue connu dans immich-go : noms de fichiers incorrects

Il existe un bogue connu dans immich-go affectant la commande archive from-immich. Les fichiers exportés peuvent recevoir des noms numériques incorrects (comme -1, -2) sans extension de fichier, et les métadonnées des albums peuvent être absentes de l'export. Un correctif est en cours de développement. Vous pouvez suivre l'avancement sur GitHub (PR #1272). Nous recommandons d'utiliser immich-archiver ci-dessus, ou d'attendre une version mise à jour d'immich-go avant d'utiliser cette commande.

Télécharger Immich Go

  1. Rendez-vous sur la page des versions d’Immich Go
  2. Téléchargez la version correspondant à votre système d’exploitation :
    • Windows : téléchargez le fichier .exe
    • macOS : téléchargez le fichier contenant darwin dans son nom
    • Linux : téléchargez le fichier contenant linux dans son nom
  3. Extrayez le fichier .zip téléchargé
  4. Placez l’exécutable immich-go dans un dossier où vous voulez télécharger vos photos

Lancez la commande de téléchargement

Windows :

./immich-go.exe archive from-immich --from-server=https://votrenom.pixelunion.eu/ --from-api-key=VOTRE_CLE_API --write-to-folder=./PixelUnion-Backup

macOS/Linux :

./immich-go archive from-immich --from-server=https://votrenom.pixelunion.eu/ --from-api-key=VOTRE_CLE_API --write-to-folder=./PixelUnion-Backup

Remplacez :

  • votrenom.pixelunion.eu par votre domaine PixelUnion réel
  • VOTRE_CLE_API par la clé API copiée à l’étape 1
  • ./PixelUnion-Backup par le chemin où vous souhaitez enregistrer vos photos

Remarque : l’option --write-to-folder est obligatoire.

Options de filtrage d’Immich Go

Télécharger uniquement les photos (ignorer les vidéos)

./immich-go archive from-immich --from-server=https://votrenom.pixelunion.eu/ --from-api-key=VOTRE_CLE_API --write-to-folder=./PixelUnion-Backup --from-include-type=IMAGE

Télécharger uniquement les vidéos (ignorer les photos)

./immich-go archive from-immich --from-server=https://votrenom.pixelunion.eu/ --from-api-key=VOTRE_CLE_API --write-to-folder=./PixelUnion-Backup --from-include-type=VIDEO

Télécharger uniquement les photos favorites

./immich-go archive from-immich --from-server=https://votrenom.pixelunion.eu/ --from-api-key=VOTRE_CLE_API --write-to-folder=./PixelUnion-Backup --from-favorite

Télécharger les photos d’albums précis

./immich-go archive from-immich --from-server=https://votrenom.pixelunion.eu/ --from-api-key=VOTRE_CLE_API --write-to-folder=./PixelUnion-Backup --from-albums="Nom d'album 1" --from-albums="Nom d'album 2"

Télécharger les photos avec des tags précis

./immich-go archive from-immich --from-server=https://votrenom.pixelunion.eu/ --from-api-key=VOTRE_CLE_API --write-to-folder=./PixelUnion-Backup --from-tags="tag1" --from-tags="tag2"

Télécharger les photos d’une plage de dates

./immich-go archive from-immich --from-server=https://votrenom.pixelunion.eu/ --from-api-key=VOTRE_CLE_API --write-to-folder=./PixelUnion-Backup --from-date-range="2024-01-01:2024-12-31"

Dépannage

Problèmes de connexion

  • Vérifiez que votre domaine PixelUnion est correct et comprend https://
  • Vérifiez que votre clé API est correcte et n’a pas été révoquée
  • Vérifiez votre connexion internet

« Permission denied » sous macOS ou Linux

  • Vous devez d’abord rendre le fichier exécutable : chmod +x immich-archiver

Téléchargement interrompu

  • Les deux outils reprennent là où ils se sont arrêtés si vous relancez la commande
  • Les fichiers déjà téléchargés ne sont pas récupérés une seconde fois

Grandes bibliothèques

  • Pour de très grandes bibliothèques (des milliers de fichiers), le téléchargement peut prendre plusieurs heures
  • Assurez-vous que votre ordinateur ne se met pas en veille pendant le téléchargement
  • Envisagez de lancer le téléchargement pendant la nuit

Après le téléchargement

Une fois le téléchargement terminé :

  • Vos photos et vidéos se trouvent dans le dossier que vous avez indiqué
  • Les fichiers conservent leurs noms et dates d’origine
  • Vous pouvez sauvegarder ces fichiers ailleurs ou les transférer

Il vaut la peine de vérifier votre copie avant de compter dessus. Ouvrez le dossier et confirmez que quelques photos s’ouvrent réellement.

Besoin d’aide ?

Si vous rencontrez des problèmes :

Was this article helpful? Let us know