Експортувати до Immich¶
Цей інструмент надає змогу користувачеві вивантажувати фотографії на сервер Immich.
Immich — це платформа з відкритим початковим кодом для резервного копіювання фотографій і відео, яку ви розміщуєте на власних ресурсах. Ви самостійно запускаєте сервер Immich на власному обладнанні, а цей інструмент з’єднує digiKam з цим сервером, надаючи змогу публікувати на ньому фотографії, якими ви керуєте та які редагуєте в digiKam.
Додаток також містить допоміжний інструмент для завантаження, описаний у розділі Імпортування з Immich. Обидва інструменти використовують спільне вікно і однакові параметри з’єднання, але кожен із них працює у власному режимі; цей інструмент запускається за допомогою пункту меню .
Перш ніж виконувати будь-які дії, програма має встановити з’єднання з вашим сервером. У верхній частині вікна введіть Адресу вашого сервера Immich та Ключ API для розпізнавання, а потім натисніть кнопку З’єднатися. Програма перевірить налаштування, збереже їх для подальшого використання та завантажить список альбомів із сервера. Ключ API зберігається у торбинці KDE, якщо такий доступний. Завдяки збереженим налаштуванням програма встановлює з’єднання автоматично під час запуску, а повторне натискання кнопки З’єднатися надає змогу оновити список альбомів (наприклад, якщо у вебінтерфейсі Immich було створено нові альбоми або змінено назви наявних).
Ви можете створити ключ до програмного інтерфейсу у вебінтерфейсі Immich, перейшовши до розділу . Для цього ключа потрібні такі дозволи: asset.upload, asset.read, asset.view, asset.download, album.read, album.create, albumAsset.create та tag.read. Для оновлення метаданих фотографій, які вже знаходяться на сервері, додатково потрібні дозволи asset.update, tag.create та tag.asset. Щоб об’єднати нову версію фотографії з попередньою (створити стос), необхідні дозволи stack.create та stack.read, а для переміщення попередньої версії до смітника — дозвіл asset.delete.
Вікно інструменту експортування до Immich¶
Типово інструмент вивантажує записи, позначені у digiKam. Позначені записи буде показано у вікні у вигляді мініатюр, а набір записів, позначених у digiKam, становить набір для вивантаження.
За допомогою пунктів у розділі Вивантажити до ви визначаєте, куди саме на сервері потраплять фотографії. Типово вибрано варіант Лише бібліотека — у цьому разі знімки вивантажуються до бібліотеки, не прив’язуючись до жодного альбому. Також можна вибрати конкретний альбом, скориставшись плитками альбомів, розташованими нижче: вони впорядковані за назвою, список можна звузити за допомогою поля фільтрування, а кнопка Створити альбом надає змогу створити альбом на сервері. Вибране місце призначення зберігається для наступного сеансу.
Пункт Редаговані фотографії визначає, що відбувається, коли вивантажувана вами фотографія розпізнається як нова версія зображення, що вже є на сервері (докладніше про це — у розділі про повторний експорт нижче). Типово вибрано варіант Стос: нова версія розміщується поверх старої та стає основною в цій «стосі». Натомість варіант Перезаписати призводить до пересування старої версії до смітника Immich.
Поступ вивантаження під час експортування до Immich¶
Натисніть кнопку Вивантажити позначене, щоб перенести записи. Процес перенесення буде показано допомогою смужки поступу; кнопку Скасувати можна використати для його переривання. Після завершення перенесення у вікні з’явиться рядок із підсумковими даними: кількістю вивантажених, оновлених і пропущених записів.
Повторне експортування фотографій¶
Повторне експортування того самого набору є безпечним і в жодному разі не створює дублікатів на сервері. Інструмент ідентифікує файл як такий, що вже є на сервері, на основі його назви, часу зйомки та розмірів; це підтверджується порівнянням пікселів файла з копією, що зберігається на сервері. Подальші дії залежать від того, що змінилося з моменту останнього експортування:
Якщо нічого не змінилося, нічого не вивантажується, а записуються лише відмінності у метаданих, як показано нижче.
Якщо змінилися лише метадані, а піксельні дані залишилися незмінними, вивантаження файла також не відбуватиметься. Змінені мітки, оцінка, підпис і GPS-координати записуються до наявної на сервері фотографії за допомогою програмного інтерфейсу. Зміни міток мають адитивний характер: мітку, яку вилучено у програмі digiKam, не буде вилучено на сервері.
Якщо саме зображення було відредаговано, нова версія вивантажується і додається до кожного альбому, до якого належала попередня версія. Якщо позначено пункт Стос, нова версія стає основною в стосі разом із попередньою версією. Якщо позначено пункт Перезаписати, попередня версія переміщується до смітника Immich, звідки її можна відновити протягом 30 днів. В обох випадках замінений файл стає новим фотографічним об’єктом на сервері: посилання, створені для попередньої версії, перестають працювати, а зміни, внесені до попередньої версії в межах Immich, втрачаються.
Якщо фотографію було обрізано або змінено її розмір, через що її розмірності стали іншими, її буде замінено лише в тому разі, якщо перевірка підтверджує, що локальне зображення є обрізаною версією фотографії із сервера.
Якщо докази неоднозначні, нічого не перезаписується і не додається до стосу, а файл вивантажується як нова фотографія.
Перейменований файл неможливо розпізнати, оскільки для розпізнавання необхідно, щоб назва файла та час зйомки збереглися після редагування. Файли, які інструмент не може декодувати (наприклад, файли у форматі RAW), ніколи не замінюються і не об’єднуються у стос; проте їхні метадані все одно синхронізуються.
Переміщення метаданих¶
Метадані передаються між digiKam та Immich за допомогою допоміжних файлів XMP (так званих sidecar-файлів), які обидві програми вміють як зчитувати, так і створювати. Під час вивантаження інструмент формує такий файл на основі метаданих із бази даних digiKam — він містить мітки, оцінку, підпис і GPS-координати — та об’єднує його з наявними в оригінальному файлі даними XMP. Завдяки цьому властивості, які інструмент не змінює (зокрема кольорові мітки), зберігаються після такого обміну даними. Під час отримання допоміжний файл, записаний Immich, зберігається поруч із кожним оригінальним файлом.
Редагування на рівні пікселів не передаються через XMP. Лише оброблені експортовані файли — наприклад, у форматах JPEG або TIFF — дозволяють повернути зміни пікселів до Immich.