Migreer van iCloud Photos

Al je foto’s en video’s van iCloud Photos overzetten naar PixelUnion

Wil je overstappen van iCloud Photos naar PixelUnion? Goed nieuws: het is heel eenvoudig om je complete foto- en videoarchief mee te nemen. Op deze pagina leggen we stap voor stap uit hoe je al je media exporteert uit iCloud Photos en importeert in PixelUnion.

Er zijn twee manieren waarop je dit kunt doen:

• Methode 1 – Snel en eenvoudig:
  Deze methode is makkelijker, maar je loopt het risico dat sommige datums en albumstructuren niet helemaal correct worden overgenomen.

• Methode 2 – Iets technischer, maar nauwkeuriger:
  Deze aanpak vereist iets meer stappen, maar hiermee blijven datums en albums wél behouden. We leggen je precies uit hoe dit werkt.

Methode 1: Eenvoudige import

Stap 1: Foto’s exporteren vanuit iCloud Photos

1. Ga naar iCloud.com en log in met je Apple ID.
2. Klik op Foto’s.
3. Selecteer de foto’s en video’s die je wilt exporteren:
   • Om alle foto’s te selecteren: Druk op Ctrl+A (Windows) of Cmd+A (Mac), of klik op de knop Selecteren en kies Alles selecteren.
   • Om specifieke foto’s te selecteren: Klik op individuele foto’s terwijl je Ctrl (Windows) of Cmd (Mac) ingedrukt houdt.
4. Klik op de knop Downloaden (wolk-icoon met pijl naar beneden).
5. Wacht tot de download is voltooid. Je foto’s worden gedownload als een .zip-bestand.

🔔 Let op: Als je een grote fotobibliotheek hebt, moet je mogelijk in kleinere batches downloaden. De export kan enige tijd duren, afhankelijk van de hoeveelheid foto’s.

Stap 2: Foto’s voorbereiden voor PixelUnion

• Pak het gedownloade .zip-bestand of bestanden uit op je computer.
• Je foto’s staan in de uitgepakte map, meestal georganiseerd op datum of album.

Stap 3: Upload naar PixelUnion

• Ga naar je PixelUnion-domein in je browser, je domein is je server adres die altijd eindigt in .pixelunion.eu.
• Log in en klik op Upload.
• Selecteer de gewenste foto’s of mappen.

Methode 2: Import met behoud van datums en albums (aanbevolen)

Deze methode gebruikt Immich Go om je iCloud-export te uploaden mét behoud van metadata zoals albumnamen en fotodatums.

Immich Go is een hulpprogramma waarmee je eenvoudig foto’s en video’s uit iCloud kunt importeren in PixelUnion, mét behoud van belangrijke metadata zoals originele datums en albumnamen. Dit zorgt ervoor dat je foto’s netjes georganiseerd blijven en je herinneringen op de juiste plek en volgorde terugkomen in PixelUnion.

We gaan je helpen om deze tool te gebruiken:

Stap 1: Exporteer je foto’s vanuit iCloud Photos

1. Ga naar iCloud.com en log in met je Apple ID.
2. Klik op Foto’s.
3. Selecteer de foto’s en video’s die je wilt exporteren:
   • Om alle foto’s te selecteren: Druk op Ctrl+A (Windows) of Cmd+A (Mac), of klik op de knop Selecteren en kies Alles selecteren.
   • Om specifieke foto’s te selecteren: Klik op individuele foto’s terwijl je Ctrl (Windows) of Cmd (Mac) ingedrukt houdt.
4. Klik op de knop Downloaden (wolk-icoon met pijl naar beneden).
5. Wacht tot de download is voltooid. Je foto’s worden gedownload als een .zip-bestand.
6. Pak het gedownloade bestand of bestanden uit op je computer. Je hoeft ze niet verder te organiseren: Immich Go regelt de structuur.

🔔 Let op: Voor zeer grote bibliotheken moet je mogelijk in meerdere batches exporteren. Immich Go kan de uitgepakte mappen direct verwerken.

Stap 2: Download en installeer Immich Go

Immich Go is geen programma met een normale installer. Het is een los programmaatje dat je als bestand op je computer zet en direct kunt gebruiken, zonder installatie. In deze stap gaan we dat klaarzetten.

1. Ga naar de releases-pagina van Immich Go.

2. Download de juiste versie voor jouw besturingssysteem (Windows, Mac of Linux).

   Kies het bestand dat past bij jouw computer:

   • Voor Windows kies je het .exe-bestand
   • Voor Mac kies je het bestand met darwin in de naam
   • Voor Linux kies je het bestand met linux in de naam

3. Pak het .zip-bestand uit.

4. Zet het bestand immich-go (of immich-go.exe op Windows) in een nieuwe map.

5. Voeg je uitgepakte iCloud-exportmappen toe aan diezelfde map, of noteer het pad naar waar je ze hebt uitgepakt.

Stap 3: Koppel je domein en API key

1. Ga naar jouw PixelUnion-domein.
2. Klik rechtsboven op je profiel en kies Account settings.
3. Navigeer naar API Key.
4. Klik op New API key, geef deze een naam en kopieer de gegenereerde sleutel.

Stap 4: Voer een commando uit in de terminal

1. Open een terminal in de map waar immich-go staat.
   • Windows: rechterklik op de map → “Open in terminal” of “Open in PowerShell”
   • macOS: Open de app Terminal (te vinden via Spotlight of in Programma’s > Hulpprogramma’s). Typ cd gevolgd door een spatie, sleep de map waarin je immich-go hebt gezet naar het terminalvenster, en druk op Enter.
2. Plak het volgende commando in de terminal, vervang de server, API-key en mappad door jouw eigen waarden:
   • Windows (als je iCloud-export in dezelfde map staat):

     ./immich-go.exe --server=https://<user.name>.pixelunion.eu/ --api-key=APIKEY --pause-immich-jobs=false --manage-heic-jpeg=StackCoverJPG upload from-icloud .
     

   • Windows (als je iCloud-export in een andere map staat):

     ./immich-go.exe --server=https://<user.name>.pixelunion.eu/ --api-key=APIKEY --pause-immich-jobs=false --manage-heic-jpeg=StackCoverJPG upload from-icloud "C:\path\to\your\icloud\export"
     

   • macOS (als je iCloud-export in dezelfde map staat):

     ./immich-go --server=https://<user.name>.pixelunion.eu/ --api-key=APIKEY --pause-immich-jobs=false --manage-heic-jpeg=StackCoverJPG upload from-icloud .
     

   • macOS (als je iCloud-export in een andere map staat):

     ./immich-go --server=https://<user.name>.pixelunion.eu/ --api-key=APIKEY --pause-immich-jobs=false --manage-heic-jpeg=StackCoverJPG upload from-icloud "/path/to/your/icloud/export"
     

3. De tool uploadt automatisch al je foto’s, mét albums en datums, naar PixelUnion.

Optioneel: iCloud Memories als albums opnemen

Als je iCloud Memories als albums in PixelUnion wilt importeren, voeg je de vlag --memories toe aan je commando:

• Windows:

  ./immich-go.exe --server=https://<user.name>.pixelunion.eu/ --api-key=APIKEY --pause-immich-jobs=false --manage-heic-jpeg=StackCoverJPG --memories upload from-icloud .
  

• macOS:

  ./immich-go --server=https://<user.name>.pixelunion.eu/ --api-key=APIKEY --pause-immich-jobs=false --manage-heic-jpeg=StackCoverJPG --memories upload from-icloud .
  

Hulp nodig?

Mocht je tegen problemen aanlopen, dan lost dit het probleem in veel gevallen op:

• Werk in kleinere batches
  Voor zeer grote iCloud-bibliotheken, exporteer en upload in kleinere batches. Exporteer bijvoorbeeld foto’s van één jaar tegelijk, of selecteer specifieke albums om te exporteren.

• Controleer of alles op de juiste locatie staat
  Zorg dat immich-go (of immich-go.exe) in een map staat waartoe je toegang hebt, en dat je terminal ook in die map geopend is. Als je iCloud-export op een andere locatie staat, gebruik dan het volledige pad in het commando.

• Check je commando goed
  Let op:

  • Je server-URL is je PixelUnion-domein en eindigt op .pixelunion.eu
  • Gebruik --server=https://<jouwnaam>.pixelunion.eu (zonder extra spaties/typfouten)
  • Gebruik de juiste --api-key (gekopieerd uit Account settings → API Key) ook dat er geen spatie staat tussen = en de API Key.
  • De optie --manage-heic-jpeg=StackCoverJPG helpt bij het organiseren van HEIC- en JPEG-versies van dezelfde foto

• Gebruik bij Windows het juiste bestand
  Op Windows gebruik je meestal ./immich-go.exe (niet ./immich-go).

• HEIC-bestandsafhandeling iCloud Photos slaat foto’s vaak op in HEIC-formaat. De optie --manage-heic-jpeg=StackCoverJPG zorgt ervoor dat als je zowel HEIC- als JPEG-versies van dezelfde foto hebt, deze correct worden georganiseerd (gestapeld samen met de JPEG als omslagafbeelding).

Als je nog steeds problemen tegenkomt tijdens het migratieproces, staan we voor je klaar! Neem bij het contact opnemen met ons supportteam het volgende mee:

1. Een screenshot van de foutmelding of het probleem dat je tegenkomt
2. De logs van immich-go - Immich Go maakt automatisch een logbestand aan aan het begin van elke run in dezelfde map waar je het commando hebt uitgevoerd. Het logbestand heeft de naam immich-go YYYY-MM-DD HH-MM-SS.log (bijvoorbeeld immich-go 2024-01-15 14-30-45.log). Zoek naar bestanden met dit naampatroon in die map. Als je geen logbestand kunt vinden, kun je ook de output uit je terminalvenster kopiëren waar je het immich-go commando hebt uitgevoerd.
3. Het commando dat je invoert in de terminal (vervang wel je API Key voor de veiligheid.)

Je kunt ons supportteam bereiken via de Contact opnemen pagina. We nemen zo snel mogelijk contact met je op om eventuele problemen op te lossen.