Scaricare Tutte le Foto e i Video

Puoi scaricare l’intera libreria di foto e video di PixelUnion sul tuo computer. È utile quando vuoi:

• Tenere una copia locale dei tuoi contenuti accanto alla libreria PixelUnion
• Scaricare i tuoi dati prima di eliminare l’account
• Trasferire la libreria a un altro servizio
• Avere una copia offline dei tuoi ricordi

Per questo ci sono due strumenti:

• immich-archiver è sviluppato e mantenuto da PixelUnion. Usalo per una copia semplice dell’intera libreria. È quello che consigliamo.
• Immich Go è uno strumento della community con più opzioni di filtro, come scaricare solo determinati album, tag o un intervallo di date. Al momento è interessato da un bug, descritto più avanti.

Entrambi gli strumenti richiedono una chiave API, quindi inizia da lì.

Passo 1: ottieni la tua chiave API

1. Accedi al tuo dominio PixelUnion (ad esempio https://tuonome.pixelunion.eu)
2. Fai clic sull’icona del profilo in alto a destra
3. Seleziona Impostazioni account
4. Vai su Chiavi API
5. Fai clic su Nuova chiave API
6. Assegnale un nome chiaro (ad esempio “Strumento di download”)
7. Copia la chiave API generata, ti servirà al passo successivo

⚠️ Importante: conserva la chiave API al sicuro e non condividerla con nessuno. Puoi revocarla in seguito, se necessario.

immich-archiver (consigliato)

immich-archiver copia ogni foto e video della tua cronologia in cartelle per data sul tuo disco e scrive accanto a ciascun file un .json con tutti i metadati che abbiamo: data di scatto, fotocamera, posizione GPS, appartenenza agli album, volti e valutazioni.

Sul disco il risultato è così:

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

Se lo esegui di nuovo più avanti scarica solo le novità, quindi aggiornare la copia è rapido.

Passo 2: scarica immich-archiver

1. Vai alla pagina delle release di immich-archiver
2. Scarica il file per il tuo sistema:
   • Windows: immich-archiver_..._windows_amd64.exe
   • macOS (Apple Silicon): immich-archiver_..._darwin_arm64
   • macOS (Intel): immich-archiver_..._darwin_amd64
   • Linux: immich-archiver_..._linux_amd64 (oppure linux_arm64 su un Raspberry Pi o simili)
3. Sposta il file scaricato nella cartella in cui vuoi il backup
4. Rinominalo in immich-archiver (su Windows immich-archiver.exe). Il nome scaricato contiene il numero di versione, e rinominarlo mantiene identici i comandi qui sotto quando aggiorni in futuro.

Le versioni per macOS sono firmate e notarizzate presso Apple, quindi si avviano senza avviso di sicurezza.

Su macOS e Linux devi rendere il file eseguibile una volta sola. Apri un terminale in quella cartella ed esegui:

chmod +x immich-archiver

Passo 3: eseguilo

Apri un terminale nella cartella che contiene il file:

• Windows: clic destro sulla cartella → “Apri nel terminale”
• macOS: apri l’app Terminale, digita cd seguito da uno spazio, trascina la cartella nella finestra e premi Invio
• Linux: apri un terminale e spostati nella cartella

Poi esegui lo strumento, sostituendo i segnaposto con i tuoi dati:

Windows:

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

macOS/Linux:

./immich-archiver --url https://tuonome.pixelunion.eu --api-key LA_TUA_CHIAVE_API --dir ./PixelUnion-Backup

Sostituisci tuonome.pixelunion.eu con il tuo dominio e LA_TUA_CHIAVE_API con la chiave del passo 1.

Per non digitare la chiave ogni volta puoi impostarle come variabili d’ambiente: IMMICH_URL, IMMICH_API_KEY e IMMICH_DIR. Con quelle impostate basta eseguire immich-archiver da solo.

Opzioni utili

Esegui lo strumento con --help per vedere tutto ciò che supporta.

Immich Go (per filtri avanzati)

Immich Go è uno strumento a riga di comando creato dalla community. Offre filtri che immich-archiver non ha ancora, come limitare il download a determinati album, tag o a un intervallo di date.

Scaricare Immich Go

1. Vai alla pagina delle release di Immich Go
2. Scarica la versione per il tuo sistema operativo:
   • Windows: scarica il file .exe
   • macOS: scarica il file con darwin nel nome
   • Linux: scarica il file con linux nel nome
3. Estrai il file .zip scaricato
4. Metti l’eseguibile immich-go in una cartella in cui vuoi scaricare le foto

Esegui il comando di download

Windows:

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

macOS/Linux:

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

Sostituisci:

• tuonome.pixelunion.eu con il tuo dominio PixelUnion reale
• LA_TUA_CHIAVE_API con la chiave API copiata al passo 1
• ./PixelUnion-Backup con il percorso in cui vuoi salvare le foto

Nota: l’opzione --write-to-folder è obbligatoria.

Opzioni di filtro di Immich Go

Scaricare solo le foto (saltare i video)

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

Scaricare solo i video (saltare le foto)

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

Scaricare solo le foto preferite

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

Scaricare le foto di album specifici

./immich-go archive from-immich --from-server=https://tuonome.pixelunion.eu/ --from-api-key=LA_TUA_CHIAVE_API --write-to-folder=./PixelUnion-Backup --from-albums="Nome album 1" --from-albums="Nome album 2"

Scaricare le foto con tag specifici

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

Scaricare le foto di un intervallo di date

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

Risoluzione dei problemi

Problemi di connessione

• Verifica che il dominio PixelUnion sia corretto e includa https://
• Verifica che la chiave API sia corretta e non sia stata revocata
• Controlla la connessione a internet

“Permission denied” su macOS o Linux

• Devi prima rendere il file eseguibile: chmod +x immich-archiver

Download interrotto

• Entrambi gli strumenti riprendono da dove si erano fermati se riesegui il comando
• I file già scaricati non vengono recuperati una seconda volta

Librerie grandi

• Con librerie molto grandi (migliaia di file) il download può richiedere diverse ore
• Assicurati che il computer non vada in sospensione durante il download
• Valuta di lasciare il download in esecuzione durante la notte

Dopo il download

Quando il download è completo:

• Le foto e i video si trovano nella cartella che hai indicato
• I file mantengono nomi e date originali
• Puoi salvare altrove questi file o trasferirli

Vale la pena controllare la copia prima di farci affidamento. Apri la cartella e verifica che qualche foto si apra davvero.

Serve aiuto?

Se incontri problemi:

• Per immich-archiver, consulta la pagina del progetto su GitHub
• Per Immich Go, consulta la documentazione di Immich Go
• Contatta il nostro team di supporto per assistenza