Externe bibliotheken en tools van derden

Als je Immich zelf hebt gedraaid, ben je misschien gewend aan functies die directe toegang tot de server nodig hebben, zoals externe bibliotheken of tools die verbinding maken met de Immich-database. Omdat PixelUnion een beheerde dienst is, werken een paar van deze dingen anders. In dit artikel lees je wat wel en niet mogelijk is.

Externe bibliotheken zijn niet beschikbaar

In een zelf gehoste Immich-installatie kan Immich met een externe bibliotheek foto’s inlezen uit een map die al op de server of op een gekoppelde schijf staat, bijvoorbeeld een gedeelde map op een NAS. Immich indexeert die bestanden op hun huidige plek, zonder ze naar de eigen opslag te kopiëren.

Deze functie is niet beschikbaar op PixelUnion. Je PixelUnion-omgeving draait in ons datacenter en heeft geen toegang tot mappen op je eigen computer of NAS. Om dezelfde reden is het API-endpoint /api/library, waarmee externe bibliotheken worden beheerd, uitgeschakeld.

In plaats daarvan staan alle foto’s en video’s op PixelUnion in een gewone beheerde bibliotheek: bestanden worden naar je omgeving geüpload en door PixelUnion opgeslagen. Dat betekent ook dat je volledige controle hebt over alles wat erin staat. Je kunt elke foto bewerken, naar de prullenbak verplaatsen en verwijderen. Bij de alleen-lezen bestanden van een externe bibliotheek kan dat niet.

Alternatieven

Wil je foto’s uit een map of van een NAS in PixelUnion krijgen? Upload ze dan:

• Immich Go: een opdrachtregeltool die een hele map in één keer uploadt. Voer je het later opnieuw uit, dan uploadt het alleen nieuwe bestanden. Voorbeeld:

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

  Zie Migreren vanuit een andere Immich-server voor het downloaden van Immich Go en het aanmaken van een API-sleutel.

• De mobiele app: maak automatisch een backup van de filmrol en andere mappen op je telefoon. Zie Mobiele App.

• De webinterface: sleep bestanden of mappen naar je browser. Zie Foto’s Uploaden.

Draai je al een eigen Immich-server met een externe bibliotheek? Dan kun je die bibliotheek met Immich Go naar PixelUnion verhuizen, zie Migreren vanuit een andere Immich-server.

De Immich-API en tools van derden gebruiken

Je kunt de Immich-API gebruiken met je eigen API-sleutels, dus de meeste tools die op de API zijn gebouwd werken met PixelUnion. Maak een API-sleutel aan onder Accountinstellingen → API-sleutels. Er zijn maar twee endpoints uitgeschakeld: /api/library (externe bibliotheken) en /api/system-config (serverconfiguratie).

Sommige tools van derden hebben meer nodig dan de API. Ze maken rechtstreeks verbinding met de Immich-database of lezen het bestandssysteem van de server. PixelUnion biedt geen directe toegang tot een van beide, dus die tools, of de onderdelen ervan die daarvan afhankelijk zijn, werken niet.

Immich Power Tools is een voorbeeld: verschillende functies daarvan bevragen de Immich-database rechtstreeks. Functies die alleen de API gebruiken, werken mogelijk wel, maar reken erop dat een deel van de tool niet beschikbaar is.

Ga je op een tool van derden vertrouwen? Controleer dan eerst in de documentatie of de tool een databaseverbinding of toegang tot het bestandssysteem nodig heeft.

Duplicaten verwijderen zonder extra tools

Immich heeft ingebouwde duplicaatdetectie. Ga in de webinterface naar Gereedschap → Duplicaten beoordelen om vergelijkbare foto’s naast elkaar te bekijken en te kiezen welke je wilt houden. Duplicaten worden per gebruiker gedetecteerd, dus foto’s die door twee verschillende gebruikers zijn geüpload, worden niet met elkaar vergeleken.

Je albumstructuur bewaren in een lokale backup

PixelUnion maakt een backup van je data, zie Backups: hoe we een backup van je data maken. Wil je daarnaast een eigen lokale kopie? Houd er dan rekening mee dat veel downloadtools wel de bestanden zelf opslaan, maar niet in welke albums ze zitten.

Er zijn een paar manieren om je albums te bewaren:

1. immich-archiver: onze eigen downloadtool schrijft naast elke foto en video een .json-bestand, met daarin onder andere de albums waar het bestand in zit. Zie Download Alle Foto’s en Video’s.
2. Per album downloaden: open een album in de webinterface en download het. Je krijgt een ZIP-bestand met alle foto’s en video’s uit dat album, maar geen albuminformatie behalve de map zelf.
3. De API gebruiken: de Immich-API geeft al je albums en de foto’s in elk album terug, dus je kunt een eigen script schrijven als je een andere structuur nodig hebt.

Hulp nodig?

Weet je niet zeker of een tool of werkwijze met PixelUnion werkt? Neem contact op met ons supportteam, dan helpen we je het uit te zoeken.