Download Alle Foto's en Video's

Je kunt je volledige PixelUnion-bibliotheek met foto’s en video’s naar je eigen computer downloaden. Dat is handig wanneer je:

• Een lokale kopie van je media naast je PixelUnion-bibliotheek wilt bewaren
• Je gegevens wilt downloaden voordat je je account verwijdert
• Je bibliotheek naar een andere service wilt overzetten
• Een offline kopie van je herinneringen wilt bewaren

Hiervoor zijn twee tools:

• immich-archiver wordt door PixelUnion gebouwd en onderhouden. Gebruik deze voor een eenvoudige kopie van je hele bibliotheek. Dit is degene die wij aanraden.
• Immich Go is een community-tool met meer filtermogelijkheden, zoals alleen bepaalde albums, tags of een datumbereik downloaden. Deze heeft momenteel last van een bug, die verderop wordt beschreven.

Beide tools hebben een API-sleutel nodig, dus begin daarmee.

Stap 1: haal je API-sleutel op

1. Log in op je PixelUnion-domein (bijvoorbeeld https://jouwnaam.pixelunion.eu)
2. Klik op je profielpictogram rechtsboven
3. Kies Accountinstellingen
4. Ga naar API-sleutels
5. Klik op Nieuwe API-sleutel
6. Geef hem een duidelijke naam (bijvoorbeeld “Downloadtool”)
7. Kopieer de gegenereerde API-sleutel, die heb je in de volgende stap nodig

⚠️ Belangrijk: houd je API-sleutel geheim en deel hem met niemand. Je kunt hem later intrekken als dat nodig is.

immich-archiver (aanbevolen)

immich-archiver kopieert elke foto en video uit je tijdlijn naar mappen per datum op je schijf, en schrijft er een .json-bestand naast met alle metadata die wij ervan hebben: opnamedatum, camera, GPS-locatie, albums, gezichten en waarderingen.

Op je schijf ziet dat er zo uit:

PixelUnion-Backup/2005/2005-06/IMG_0001.jpg
PixelUnion-Backup/2005/2005-06/IMG_0001.jpg.json

Draai je hem later opnieuw, dan downloadt hij alleen wat nieuw is, dus je kopie bijwerken gaat snel.

Stap 2: download immich-archiver

1. Ga naar de releasepagina van immich-archiver
2. Download het bestand voor jouw systeem:
   • Windows: immich-archiver_..._windows_amd64.exe
   • macOS (Apple Silicon): immich-archiver_..._darwin_arm64
   • macOS (Intel): immich-archiver_..._darwin_amd64
   • Linux: immich-archiver_..._linux_amd64 (of linux_arm64 op bijvoorbeeld een Raspberry Pi)
3. Verplaats het gedownloade bestand naar de map waar je je back-up wilt hebben
4. Hernoem het naar immich-archiver (op Windows immich-archiver.exe). De gedownloade naam bevat het versienummer, en door te hernoemen blijven de onderstaande commando’s hetzelfde wanneer je later bijwerkt.

De macOS-versies zijn ondertekend en genotariseerd bij Apple, dus ze draaien zonder beveiligingswaarschuwing.

Op macOS en Linux moet je het bestand eenmalig uitvoerbaar maken. Open een terminal in die map en voer uit:

chmod +x immich-archiver

Stap 3: voer het uit

Open een terminal in de map met het bestand:

• Windows: rechtsklik op de map → “Openen in terminal”
• macOS: open de Terminal-app, typ cd gevolgd door een spatie, sleep de map naar het venster en druk op Enter
• Linux: open een terminal en ga naar de map

Voer daarna de tool uit en vervang de plaatsaanduidingen door je eigen gegevens:

Windows:

.\immich-archiver.exe --url https://jouwnaam.pixelunion.eu --api-key JOUW_API_SLEUTEL --dir .\PixelUnion-Backup

macOS/Linux:

./immich-archiver --url https://jouwnaam.pixelunion.eu --api-key JOUW_API_SLEUTEL --dir ./PixelUnion-Backup

Vervang jouwnaam.pixelunion.eu door je eigen domein en JOUW_API_SLEUTEL door de sleutel uit stap 1.

Wil je je sleutel niet elke keer typen, dan kun je ze als omgevingsvariabelen instellen: IMMICH_URL, IMMICH_API_KEY en IMMICH_DIR. Zijn die ingesteld, dan volstaat immich-archiver op zichzelf.

Handige opties

Voer de tool uit met --help om alles te zien wat hij ondersteunt.

Immich Go (voor geavanceerd filteren)

Immich Go is een door de community gebouwde commandoregeltool. Hij biedt filters die immich-archiver nog niet heeft, zoals de download beperken tot bepaalde albums, tags of een datumbereik.

Download Immich Go

1. Ga naar de releasepagina van Immich Go
2. Download de versie voor jouw besturingssysteem:
   • Windows: download het .exe-bestand
   • macOS: download het bestand met darwin in de naam
   • Linux: download het bestand met linux in de naam
3. Pak het gedownloade .zip-bestand uit
4. Zet het immich-go-programma in een map waar je je foto’s wilt downloaden

Voer het downloadcommando uit

Windows:

./immich-go.exe archive from-immich --from-server=https://jouwnaam.pixelunion.eu/ --from-api-key=JOUW_API_SLEUTEL --write-to-folder=./PixelUnion-Backup

macOS/Linux:

./immich-go archive from-immich --from-server=https://jouwnaam.pixelunion.eu/ --from-api-key=JOUW_API_SLEUTEL --write-to-folder=./PixelUnion-Backup

Vervang:

• jouwnaam.pixelunion.eu door je eigen PixelUnion-domein
• JOUW_API_SLEUTEL door de API-sleutel die je in stap 1 hebt gekopieerd
• ./PixelUnion-Backup door het pad waar je je foto’s wilt opslaan

Let op: de vlag --write-to-folder is verplicht.

Filteropties van Immich Go

Alleen foto’s downloaden (video’s overslaan)

./immich-go archive from-immich --from-server=https://jouwnaam.pixelunion.eu/ --from-api-key=JOUW_API_SLEUTEL --write-to-folder=./PixelUnion-Backup --from-include-type=IMAGE

Alleen video’s downloaden (foto’s overslaan)

./immich-go archive from-immich --from-server=https://jouwnaam.pixelunion.eu/ --from-api-key=JOUW_API_SLEUTEL --write-to-folder=./PixelUnion-Backup --from-include-type=VIDEO

Alleen favoriete foto’s downloaden

./immich-go archive from-immich --from-server=https://jouwnaam.pixelunion.eu/ --from-api-key=JOUW_API_SLEUTEL --write-to-folder=./PixelUnion-Backup --from-favorite

Foto’s van specifieke albums downloaden

./immich-go archive from-immich --from-server=https://jouwnaam.pixelunion.eu/ --from-api-key=JOUW_API_SLEUTEL --write-to-folder=./PixelUnion-Backup --from-albums="Albumnaam 1" --from-albums="Albumnaam 2"

Foto’s met specifieke tags downloaden

./immich-go archive from-immich --from-server=https://jouwnaam.pixelunion.eu/ --from-api-key=JOUW_API_SLEUTEL --write-to-folder=./PixelUnion-Backup --from-tags="tag1" --from-tags="tag2"

Foto’s uit een datumbereik downloaden

./immich-go archive from-immich --from-server=https://jouwnaam.pixelunion.eu/ --from-api-key=JOUW_API_SLEUTEL --write-to-folder=./PixelUnion-Backup --from-date-range="2024-01-01:2024-12-31"

Probleemoplossing

Verbindingsproblemen

• Controleer of je PixelUnion-domein klopt en https:// bevat
• Controleer of je API-sleutel juist is en niet is ingetrokken
• Controleer je internetverbinding

“Permission denied” op macOS of Linux

• Je moet het bestand eerst uitvoerbaar maken: chmod +x immich-archiver

Download onderbroken

• Beide tools gaan verder waar ze gebleven zijn als je het commando opnieuw uitvoert
• Bestanden die al gedownload zijn worden geen tweede keer opgehaald

Grote bibliotheken

• Bij zeer grote bibliotheken (duizenden bestanden) kan de download enkele uren duren
• Zorg dat je computer niet in slaapstand gaat tijdens de download
• Overweeg om de download ’s nachts te laten lopen

Na het downloaden

Als de download klaar is:

• Staan je foto’s en video’s in de map die je hebt opgegeven
• Behouden bestanden hun originele namen en datums
• Kun je deze bestanden elders back-uppen of overzetten

Het is verstandig om je kopie te controleren voordat je erop vertrouwt. Open de map en kijk of een paar foto’s daadwerkelijk openen.

Hulp nodig?

Als je ergens tegenaan loopt:

• Voor immich-archiver: bekijk de projectpagina op GitHub
• Voor Immich Go: bekijk de documentatie van Immich Go
• Neem contact op met ons supportteam voor hulp