--- title: "Télécharger Toutes les Photos et Vidéos" description: "Téléchargez toute votre bibliothèque PixelUnion sur votre ordinateur avec immich-archiver ou Immich Go" url: "https://pixelunion.eu/fr/help/immich/download-photos-videos/" weight: 5 --- 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](https://github.com/pixelunioneu/immich-archiver/releases/latest) 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 | 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 1. Rendez-vous sur la [page des versions d'Immich Go](https://github.com/simulot/immich-go/releases/latest) 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 : - Pour immich-archiver, consultez la [page du projet sur GitHub](https://github.com/pixelunioneu/immich-archiver) - Pour Immich Go, consultez la [documentation d'Immich Go](https://github.com/simulot/immich-go) - [Contactez notre équipe d'assistance](/support/) pour obtenir de l'aide