Librerie esterne e strumenti di terze parti

Se hai gestito Immich in autonomia, potresti essere abituato a funzionalità che si basano sull’accesso diretto al server, come le librerie esterne o gli strumenti che si collegano al database di Immich. Poiché PixelUnion è un servizio gestito, alcune di queste funzionano diversamente. Questo articolo spiega cosa è possibile e cosa no.

Le librerie esterne non sono disponibili

In un’installazione self-hosted di Immich, una libreria esterna permette a Immich di leggere le foto da una cartella già presente sul server o su un’unità montata, ad esempio una cartella condivisa di un NAS. Immich indicizza quei file dove si trovano, senza copiarli nel proprio spazio di archiviazione.

Questa funzionalità non è disponibile su PixelUnion. Il tuo ambiente PixelUnion gira nel nostro data center e non ha accesso alle cartelle del tuo computer o NAS. Per lo stesso motivo, l’endpoint API /api/library, che gestisce le librerie esterne, è disabilitato.

Al suo posto, tutte le foto e i video su PixelUnion si trovano in una normale libreria gestita: i file vengono caricati nel tuo ambiente e archiviati da PixelUnion. Questo significa anche che hai il pieno controllo su tutto il suo contenuto. Puoi modificare, spostare nel cestino ed eliminare qualsiasi foto, cosa che non è possibile con i file di sola lettura di una libreria esterna.

Alternative

Per portare su PixelUnion le foto di una cartella o di un NAS, caricale:

• Immich Go: uno strumento a riga di comando che carica un’intera cartella in un colpo solo. Se lo esegui di nuovo più tardi, carica solo i file nuovi. Esempio:

  ./immich-go upload from-folder --server=https://yourname.pixelunion.eu --api-key=YOUR_API_KEY /path/to/your/photos
  

  Consulta Migrare da un altro server Immich per sapere come scaricare Immich Go e creare una chiave API.

• L’app mobile: esegui automaticamente il backup del rullino del telefono e di altre cartelle. Consulta App Mobile.

• L’interfaccia web: trascina file o cartelle nel browser. Consulta Caricare Foto.

Hai già un tuo server Immich con una libreria esterna? Puoi trasferire quella libreria su PixelUnion con Immich Go, consulta Migrare da un altro server Immich.

Usare l’API Immich e strumenti di terze parti

Puoi usare l’API Immich con le tue chiavi API, quindi la maggior parte degli strumenti basati sull’API funziona con PixelUnion. Crea una chiave API in Impostazioni account → Chiavi API. Solo due endpoint sono disabilitati: /api/library (librerie esterne) e /api/system-config (configurazione del server).

Alcuni strumenti di terze parti hanno bisogno di qualcosa in più dell’API. Si collegano direttamente al database di Immich o leggono il file system del server. PixelUnion non fornisce accesso diretto a nessuno dei due, quindi questi strumenti, o le loro funzionalità che ne dipendono, non funzioneranno.

Immich Power Tools è un esempio: diverse sue funzionalità interrogano direttamente il database di Immich. Le funzionalità che usano solo l’API potrebbero funzionare, ma aspettati che una parte dello strumento non sia disponibile.

Prima di affidarti a uno strumento di terze parti, controlla nella sua documentazione se richiede una connessione al database o l’accesso al file system.

Rimuovere i duplicati senza strumenti aggiuntivi

Immich ha un rilevamento dei duplicati integrato. Nell’interfaccia web, vai su Utilità → Rivedi duplicati per confrontare foto simili una accanto all’altra e scegliere quali conservare. I duplicati vengono rilevati per singolo utente, quindi le foto caricate da due utenti diversi non vengono confrontate tra loro.

Mantenere la struttura degli album in un backup locale

I tuoi dati vengono salvati da PixelUnion, consulta Come eseguiamo il backup dei tuoi dati. Se vuoi anche una tua copia locale, tieni presente che molti strumenti di download salvano i file, ma non gli album a cui appartengono.

Ci sono alcuni modi per conservare i tuoi album:

1. immich-archiver: il nostro strumento di download scrive un file .json accanto a ogni foto e video, che include gli album a cui appartiene. Consulta Scaricare Tutte le Foto e i Video.
2. Scaricare per album: apri un album nell’interfaccia web e scaricalo. Ottieni un file ZIP con tutte le foto e i video di quell’album, ma senza informazioni sull’album oltre alla cartella stessa.
3. Usare l’API: l’API Immich restituisce tutti i tuoi album e le foto di ciascun album, quindi puoi scrivere un tuo script se ti serve una struttura diversa.

Hai bisogno di aiuto?

Non sai se uno strumento o un flusso di lavoro funzionerà con PixelUnion? Contatta il nostro team di supporto e ti aiuteremo a verificarlo.