Téléchargez Toutes Vos Photos et Vidéos avec Immich Go

Immich Go est un outil puissant qui vous permet de télécharger toute votre bibliothèque de photos et vidéos PixelUnion sur votre ordinateur. C’est particulièrement utile lorsque vous souhaitez :

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

Qu’est-ce que Immich Go ?

Immich Go est un outil en ligne de commande qui se connecte à votre instance PixelUnion et télécharge toutes vos photos et vidéos tout en préservant :

• Les noms de fichiers originaux
• Les dates de création et les métadonnées
• Les structures d’albums
• Les fichiers vidéo

Étape 1 : Obtenez Votre Clé API

Avant de pouvoir utiliser Immich Go, vous devez générer une clé API depuis votre compte PixelUnion :

1. Connectez-vous à votre domaine PixelUnion (par ex. https://votrenom.pixelunion.eu)
2. Cliquez sur l’icône de votre profil en haut à droite
3. Sélectionnez Paramètres du compte
4. Naviguez vers Clés API
5. Cliquez sur Nouvelle clé API
6. Donnez-lui un nom descriptif (par ex. “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 sécurisée et ne la partagez avec personne. Vous pourrez la révoquer plus tard si nécessaire.

Étape 2 : Téléchargez Immich Go

Immich Go est un fichier exécutable autonome qui ne nécessite pas d’installation :

1. Allez sur la page des versions d’Immich Go
2. Téléchargez la version pour votre système d’exploitation :
   • Windows : Téléchargez le fichier .exe
   • macOS : Téléchargez le fichier avec darwin dans le nom
   • Linux : Téléchargez le fichier avec linux dans le nom
3. Extrayez le fichier .zip téléchargé
4. Placez l’exécutable immich-go dans un dossier où vous souhaitez télécharger vos photos (par ex. créez un dossier appelé “Sauvegarde PixelUnion”)

Étape 3 : Ouvrez un Terminal

Vous devrez exécuter Immich Go depuis un terminal/invite de commande :

• Windows : Clic droit sur le dossier où se trouve immich-go.exe → “Ouvrir dans le terminal” ou “Ouvrir la fenêtre PowerShell ici”
• macOS : Ouvrez l’application Terminal (trouvée dans Applications > Utilitaires), puis tapez cd suivi d’un espace, faites glisser le dossier avec immich-go dans la fenêtre du terminal et appuyez sur Entrée
• Linux : Ouvrez un terminal et naviguez vers le dossier contenant immich-go

Étape 4 : Exécutez la Commande de Téléchargement

Dans le terminal, exécutez la commande suivante en remplaçant les espaces réservés par vos informations :

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 que vous avez copiée à l’étape 1
• ./PixelUnion-Backup par le chemin où vous souhaitez enregistrer vos photos (vous pouvez utiliser un chemin absolu comme /Users/votrenom/Downloads/PixelUnion-Backup ou un chemin relatif comme ./PixelUnion-Backup)

Que Se Passe-t-il Ensuite ?

Immich Go va :

1. Se connecter à votre instance PixelUnion
2. Télécharger toutes vos photos et vidéos dans le dossier spécifié (--write-to-folder)
3. Préserver les noms de fichiers et dates originaux
4. Afficher la progression pendant le téléchargement

Le téléchargement peut prendre un certain temps selon :

• La taille de votre bibliothèque
• La vitesse de votre connexion Internet
• Le nombre de fichiers

Note : L’option --write-to-folder est requise. Assurez-vous de spécifier un chemin de dossier où vous souhaitez enregistrer vos photos et vidéos.

Options de Téléchargement

Vous pouvez personnaliser votre téléchargement avec des options supplémentaires :

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 de Albums Spécifiques

./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 Album 1" --from-albums="Nom Album 2"

Télécharger les Photos avec des Tags Spécifiques

./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

• Assurez-vous que votre domaine PixelUnion est correct (incluez https:// et le / final)
• Vérifiez que votre clé API est correcte et n’a pas été révoquée
• Vérifiez votre connexion Internet
• Assurez-vous d’avoir spécifié l’option --write-to-folder avec un chemin valide

Téléchargement Interrompu

• Immich Go reprendra là où il s’est arrêté si vous exécutez à nouveau la commande
• Il ne retéléchargera pas les fichiers déjà présents

Grandes Bibliothèques

• Pour les très grandes bibliothèques (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 d’exécuter 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 seront dans le dossier que vous avez spécifié avec --write-to-folder
• Les fichiers sont organisés avec leurs noms et dates originaux
• Vous pouvez maintenant sauvegarder ces fichiers en toute sécurité ou les transférer ailleurs

Besoin d’Aide ?

Si vous rencontrez des problèmes avec Immich Go :

• Consultez la documentation d’Immich Go
• Contactez notre équipe de support pour obtenir de l’aide