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
- Connectez-vous à votre domaine PixelUnion (par exemple
https://votrenom.pixelunion.eu) - Cliquez sur votre icône de profil en haut à droite
- Sélectionnez Paramètres du compte
- Allez dans Clés API
- Cliquez sur Nouvelle clé API
- Donnez-lui un nom explicite (par exemple « Outil de téléchargement »)
- 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
- Rendez-vous sur la page des versions d’immich-archiver
- 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(oulinux_arm64sur un Raspberry Pi par exemple)
- Windows :
- Déplacez le fichier téléchargé dans le dossier où vous voulez votre sauvegarde
- 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
cdsuivi 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
| Option | Ce qu’elle fait |
|---|---|
--dry-run | Affiche ce qui serait téléchargé sans rien enregistrer |
--verbose | Affiche 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-shared | Télécharge aussi les albums partagés avec vous, dans un dossier shared-with-me distinct |
--concurrency 8 | Télécharge plus de fichiers à la fois. Par défaut 4 |
--retries 5 | Ré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
- Rendez-vous sur la page des versions d’Immich Go
- 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
darwindans son nom - Linux : téléchargez le fichier contenant
linuxdans son nom
- Windows : téléchargez le fichier
- Extrayez le fichier
.ziptéléchargé - Placez l’exécutable
immich-godans 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.eupar votre domaine PixelUnion réelVOTRE_CLE_APIpar la clé API copiée à l’étape 1./PixelUnion-Backuppar 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 :
- Pour immich-archiver, consultez la page du projet sur GitHub
- Pour Immich Go, consultez la documentation d’Immich Go
- Contactez notre équipe d’assistance pour obtenir de l’aide