Startseite
Über uns
Open Source Mobile Apps Häufig gestellte Fragen Migration von Google Fotos Über PixelUnion
Preise Blog
Hilfecenter
Konto Immich Migration Sonstiges Support kontaktieren
Anmelden Registrieren

Alle Fotos und Videos Herunterladen

Laden Sie Ihre gesamte PixelUnion-Bibliothek mit immich-archiver oder Immich Go auf Ihren Computer herunter

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

OptionWas sie bewirkt
--dry-runZeigt an, was heruntergeladen würde, ohne etwas zu speichern
--verboseGibt eine Zeile pro Datei aus statt eines laufenden Zählers
--path-template "{year}/{month}/{day}"Ändert die Ordnerstruktur. Standard ist {year}/{year}-{month}
--include-sharedLädt auch Alben herunter, die andere mit Ihnen geteilt haben, in einen eigenen Ordner shared-with-me
--concurrency 8Lädt mehr Dateien gleichzeitig. Standard ist 4
--retries 5Wiederholt 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
  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:

Was this article helpful? Let us know
Previous Next