--- title: "Scaricare Tutte le Foto e i Video" description: "Scarica l'intera libreria PixelUnion sul tuo computer con immich-archiver o Immich Go" url: "https://pixelunion.eu/it/help/immich/download-photos-videos/" weight: 5 --- 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](https://github.com/pixelunioneu/immich-archiver/releases/latest) 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 | Opzione | Cosa fa | |---|---| | `--dry-run` | Mostra cosa verrebbe scaricato senza salvare nulla | | `--verbose` | Stampa una riga per file invece di un conteggio progressivo | | `--path-template "{year}/{month}/{day}"` | Cambia la struttura delle cartelle. Il valore predefinito è `{year}/{year}-{month}` | | `--include-shared` | Scarica anche gli album condivisi con te, in una cartella separata `shared-with-me` | | `--concurrency 8` | Scarica più file contemporaneamente. Il valore predefinito è 4 | | `--retries 5` | Riprova più volte i download falliti. Il valore predefinito è 3 | 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.

Bug noto in immich-go: nomi di file errati

È presente un bug noto in immich-go che interessa il comando archive from-immich. I file esportati possono ricevere nomi numerici errati (come -1, -2) senza estensione, e i metadati degli album potrebbero mancare dall'esportazione. È in corso una correzione. Puoi seguire i progressi su GitHub (PR #1272). Consigliamo di usare immich-archiver descritto sopra, oppure di attendere una versione aggiornata di immich-go prima di utilizzare questo comando.

### Scaricare Immich Go 1. Vai alla [pagina delle release di Immich Go](https://github.com/simulot/immich-go/releases/latest) 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](https://github.com/pixelunioneu/immich-archiver) - Per Immich Go, consulta la [documentazione di Immich Go](https://github.com/simulot/immich-go) - [Contatta il nostro team di supporto](/support/) per assistenza