Exporteren naar Immich¶
Met dit hulpmiddel kan de gebruiker foto’s uploaden naar een Immich-server.
Immich is een open-source platform voor het maken van back-ups van foto’s en video’s, dat u in eigen beheer host. U draait de Immich-server zelf op uw eigen hardware, en dit hulpmiddel koppelt digiKam aan die server, zodat de foto’s die u in digiKam beheert en bewerkt, daarheen kunnen worden geüpload.
De plug-in biedt ook een bijbehorende downloadhulpmiddel, die wordt beschreven in het hoofdstuk Import from Immich. Beide hulpmiddelen maken gebruik van hetzelfde venster en dezelfde verbindingsinstellingen, maar openen elk in hun eigen modus: dit specifieke hulpmiddel is toegankelijk via de menuoptie .
Voordat het hulpmiddel acties kan uitvoeren, moet deze verbinding maken met uw server. Voer bovenaan het venster de Server-URL van uw Immich-server en de API-sleutel voor authenticatie in, en klik vervolgens op de knop Verbinden. Het hulpmiddel controleert de instellingen, slaat deze op voor toekomstige sessies en laadt de lijst met albums vanaf de server. De API-sleutel wordt opgeslagen in de KDE-portefeuille, indien beschikbaar. Dankzij de opgeslagen instellingen maakt het hulpmiddel bij het opstarten automatisch verbinding. Door opnieuw op Verbinden te klikken, kunt u de lijst met albums verversen – handig wanneer er bijvoorbeeld albums zijn aangemaakt of hernoemd in de webinterface van Immich.
U maakt een API-sleutel aan in de webinterface van Immich, onder . De sleutel heeft de volgende rechten nodig: asset.upload, asset.read, asset.view, asset.download, album.read, album.create, albumAsset.create en tag.read. Voor het bijwerken van metagegevens van foto’s die al op de server staan, zijn bovendien asset.update, tag.create en tag.asset vereist. Om een vervangende foto te stapelen op de eerdere versie, zijn stack.create en stack.read nodig; voor het verplaatsen van de eerdere versie naar de prullenbak is asset.delete vereist.
Het dialoogvenster van het Immich-exporthulpmiddel¶
Standaard uploadt het hulpprogramma de items die op dat moment in digiKam zijn geselecteerd. De geselecteerde items worden als miniaturen in het venster weergegeven en de selectie die in digiKam is gemaakt, vormt de set voor de upload.
Met de opties onder Uploaden naar bepaalt u waar de foto’s op de server terechtkomen. De standaardinstelling, Alleen bibliotheek, plaatst de foto’s in de bibliotheek zonder ze aan een album toe te wijzen. Als alternatief kunt u een album kiezen uit de albumtegels hieronder: de tegels zijn gesorteerd op naam, een filterveld helpt u bij het doorzoeken van de lijst, en met de knop Nieuw album kunt u een nieuw album op de server aanmaken. De gekozen bestemming wordt onthouden voor een volgende sessie.
De optie Bewerkte foto’s bepaalt wat er gebeurt wanneer een foto die u uploadt, wordt herkend als een nieuwe versie van een foto die al op de server staat (zoals beschreven in het gedeelte over opnieuw exporteren hieronder). Bij Stapelen (de standaardinstelling) wordt de nieuwe versie boven op de oude geplaatst, waarbij deze fungeert als het hoofdbestand van de stapel. Bij Overschrijven wordt de oude versie daarentegen naar de prullenbak van Immich verplaatst.
De Immich-export wordt geüpload¶
Druk op de knop Selectie uploaden om de items over te dragen. Een voortgangsbalk geeft het verloop van de overdracht aan; met de knop Annuleren kunt u het proces afbreken. Zodra de overdracht is voltooid, verschijnt er een regel in het venster met een samenvatting van het resultaat, inclusief het aantal geüploade, bijgewerkte en overgeslagen items.
Foto’s opnieuw exporteren¶
Het opnieuw exporteren van dezelfde selectie is veilig en leidt nooit tot een dubbel exemplaar op de server. Het hulpmiddel herkent een bestand als een bestand dat al op de server aanwezig is, op basis van de bestandsnaam, het opnametijdstip en de afmetingen; dit wordt bevestigd door de pixels te vergelijken met het exemplaar op de server. Wat er vervolgens gebeurt, hangt af van wat er sinds de vorige export is gewijzigd:
Als er niets is veranderd, wordt er niets geüpload en worden alleen de verschillen in metagegevens vastgelegd, zoals hieronder weergegeven.
Als alleen de metagegevens zijn gewijzigd – terwijl de pixels identiek blijven – wordt er eveneens niets geüpload. De gewijzigde tags, beoordeling, bijschrift en GPS-positie worden via de API naar de bestaande foto op de server geschreven. Wijzigingen in tags zijn additief: een tag die in digiKam wordt verwijderd, wordt niet op de server verwijderd.
Als de foto zelf is bewerkt, wordt de nieuwe versie geüpload en toegevoegd aan elk album waartoe de oude versie behoorde. Bij de optie Stapelen wordt de nieuwe versie de hoofdfoto in een stapel samen met de oude versie. Bij de optie Overschrijven wordt de oude versie verplaatst naar de prullenbak van Immich, waar deze gedurende 30 dagen kan worden hersteld. In beide gevallen is de vervangende foto een nieuw bestand op de server: koppelingen die voor de oude versie waren aangemaakt, werken niet meer, en bewerkingen die in Immich op de oude versie waren toegepast, gaan verloren.
Als de foto is bijgesneden of het formaat ervan is aangepast, waardoor de afmetingen niet langer overeenkomen, wordt deze alleen vervangen wanneer uit een controle blijkt dat de lokale afbeelding een uitsnede is van de foto op de server.
Als het bewijsmateriaal dubbelzinnig is, wordt er niets overschreven of gestapeld en wordt het bestand als een nieuwe foto geüpload.
Een hernoemd bestand kan niet worden herkend, omdat voor herkenning zowel de bestandsnaam als het opnametijdstip na de wijziging behouden moeten blijven. Bestanden die het hulpprogramma niet kan decoderen, zoals RAW-bestanden, worden nooit vervangen of gestapeld; hun metagegevens wordt wel gesynchroniseerd.
Hoe metagegevens zich verplaatsen¶
Metagegevens wordt tussen digiKam en Immich uitgewisseld via XMP-aanhangselbestanden, die door beide programma’s kunnen worden gelezen en geschreven. Bij het uploaden genereert het hulpmiddel een aanhangselbestand op basis van de metagegevens in de database van digiKam – inclusief tags, beoordelingen, bijschriften en GPS-coördinaten – en voegt deze samen met de reeds aanwezige XMP-gegevens in het bestand. Hierdoor blijven eigenschappen die niet door het hulpmiddel worden aangepast, zoals kleurlabels, behouden tijdens het hele proces. Bij het downloaden wordt het door Immich aangemaakte aanhanselbestand naast elk origineel bestand opgeslagen.
Pixelbewerkingen worden niet via XMP overgedragen. Alleen gerenderde exports, zoals JPEG- of TIFF-bestanden, bevatten pixelwijzigingen die terugkeren naar Immich.