--- title: "Alle Fotos und Videos Herunterladen" description: "Laden Sie Ihre gesamte PixelUnion-Bibliothek mit immich-archiver oder Immich Go auf Ihren Computer herunter" url: "https://pixelunion.eu/de/help/immich/download-photos-videos/" weight: 5 --- Sie können Ihre gesamte PixelUnion-Bibliothek mit Fotos und Videos auf Ihren eigenen Computer herunterladen. Das ist nützlich, wenn Sie: - Eine lokale Kopie Ihrer Medien zusätzlich zu Ihrer PixelUnion-Bibliothek behalten möchten - Ihre Daten herunterladen möchten, bevor Sie Ihr Konto löschen - Ihre Bibliothek zu einem anderen Dienst übertragen möchten - Eine Offline-Kopie Ihrer Erinnerungen behalten möchten Dafür gibt es zwei Werkzeuge: - **immich-archiver** wird von PixelUnion entwickelt und gepflegt. Nutzen Sie es für eine unkomplizierte Kopie Ihrer gesamten Bibliothek. Dieses empfehlen wir. - **Immich Go** ist ein Community-Werkzeug mit mehr Filteroptionen, etwa dem Herunterladen einzelner Alben, Tags oder Zeiträume. Es ist derzeit von einem Fehler betroffen, der weiter unten beschrieben wird. Beide Werkzeuge benötigen einen API-Schlüssel, beginnen Sie also damit. ## Schritt 1: Holen Sie Ihren API-Schlüssel 1. Melden Sie sich bei Ihrer PixelUnion-Domain an (z. B. `https://ihrname.pixelunion.eu`) 2. Klicken Sie oben rechts auf Ihr Profilsymbol 3. Wählen Sie **Kontoeinstellungen** 4. Gehen Sie zu **API-Schlüssel** 5. Klicken Sie auf **Neuer API-Schlüssel** 6. Geben Sie ihm einen aussagekräftigen Namen (z. B. "Download-Werkzeug") 7. **Kopieren Sie den erzeugten API-Schlüssel**, Sie benötigen ihn im nächsten Schritt ⚠️ **Wichtig**: Bewahren Sie Ihren API-Schlüssel sicher auf und geben Sie ihn an niemanden weiter. Sie können ihn später widerrufen, falls nötig. ## immich-archiver (empfohlen) immich-archiver kopiert jedes Foto und Video Ihrer Zeitleiste in nach Datum sortierte Ordner auf Ihrer Festplatte und legt daneben eine `.json`-Datei mit allen Metadaten ab, die wir dazu haben: Aufnahmedatum, Kamera, GPS-Standort, Albumzugehörigkeit, Gesichter und Bewertungen. Auf der Festplatte sieht das so aus: ``` PixelUnion-Backup/2005/2005-06/IMG_0001.jpg PixelUnion-Backup/2005/2005-06/IMG_0001.jpg.json ``` Beim nächsten Lauf lädt das Werkzeug nur Neues herunter, das Aktualisieren Ihrer Kopie geht also schnell. ### Schritt 2: Laden Sie immich-archiver herunter 1. Gehen Sie zur [Release-Seite von immich-archiver](https://github.com/pixelunioneu/immich-archiver/releases/latest) 2. Laden Sie die Datei für Ihr System herunter: - **Windows**: `immich-archiver_..._windows_amd64.exe` - **macOS (Apple Silicon)**: `immich-archiver_..._darwin_arm64` - **macOS (Intel)**: `immich-archiver_..._darwin_amd64` - **Linux**: `immich-archiver_..._linux_amd64` (oder `linux_arm64` etwa auf einem Raspberry Pi) 3. Verschieben Sie die heruntergeladene Datei in den Ordner, in dem Ihre Sicherung liegen soll 4. Benennen Sie sie in `immich-archiver` um (unter Windows `immich-archiver.exe`). Der heruntergeladene Name enthält die Versionsnummer, durch das Umbenennen bleiben die folgenden Befehle bei späteren Aktualisierungen gleich. Die macOS-Versionen sind signiert und bei Apple notarisiert, sie laufen also ohne Sicherheitswarnung. Unter macOS und Linux müssen Sie die Datei einmalig ausführbar machen. Öffnen Sie ein Terminal in diesem Ordner und führen Sie aus: ``` chmod +x immich-archiver ``` ### Schritt 3: Führen Sie es aus Öffnen Sie ein Terminal in dem Ordner mit der Datei: - **Windows**: Rechtsklick auf den Ordner → "Im Terminal öffnen" - **macOS**: Öffnen Sie die **Terminal**-App, tippen Sie `cd ` gefolgt von einem Leerzeichen, ziehen Sie den Ordner in das Fenster und drücken Sie Enter - **Linux**: Öffnen Sie ein Terminal und wechseln Sie in den Ordner Führen Sie dann das Werkzeug aus und ersetzen Sie die Platzhalter durch Ihre eigenen Angaben: **Windows:** ``` .\immich-archiver.exe --url https://ihrname.pixelunion.eu --api-key IHR_API_SCHLUESSEL --dir .\PixelUnion-Backup ``` **macOS/Linux:** ``` ./immich-archiver --url https://ihrname.pixelunion.eu --api-key IHR_API_SCHLUESSEL --dir ./PixelUnion-Backup ``` Ersetzen Sie `ihrname.pixelunion.eu` durch Ihre eigene Domain und `IHR_API_SCHLUESSEL` durch den Schlüssel aus Schritt 1. Damit Sie Ihren Schlüssel nicht jedes Mal eintippen müssen, können Sie stattdessen Umgebungsvariablen setzen: `IMMICH_URL`, `IMMICH_API_KEY` und `IMMICH_DIR`. Sind diese gesetzt, genügt der Aufruf `immich-archiver` allein. ### Nützliche Optionen | Option | Was sie bewirkt | |---|---| | `--dry-run` | Zeigt an, was heruntergeladen würde, ohne etwas zu speichern | | `--verbose` | Gibt eine Zeile pro Datei aus statt eines laufenden Zählers | | `--path-template "{year}/{month}/{day}"` | Ändert die Ordnerstruktur. Standard ist `{year}/{year}-{month}` | | `--include-shared` | Lädt auch Alben herunter, die andere mit Ihnen geteilt haben, in einen eigenen Ordner `shared-with-me` | | `--concurrency 8` | Lädt mehr Dateien gleichzeitig. Standard ist 4 | | `--retries 5` | Wiederholt fehlgeschlagene Downloads öfter. Standard ist 3 | Rufen Sie das Werkzeug mit `--help` auf, um alle Möglichkeiten zu sehen. ## Immich Go (für erweiterte Filter) Immich Go ist ein von der Community entwickeltes Kommandozeilenwerkzeug. Es bietet Filter, die immich-archiver noch nicht hat, etwa die Beschränkung auf bestimmte Alben, Tags oder einen Zeitraum.

Bekannter Fehler in immich-go: fehlerhafte Dateinamen

In immich-go gibt es einen bekannten Fehler, der den Befehl archive from-immich betrifft. Exportierte Dateien können falsche numerische Dateinamen (wie -1, -2) ohne Dateiendung erhalten, und Albummetadaten können im Export fehlen. Eine Lösung ist derzeit in Bearbeitung. Den aktuellen Stand können Sie auf GitHub (PR #1272) verfolgen. Wir empfehlen, das oben beschriebene immich-archiver zu verwenden oder auf eine aktualisierte Version von immich-go zu warten, bevor Sie diesen Befehl nutzen.

### Immich Go herunterladen 1. Gehen Sie zur [Release-Seite von Immich Go](https://github.com/simulot/immich-go/releases/latest) 2. Laden Sie die Version für Ihr Betriebssystem herunter: - **Windows**: Laden Sie die `.exe`-Datei herunter - **macOS**: Laden Sie die Datei mit `darwin` im Namen herunter - **Linux**: Laden Sie die Datei mit `linux` im Namen herunter 3. Entpacken Sie die heruntergeladene `.zip`-Datei 4. Legen Sie die ausführbare Datei `immich-go` in den Ordner, in den Sie Ihre Fotos herunterladen möchten ### Führen Sie den Download-Befehl aus **Windows:** ``` ./immich-go.exe archive from-immich --from-server=https://ihrname.pixelunion.eu/ --from-api-key=IHR_API_SCHLUESSEL --write-to-folder=./PixelUnion-Backup ``` **macOS/Linux:** ``` ./immich-go archive from-immich --from-server=https://ihrname.pixelunion.eu/ --from-api-key=IHR_API_SCHLUESSEL --write-to-folder=./PixelUnion-Backup ``` Ersetzen Sie: - `ihrname.pixelunion.eu` durch Ihre tatsächliche PixelUnion-Domain - `IHR_API_SCHLUESSEL` durch den in Schritt 1 kopierten API-Schlüssel - `./PixelUnion-Backup` durch den Pfad, unter dem Ihre Fotos gespeichert werden sollen **Hinweis**: Die Option `--write-to-folder` ist erforderlich. ### Filteroptionen von Immich Go #### Nur Fotos herunterladen (Videos überspringen) ``` ./immich-go archive from-immich --from-server=https://ihrname.pixelunion.eu/ --from-api-key=IHR_API_SCHLUESSEL --write-to-folder=./PixelUnion-Backup --from-include-type=IMAGE ``` #### Nur Videos herunterladen (Fotos überspringen) ``` ./immich-go archive from-immich --from-server=https://ihrname.pixelunion.eu/ --from-api-key=IHR_API_SCHLUESSEL --write-to-folder=./PixelUnion-Backup --from-include-type=VIDEO ``` #### Nur Favoriten herunterladen ``` ./immich-go archive from-immich --from-server=https://ihrname.pixelunion.eu/ --from-api-key=IHR_API_SCHLUESSEL --write-to-folder=./PixelUnion-Backup --from-favorite ``` #### Fotos aus bestimmten Alben herunterladen ``` ./immich-go archive from-immich --from-server=https://ihrname.pixelunion.eu/ --from-api-key=IHR_API_SCHLUESSEL --write-to-folder=./PixelUnion-Backup --from-albums="Albumname 1" --from-albums="Albumname 2" ``` #### Fotos mit bestimmten Tags herunterladen ``` ./immich-go archive from-immich --from-server=https://ihrname.pixelunion.eu/ --from-api-key=IHR_API_SCHLUESSEL --write-to-folder=./PixelUnion-Backup --from-tags="tag1" --from-tags="tag2" ``` #### Fotos aus einem Datumsbereich herunterladen ``` ./immich-go archive from-immich --from-server=https://ihrname.pixelunion.eu/ --from-api-key=IHR_API_SCHLUESSEL --write-to-folder=./PixelUnion-Backup --from-date-range="2024-01-01:2024-12-31" ``` ## Fehlerbehebung ### Verbindungsprobleme - Stellen Sie sicher, dass Ihre PixelUnion-Domain korrekt ist und `https://` enthält - Prüfen Sie, ob Ihr API-Schlüssel korrekt ist und nicht widerrufen wurde - Prüfen Sie Ihre Internetverbindung ### "Permission denied" unter macOS oder Linux - Sie müssen die Datei zuerst ausführbar machen: `chmod +x immich-archiver` ### Download unterbrochen - Beide Werkzeuge setzen dort fort, wo sie aufgehört haben, wenn Sie den Befehl erneut ausführen - Bereits heruntergeladene Dateien werden kein zweites Mal geholt ### Große Bibliotheken - Bei sehr großen Bibliotheken (Tausende Dateien) kann der Download mehrere Stunden dauern - Stellen Sie sicher, dass Ihr Computer während des Downloads nicht in den Ruhezustand wechselt - Lassen Sie den Download gegebenenfalls über Nacht laufen ## Nach dem Herunterladen Wenn der Download abgeschlossen ist: - Liegen Ihre Fotos und Videos in dem von Ihnen angegebenen Ordner - Behalten die Dateien ihre ursprünglichen Namen und Daten - Können Sie diese Dateien anderswo sichern oder übertragen Es lohnt sich, Ihre Kopie zu prüfen, bevor Sie sich darauf verlassen. Öffnen Sie den Ordner und stellen Sie sicher, dass sich einige Fotos tatsächlich öffnen lassen. ## Benötigen Sie Hilfe? Wenn Probleme auftreten: - Für immich-archiver: siehe die [Projektseite auf GitHub](https://github.com/pixelunioneu/immich-archiver) - Für Immich Go: siehe die [Dokumentation von Immich Go](https://github.com/simulot/immich-go) - [Kontaktieren Sie unser Support-Team](/support/) für Unterstützung