Scarica Tutte le Tue Foto e Video con Immich Go

Immich Go è un potente strumento che ti permette di scaricare tutta la tua libreria di foto e video PixelUnion sul tuo computer. Questo è particolarmente utile quando vuoi:

• Creare un backup locale dei tuoi media
• Scaricare i tuoi dati prima di eliminare il tuo account
• Trasferire la tua libreria a un altro servizio
• Mantenere una copia offline dei tuoi ricordi

Cos’è Immich Go?

Immich Go è uno strumento da riga di comando che si connette alla tua istanza PixelUnion e scarica tutte le tue foto e video preservando:

• Nomi file originali
• Date di creazione e metadati
• Strutture degli album
• File video

Passo 1: Ottieni la Tua Chiave API

Prima di poter usare Immich Go, devi generare una chiave API dal tuo account PixelUnion:

1. Accedi al tuo dominio PixelUnion (es. https://tuonome.pixelunion.eu)
2. Clicca sull’icona del tuo profilo in alto a destra
3. Seleziona Impostazioni account
4. Naviga verso Chiavi API
5. Clicca su Nuova chiave API
6. Assegnale un nome descrittivo (es. “Strumento di download”)
7. Copia la chiave API generata - ne avrai bisogno nel prossimo passo

⚠️ Importante: Mantieni la tua chiave API sicura e non condividerla con nessuno. Puoi revocarla in seguito se necessario.

Passo 2: Scarica Immich Go

Immich Go è un file eseguibile standalone che non richiede installazione:

1. Vai alla pagina delle versioni 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. Posiziona l’eseguibile immich-go in una cartella dove vuoi scaricare le tue foto (es. crea una cartella chiamata “Backup PixelUnion”)

Passo 3: Apri un Terminale

Dovrai eseguire Immich Go da un terminale/prompt dei comandi:

• Windows: Tasto destro sulla cartella dove si trova immich-go.exe → “Apri nel terminale” o “Apri finestra PowerShell qui”
• macOS: Apri l’applicazione Terminal (trovata in Applicazioni > Utilità), poi digita cd seguito da uno spazio, trascina la cartella con immich-go nella finestra del terminale e premi Invio
• Linux: Apri un terminale e naviga verso la cartella contenente immich-go

Passo 4: Esegui il Comando di Download

Nel terminale, esegui il seguente comando, sostituendo i segnaposto con le tue informazioni:

Windows:

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

macOS/Linux:

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

Sostituisci:

• tuonome.pixelunion.eu con il tuo dominio PixelUnion effettivo
• TUA_CHIAVE_API con la chiave API che hai copiato nel Passo 1
• ./PixelUnion-Backup con il percorso dove vuoi salvare le tue foto (puoi usare un percorso assoluto come /Users/tuonome/Downloads/PixelUnion-Backup o un percorso relativo come ./PixelUnion-Backup)

Cosa Succede Dopo?

Immich Go:

1. Si connetterà alla tua istanza PixelUnion
2. Scaricherà tutte le tue foto e video nella cartella specificata (--write-to-folder)
3. Preserverà i nomi file e le date originali
4. Mostrerà il progresso durante il download

Il download può richiedere del tempo a seconda di:

• La dimensione della tua libreria
• La velocità della tua connessione Internet
• Il numero di file

Nota: L’opzione --write-to-folder è obbligatoria. Assicurati di specificare un percorso della cartella dove vuoi salvare le tue foto e video.

Opzioni di Download

Puoi personalizzare il tuo download con opzioni aggiuntive:

Scaricare Solo Foto (Saltare Video)

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

Scaricare Solo Video (Saltare Foto)

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

Scaricare Solo Foto Preferite

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

Scaricare Foto da Album Specifici

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

Scaricare Foto con Tag Specifici

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

Scaricare Foto da un Intervallo di Date

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

Risoluzione dei Problemi

Problemi di Connessione

• Assicurati che il tuo dominio PixelUnion sia corretto (includi https:// e la / finale)
• Verifica che la tua chiave API sia corretta e non sia stata revocata
• Controlla la tua connessione Internet
• Assicurati di aver specificato l’opzione --write-to-folder con un percorso valido

Download Interrotto

• Immich Go riprenderà da dove si è fermato se esegui di nuovo il comando
• Non scaricherà nuovamente i file già presenti

Librerie Grandi

• Per librerie molto grandi (migliaia di file), il download può richiedere diverse ore
• Assicurati che il tuo computer non vada in sospensione durante il download
• Considera di eseguire il download durante la notte

Dopo il Download

Una volta completato il download:

• Le tue foto e video saranno nella cartella che hai specificato con --write-to-folder
• I file sono organizzati con i loro nomi e date originali
• Ora puoi fare un backup sicuro di questi file o trasferirli altrove

Hai Bisogno di Aiuto?

Se riscontri problemi usando Immich Go:

• Controlla la documentazione di Immich Go
• Contatta il nostro team di supporto per assistenza