Lychee помогает загружать, сортировать, просматривать и публиковать фотоколлекции: фотографии объединяются в обычные и вложенные альбомы, помечаются тегами и оценками, ищутся по библиотеке, показываются в полноэкранном режиме, на временной шкале и карте по GPS-метаданным, а доступ к альбомам можно открывать публично, по паролю или отдельным пользователям.

Основная логика работы строится вокруг галереи, альбомов и карточек снимков. Владелец коллекции задаёт обложки и заголовочные изображения, выбирает раскладку миниатюр, меняет порядок фотографий, переносит и копирует кадры, редактирует названия, описания и даты съёмки. Для больших наборов доступны массовое выделение, пакетное назначение тегов и импорт из каталога через команду синхронизации, а крупные файлы при обычной загрузке передаются частями.

Lychee особенно полезен там, где фотографии нужно не ретушировать, а систематизировать и показывать другим людям: для семейного архива, каталога поездок, портфолио, внутренней медиатеки небольшой команды или личной галереи. Оригиналы сохраняются, для просмотра создаются оптимизированные варианты, EXIF читается и может отображаться в панели сведений, геометки используются на карте, а права на просмотр, запись и скачивание задаются для конкретных альбомов.

Для каких задач подходит Lychee

Программа решает задачу хранения и представления уже подготовленных фотографий. Её сильная сторона — не набор художественных фильтров, а связка файл — метаданные — альбом — права доступа — публичный показ. После загрузки кадр становится элементом библиотеки: его можно описать, датировать, пометить тегами, оценить, переместить в другой альбом, скопировать в несколько подборок, открыть в полноэкранном просмотре или скачать в исходном качестве. Благодаря такой модели один и тот же архив можно одновременно использовать для личного просмотра и для аккуратно оформленной публикации.

Для фотографа Lychee удобен как витрина готовых серий: отдельный альбом может иметь свою обложку, заголовочное изображение, порядок кадров и визуальную раскладку. Для семьи полезна древовидная организация по годам, событиям и людям. Для путешествий работают даты и координаты из EXIF. Для небольшой команды важны учётные записи и права на конкретные альбомы. При этом программа не заменяет RAW-конвертер, редактор с масками или систему верстки фотокниг: её рабочая область начинается там, где снимки уже готовы к каталогизации и показу.

Публичная галерея не обязана совпадать со всей внутренней библиотекой. Альбомы могут оставаться закрытыми, открываться отдельным зарегистрированным пользователям либо становиться публичными. Для публичного альбома можно потребовать пароль, разрешить или запретить скачивание и решить, показывать ли его в общем списке публичных подборок. Такой подход помогает не дублировать фотографии в отдельное публичное хранилище: граница проходит по настройкам доступа.

Как устроена библиотека

Основной контейнер для фотографий — альбом. Количество альбомов программой не ограничивается, а сами альбомы можно вкладывать друг в друга. Поэтому структуру не приходится сводить к одному плоскому списку. Например, верхний уровень можно разбить на Семья, Путешествия и Работа, внутри Путешествий сделать годы, а ниже — города или поездки. В профессиональной библиотеке верхним уровнем могут быть клиенты, внутри — проекты, а ещё глубже — этапы съёмки или финальные серии.

Вложенность полезна не только для порядка. Она задаёт понятный маршрут просмотра: человек сначала выбирает крупную тему, затем конкретную серию. Если вложений становится слишком много, навигация, напротив, усложняется, поэтому разумно не превращать дерево альбомов в копию всей файловой системы. Лучше создавать уровень только тогда, когда он действительно помогает выбрать нужную группу материалов.

Каждому альбому можно назначить фотографию-обложку. Отдельно поддерживается заголовочное изображение, которое используется как широкий визуальный акцент в верхней части альбома. Это две разные роли: обложка помогает распознать альбом в общей галерее, а заголовочное изображение оформляет страницу уже после входа в него. Для портфолио имеет смысл выбирать для обложки самый узнаваемый кадр серии, а в заголовок ставить изображение, которое хорошо переносит широкое кадрирование.

Вложенные альбомы без путаницы

При планировании структуры удобно отделять физическое происхождение файлов от смысловой навигации. Название папки на диске может содержать номер заказа или дату, но посетителю галереи это не всегда помогает. В Lychee альбом можно назвать по событию или теме, а дату и технические сведения оставить самим фотографиям. Тогда дерево остаётся читабельным, даже если исходные каталоги организованы по другой схеме.

Если один сюжет относится к нескольким темам, не обязательно создавать дополнительную ветку и вручную дублировать все кадры. Для поперечной классификации есть теги, поиск и динамические Tag Albums. Альбомы лучше оставить для основной иерархии, а метки — для признаков, которые пересекают её: ночь, панорама, портрет, архитектура, выбрано в печать или собственные рабочие категории.

Добавление фотографий и видео

При обычной работе файлы можно перетащить в окно галереи или вызвать загрузку из верхней панели. Для крупных файлов используется передача частями: клиент разбивает загрузку на управляемые фрагменты, что уменьшает риск потери всего прогресса из-за одного сбоя соединения. Однако итог всё равно зависит от ограничений веб-сервера, прокси, PHP и доступного места, поэтому при систематических ошибках на больших файлах нужно проверять не только интерфейс Lychee, но и лимиты окружения.

Для массового ввода уже существующего архива предусмотрена командная синхронизация каталога. Такой вариант удобнее ручного выбора, когда на сервере уже лежат десятки или сотни папок. Синхронизация особенно полезна при первичном переносе большой коллекции: администратор указывает путь к импорту и позволяет программе обработать набор последовательно. Перед таким импортом полезно привести имена каталогов к понятной системе и проверить права чтения, чтобы ошибки структуры не пришлось исправлять уже внутри галереи.

Официально заявлены изображения JPG, JPEG, PNG, GIF и WebP. Для видео перечислены OGV, MP4, MPG, WebM, MOV, M4V, AVI и WMV. Наличие расширения в списке означает, что Lychee принимает такой тип, но фактическое воспроизведение видео в браузере зависит от кодека внутри контейнера и от возможностей конкретного браузера. Поэтому для публичной галереи безопаснее заранее проверять ролики на том наборе браузеров и устройств, которым будут пользоваться посетители.

RAW-файлы не следует воспринимать как материал, который Lychee проявляет подобно специализированному конвертеру. В настройках есть механизм дополнительных расширений, которые могут трактоваться как raw/passthrough и сохраняться без обычной обработки изображения. Если архив построен вокруг RAW, практичнее публиковать рядом готовые JPEG или WebP для просмотра, а исходники хранить как мастер-файлы в отдельном рабочем процессе.

Что происходит после загрузки

Для обычных изображений Lychee сохраняет оригинал и создаёт оптимизированные варианты, используемые интерфейсом. Это важно для двух разных задач. Посетителю не нужно каждый раз получать многомегабайтный исходник ради сетки миниатюр, а владелец при разрешённом скачивании может получить исходное разрешение. При планировании диска поэтому нужно учитывать не только размер оригинальной коллекции, но и место для производных файлов.

При обработке фотографии программа читает EXIF, учитывает Orientation для автоматического поворота и извлекает доступные GPS-координаты. Если дата съёмки присутствует в метаданных, она может участвовать в хронологической организации. Когда метаданные отсутствуют или повреждены, итоговая дата и ориентация могут потребовать ручной проверки. Особенно это характерно для изображений, прошедших через мессенджеры, социальные сети или приложения, которые удаляют EXIF при экспорте.

Форматы и практическая совместимость

Тип материала	Поддерживаемые расширения	Практическое замечание
Фотографии	JPG, JPEG, PNG, GIF, WebP	Подходят для обычной загрузки, миниатюр и просмотра.
Видео	OGV, MP4, MPG, WebM, MOV, M4V, AVI, WMV	Воспроизведение зависит также от кодека и браузера.
Дополнительные исходники	Задаются администратором	Могут храниться как passthrough без обработки изображения.

При подготовке смешанной коллекции стоит различать файл принимается и файл удобно просматривать у всех посетителей. Например, MOV — это контейнер, внутри которого могут быть разные видеокодеки. Старый ролик может нормально открываться на одном компьютере и не воспроизводиться на другом. Если галерея рассчитана на широкую аудиторию, тестовый альбом с типичными видео помогает выявить такие расхождения до публикации большого архива.

Для изображений аналогичная осторожность нужна с анимацией и прозрачностью. GIF и PNG выполняют разные задачи, а при создании производных вариантов визуальный результат стоит проверить на реальных материалах: мелкий текст, графика с прозрачным фоном и фотографии с плавными градиентами чувствительны к преобразованиям сильнее обычных снимков. Если конкретная картинка используется как важный элемент оформления, лучше открыть её в полном размере после импорта, а не судить только по миниатюре.

Карточка снимка и метаданные

Карточка фотографии объединяет визуальный просмотр и сведения, которые помогают понять, что именно хранится в библиотеке. Для снимка можно редактировать название и описание, менять дату, назначать теги и оценку. EXIF при включённом отображении выводится в панели деталей, поэтому технические данные не приходится искать во внешней утилите каждый раз, когда нужно вспомнить параметры кадра. Полнота панели зависит от того, какие поля реально записаны в исходный файл.

Название удобно использовать как короткий человекочитаемый идентификатор, а описание — как контекст: место, событие, имена участников, примечание к публикации. Если заполнять эти поля последовательно, поиск по библиотеке становится заметно полезнее. Нечёткая практика вроде IMG_0042 в названии и пустого описания оставляет поиск почти без семантических ориентиров, тогда как Вечер у маяка и краткое пояснение позволяют найти кадр по смыслу.

Дата снимка влияет на хронологию, сортировку и сценарии просмотра по времени. Если камера записала неверный часовой пояс или файл был пересохранён программой, которая изменила метаданные, дата может не соответствовать событию. Lychee позволяет изменить её вручную. Перед массовым исправлением лучше сначала проверить небольшой набор, потому что ошибка на целый год или месяц способна изменить порядок сотен кадров.

В настройках предусмотрен выбор поведения на случай, когда EXIF не содержит даты создания: при необходимости можно использовать время последнего изменения файла. Это компромисс, а не универсальная замена EXIF. Время изменения легко меняется при копировании, восстановлении из архива или обработке сторонней программой, поэтому для исторических коллекций такое правило следует включать только после оценки метаданных.

EXIF, XMP и отображение деталей

EXIF считывается автоматически, а показ технических сведений в интерфейсе можно отключить. Есть также настройка, которая позволяет держать панель деталей фотографии открытой по умолчанию. Для работы с архивом это удобно: при проверке серии можно переходить от кадра к кадру и сразу видеть доступные сведения вместо постоянного открытия боковой панели.

Для сценариев, где рядом с изображениями используются XMP sidecar-файлы, существует параметр предпочтения доступных XMP-метаданных перед встроенным EXIF. Это полезно только при понимании происхождения sidecar: если XMP создавался в редакторе и содержит более свежие описания или даты, ему можно дать приоритет. Если sidecar старый, приоритет наоборот способен вернуть устаревшие значения. Перед включением на большой библиотеке стоит сравнить несколько файлов с известными метаданными.

Координаты из EXIF имеют отдельное значение, потому что используются картой. Если фотография содержит GPS, место может быть показано как маркер. Если координат нет, одна только подпись Париж в описании не превращает кадр в геотегированный объект карты. Поэтому для географического архива важно сохранить EXIF при экспорте из редактора либо внести геоданные до загрузки.

Массовое выделение и операции с группой

Когда серия состоит из десятков кадров, работа по одному быстро становится непрактичной. Lychee поддерживает выбор нескольких фотографий, после чего к группе можно применять доступные операции управления. Это используется для переноса, копирования и назначения тегов. Массовое выделение особенно полезно сразу после импорта, пока фотографии расположены рядом и границы серии легко распознать визуально.

Перемещение и копирование решают разные организационные задачи. Перемещение меняет основной контекст хранения в библиотеке: кадр оказывается в другом альбоме. Копирование позволяет включить фотографию в несколько альбомов, не заставляя пользователя повторно загружать файл вручную. Перед крупной операцией стоит проверить, выбран ли правильный режим, особенно если альбомы похожи по названию.

Пакетное назначение тегов допускает два подхода: добавить новые метки к уже существующим или заменить набор меток у выбранных фотографий. Первый режим безопаснее для пополнения классификации. Второй полезен при исправлении неправильной разметки, но требует внимательности, потому что прежние теги выбранных снимков будут вытеснены. Если цель — добавить один общий признак серии, замена обычно не нужна.

Хорошая практика для массовой обработки — делать изменения блоками с понятной целью. Сначала перенести фотографии по альбомам, затем назначить общие теги, после этого проверить даты и только потом выставлять оценки. Когда все операции смешиваются в одном длинном сеансе, сложнее заметить, на каком шаге появилась ошибка и какую группу она затронула.

Теги как поперечная классификация

Теги в Lychee — глобальные сущности библиотеки. Они предназначены для признаков, которые неудобно выражать одной иерархией альбомов. В фотоархиве это могут быть жанры, места, люди, техника, состояние отбора или тематические признаки. Один снимок может одновременно относиться к альбому конкретной поездки и иметь метки архитектура, ночь и длинная выдержка.

Ввод тегов поддерживает автодополнение существующими значениями, поэтому при последовательной работе уменьшается риск создать несколько вариантов одной метки из-за мелких различий в написании. Новый тег также можно создать прямо при разметке фотографии. У тегов есть описания, что особенно полезно в коллективной библиотеке: можно зафиксировать, что именно означает неоднозначная метка и когда её применять.

Для обслуживания словаря предусмотрены переименование, объединение и удаление. Объединение помогает исправить ситуацию, когда появились два почти одинаковых термина. Например, вместо параллельных черно-белое и чб можно выбрать единый вариант и свести разметку. Переименование меняет термин без необходимости открывать каждый кадр отдельно. Удаление снимает ненужную категорию с фотографий владельца; в многопользовательской среде правила учитывают принадлежность фотографий и административные права.

Система тегов работает лучше, если заранее ограничить уровень детализации. Слишком общие метки вроде фото ничего не дают, а чрезмерно дробные вроде отдельного тега для каждого случайного предмета создают длинный словарь, которым никто не пользуется. Полезные теги отвечают на реальные вопросы поиска: покажи все панорамы, найди семейные кадры с дачи, собери фотографии для зимнего портфолио.

Как не превратить теги в беспорядок

• Используйте один язык и единый вариант написания для одного понятия.
• Не дублируйте в тегах полную структуру альбомов, если она уже хорошо решает навигацию.
• Перед массовой разметкой проверьте автодополнение и выберите существующую метку.
• Периодически объединяйте синонимы и удаляйте категории, которые перестали использоваться.
• Для рабочих состояний выбирайте небольшой фиксированный набор: например, отбор, готово, архив.

В многопользовательском режиме важно понимать глобальность названий тегов. Два пользователя, выбравшие одинаковое имя, обращаются к одной сущности тега, но обычные операции управления затрагивают собственные фотографии пользователя; администратор обладает более широкими полномочиями. Это снижает количество дублей словаря, но требует аккуратных названий в общей галерее.

Tag Albums: подборки, которые обновляются сами

Tag Albums — динамические альбомы, состав которых определяется тегами. Пользователь выбирает одну или несколько меток и условие совпадения. В режиме OR достаточно наличия любой из выбранных меток; в режиме AND фотография должна содержать их все. После изменения тегов подходящие подборки пересчитываются автоматически, поэтому не приходится вручную переносить кадр в каждую тематическую коллекцию.

Практический пример OR — альбом Города Европы, собранный из тегов нескольких городов. Он показывает кадры, относящиеся хотя бы к одному из них. Пример AND — Ночной Берлин: фотография попадёт в подборку только при одновременном наличии тегов Берлин и ночь. Такой механизм полезен для портфолио, где один и тот же архив нужно показывать под несколькими смысловыми срезами.

При проектировании Tag Albums сначала стоит привести теги к стабильному словарю. Если условие построено на двух синонимах, а будущие кадры размечаются третьим вариантом, подборка будет казаться неполной. Динамический альбом не угадывает смысл меток; он последовательно применяет заданное условие. Поэтому качество результата напрямую зависит от дисциплины разметки.

Есть отдельная настройка, которая может позволить видимости Tag Album перекрывать видимость отдельных фотографий. Это параметр с серьёзным последствием для приватности: при его включении соответствующие снимки могут стать доступнее, чем предполагают их индивидуальные настройки. Если галерея содержит личные материалы, безопаснее сначала проверить правило на тестовой подборке и открыть её в сеансе без авторизации.

Поиск по библиотеке

Поиск охватывает названия и описания фотографий, имена альбомов и теги в пределах доступной пользователю библиотеки. Поэтому он дополняет, а не заменяет продуманную структуру. Альбом отвечает на вопрос где лежит серия, теги — какими признаками обладает кадр, а текстовый поиск помогает быстро обратиться к этим данным без ручного прохода по дереву.

Качество поиска определяется тем, что было введено в карточки. Если в названии альбома есть город, а в описании кадра — название события, оба признака могут стать точкой входа. Если же вся библиотека состоит из исходных имён файлов и пустых полей, возможности поиска закономерно ограничены. Для большого архива полезно ввести короткий стандарт описаний и применять его хотя бы к финальным сериям.

Администратор может разрешить или запретить публичный поиск. Разрешение означает, что посетители без входа смогут искать по тем материалам, которые и так относятся к публичной части. На персональной галерее это может быть удобным каталогом, а на небольшой закрытой витрине — лишним элементом. Решение зависит от того, должна ли публичная часть работать как searchable-архив или только как последовательный набор альбомов.

При проверке публичного поиска нужно выходить из административной учётной записи. Администратор видит больше данных и не подходит для моделирования поведения гостя. Откройте галерею в приватном окне, введите слова из публичного и закрытого альбомов и убедитесь, что результаты соответствуют задуманным границам доступа.

Оценки и отбор фотографий

Фотографии можно оценивать от одной до пяти звёзд. Рейтинг удобен как независимая от альбомов шкала отбора: один альбом сохраняет всю серию, а оценка показывает субъективную ценность или степень готовности кадра. Система не навязывает смысл каждой звезде, поэтому его лучше определить заранее и придерживаться одной схемы.

Например, одна звезда может означать технически допустимый кадр, три — хороший рабочий вариант, пять — избранное для показа. Другая команда может использовать рейтинг только для финального отбора. Важно не смешивать две разные шкалы в одной библиотеке, иначе пять звёзд перестанут иметь однозначное значение.

Оценки особенно полезны вместе с другими признаками. Альбом задаёт событие, тег — тему, а рейтинг — качество или приоритет. Тогда поиск и тематические подборки можно использовать для навигации, а звёзды — для быстрого выбора лучшего внутри найденной группы. Это не заменяет визуального просмотра, но сокращает повторную сортировку уже отсмотренной серии.

Карта и фотографии с GPS

Модуль карты показывает геотегированные фотографии на интерактивной карте. Для кадров используются маркеры, а в местах с большим количеством точек они объединяются в кластеры. По маркеру можно открыть предварительный просмотр снимка. Доступна фильтрация по альбому и диапазону дат, поэтому карта способна работать не только как глобальная география всего архива, но и как маршрут конкретной поездки.

Условие работы простое: фотография должна содержать координаты. Если экспорт из фоторедактора удалил GPS ради приватности, Lychee не сможет восстановить место по одному названию файла. Перед импортом туристического архива полезно проверить несколько исходников на наличие координат, особенно если фотографии прошли через разные камеры и телефоны.

Для публичной галереи геоданные нужно рассматривать как чувствительную часть метаданных. Домашний адрес, место учёбы, регулярный маршрут или координаты частной съёмки могут оказаться более информативными, чем сама фотография. Если точное место не должно становиться публичным, удалите GPS из файла до публикации либо держите соответствующий альбом закрытым. Проверка должна выполняться в гостевом режиме, а не только из аккаунта владельца.

Карта полезна для архивов путешествий, полевых наблюдений и длительных фотопроектов. Фильтр по диапазону дат помогает отделить разные поездки в один и тот же регион. Кластеры делают плотные области читаемее, но они не исправляют ошибочные координаты: единичная точка в другой стране почти всегда указывает на проблемы в метаданных и требует проверки исходного снимка.

Хронологический просмотр

Lychee предлагает временную шкалу как способ просматривать фотографии по времени. Для библиотеки, где даты съёмки заполнены корректно, такой режим даёт второй маршрут навигации помимо альбомов. Он особенно удобен для длинного личного архива: вместо знания точного названия альбома можно перейти к нужному периоду и увидеть материалы в хронологическом контексте.

Хронология чувствительна к качеству дат. Снимок с ошибочным 1970 или с текущей датой экспорта вместо даты съёмки окажется в неожиданном месте. Поэтому перед тем, как считать временную шкалу основным способом просмотра, полезно провести выборочную проверку самых старых и самых новых периодов, а также кадров из камер с когда-либо сбрасывавшимися часами.

Настройка домашней страницы позволяет выбрать, какой раздел показывать на корневом адресе: обычную галерею, Flow или Timeline. Это влияет на первое впечатление посетителя. Для портфолио чаще логичнее галерея с тщательно оформленными альбомами; для дневникового архива хронология может быть естественнее. Выбор стоит делать по задаче показа, а не потому, что один режим выглядит необычнее другого.

Полноэкранный просмотр и слайд-шоу

Открытая фотография может просматриваться в полноэкранном режиме с переходом к соседним кадрам. Слайд-шоу автоматизирует этот переход. Интервал задаётся настройкой, стандартное значение — пять секунд. Есть отдельный параметр циклического перехода: при включении после последнего кадра просмотр возвращается к первому, а при переходе назад с первого — к последнему.

Для презентации серии скорость имеет значение. Короткий интервал подходит для быстрого просмотра большого набора, но мешает рассмотреть насыщенный деталями кадр. Длинный интервал удобен для выставочного режима, но может сделать обычное портфолио медленным. Поскольку параметр настраивается, его стоит подбирать на реальной серии, а не оставлять случайное значение.

Видео в слайд-шоу обрабатывается иначе, чем статичная фотография: переход ожидает окончания ролика. Если автозапуск видео запрещён браузером, автоматическая последовательность может остановиться на таком элементе. Ручные переходы при этом остаются рабочим способом продолжить просмотр. Если публичный альбом смешивает фото и видео, обязательно протестируйте его в браузере с типичными ограничениями автозапуска.

Кнопки перехода между соседними фотографиями могут появляться при приближении курсора к краям экрана, а их размер регулируется настройкой. Это важно учитывать при тестировании интерфейса: отсутствие постоянно видимой стрелки не обязательно означает отсутствие навигации. На сенсорном устройстве следует отдельно проверить жесты и элементы, которые реально предлагает текущий интерфейс браузера.

Публичные и закрытые альбомы

Настройки доступа в Lychee применяются к альбомам и позволяют разделить внутреннюю медиатеку и то, что видит посетитель. Альбом может быть закрытым или публичным. Публичный вариант доступен гостям, но при необходимости защищается паролем. Отдельно задаётся возможность скачивания и участие альбома в общей публичной галерее. Это даёт несколько уровней публикации без создания дубликатов одной серии.

Для портфолио логична схема, при которой только законченные серии включаются в публичную галерею. Черновые отборы и личные материалы остаются закрытыми. Для передачи конкретному человеку можно открыть альбом и установить пароль, не выводя его в общий публичный каталог. В таком сценарии адрес альбома всё равно следует считать ссылкой доступа, поэтому пароль нужен там, где содержимое не предназначено для случайного посетителя.

Разрешение скачивания нужно принимать отдельно от разрешения просмотра. Клиенту может быть разрешено получить оригиналы, а посетителю портфолио — только посмотреть изображения. Если публичный альбом задуман как витрина, отключение скачивания снижает вероятность простого получения оригинала через штатную кнопку, однако не превращает изображение, уже показанное браузеру, в технически неуязвимый объект. Для действительно чувствительных материалов важнее контроль доступа, чем попытка защитить публично видимую картинку.

После изменения прав полезно проверить четыре вещи: отображается ли альбом в публичном списке, открывается ли его прямая страница без входа, требуется ли пароль там, где он задан, и доступна ли штатная загрузка оригиналов. Такой короткий тест ловит большинство ошибок конфигурации, которые незаметны из административной сессии.

Чувствительные альбомы

Альбом можно пометить как sensitive. Такая отметка скрывает содержимое за дополнительным действием пользователя и помогает не показывать соответствующие превью сразу в публичных лентах или подборках. Это дополнительный уровень представления, а не замена приватности. Если материал не должен быть доступен посторонним, он должен оставаться закрытым независимо от sensitive-метки.

При использовании Tag Albums следует учитывать отдельные настройки скрытия sensitive-фотографий в динамических подборках и списках тегов. Здесь важно проверять сочетание параметров, а не один переключатель. Снимок может участвовать в теге и одновременно относиться к чувствительному содержимому; итоговая видимость определяется тем, как настроена соответствующая подборка и общий режим доступа.

Доступ для зарегистрированных пользователей

Lychee поддерживает несколько пользователей и назначение прав на уровне альбома. Конкретному человеку можно предоставить чтение либо более полный доступ, а также управлять возможностью скачивания. Такая модель подходит для семейного архива, рабочей медиатеки или совместного ведения галереи, где не всем участникам нужны одинаковые полномочия.

Права следует выдавать от минимально необходимого уровня. Если человеку требуется только посмотреть готовую серию, ему не нужны операции изменения. Если редактор должен добавлять и организовывать материалы, доступ может быть шире. Такой подход уменьшает риск случайного перемещения, переименования или удаления элементов людьми, которым эти действия не относятся к работе.

Cross-user sharing позволяет делиться альбомами между пользователями одной установки. Благодаря этому каждому участнику не приходится держать отдельную копию общей серии. На практике полезно договориться, кто отвечает за структуру и теги: техническая возможность совместной работы не отменяет организационных конфликтов, когда два человека одновременно применяют разные правила именования.

Вход, приглашения и регистрация

Поддерживаются обычная пара логин-пароль, WebAuthn и OAuth. WebAuthn позволяет использовать совместимые ключи безопасности или биометрическую проверку, а OAuth — внешнего поставщика идентификации. Набор реально доступных способов зависит от того, что администратор настроил в конкретной установке. Для небольшой частной галереи достаточно одного понятного механизма, а дополнительные варианты стоит включать только при необходимости.

Регистрацию можно открыть для новых пользователей, а приглашения — выдавать ссылками. Для частной семейной или рабочей медиатеки открытая самостоятельная регистрация часто не требуется: приглашение даёт владельцу более контролируемый процесс добавления участников. После создания пользователя всё равно следует проверить права на нужные альбомы, потому что наличие учётной записи само по себе не означает доступ ко всей библиотеке.

У пользователей есть уровни доверия, которые регулируют возможности аккаунта. При настройке общей галереи лучше начать с ограниченного набора полномочий и расширять его по реальной задаче. Это особенно важно, если в библиотеке есть как публичные серии, так и закрытые семейные или клиентские материалы.

Встраивание альбомов на другие страницы

Альбомы Lychee можно встраивать на внешние сайты. Такой режим полезен, если основная галерея хранит и организует фотографии, а публикация происходит внутри портфолио, блога или страницы проекта. Встроенный альбом избавляет от ручной подготовки второго набора миниатюр и поддерживает связь с исходной коллекцией.

Перед встраиванием нужно решить вопрос доступа. Закрытый альбом не следует делать публичным только ради того, чтобы он появился на внешней странице. Если страница доступна всем, встроенный материал фактически тоже становится частью публичного представления. Для портфолио лучше создать отдельную публикационную подборку с теми кадрами, которые действительно предназначены для внешнего показа.

Следует также проверить поведение на узких экранах. Внешняя страница задаёт собственную ширину контейнера, а внутри отображается галерея с миниатюрами. Если исходный макет рассчитан только на большой монитор, встраивание может выглядеть тесно на телефоне. Финальная проверка должна включать хотя бы широкий экран и типичный мобильный размер.

Раскладка фотографий внутри альбома

Для отображения снимков доступны несколько схем: square, justified, masonry и grid. Они по-разному обращаются с пропорциями исходных кадров. Квадратная сетка делает ритм страницы строгим и предсказуемым, но сильнее кадрирует превью. Justified стремится формировать ровные строки при сохранении разных пропорций. Masonry строит колонки переменной высоты. Grid даёт ещё один вариант регулярной компоновки.

Выбор зависит от характера серии. Для каталожных изображений одинаковой композиции квадратная сетка может быть удобной. Для пейзажей и панорам лучше схема, которая меньше скрывает исходное соотношение сторон. Для смеси вертикальных и горизонтальных кадров masonry помогает избежать одинакового кадрирования, но страница становится менее строгой. Настройку стоит оценивать не на трёх тестовых фото, а на реальном альбоме с характерным набором ориентаций.

Кроме общего layout настраивается соотношение сторон обложек альбомов. Среди вариантов предусмотрены 1:1, 2:3, 3:2, 4:5, 5:4 и 16:9. Это отдельный параметр: пропорция карточки альбома в общем списке не обязана совпадать с раскладкой фотографий внутри. Если обложки заранее подобраны под определённый формат, единое соотношение сторон делает главную страницу визуально стабильнее.

Внутри конкретного альбома можно переопределять часть визуальных параметров, в том числе обложку, заголовочное изображение, порядок фотографий, соотношение миниатюр и стиль раскладки. Благодаря этому панорамный проект и портретная серия не обязаны выглядеть одинаково. Индивидуальные настройки следует применять там, где они действительно усиливают материал; слишком большое число исключений усложняет поддержку галереи.

Обложка и заголовочное изображение

Обложка работает в контексте списка альбомов, поэтому должна оставаться узнаваемой в небольшом размере. Слишком детальный кадр с множеством мелких объектов теряет выразительность после уменьшения. Заголовочное изображение, напротив, показывается широким элементом страницы и должно выдерживать иной формат кадрирования. Один и тот же снимок может выполнять обе роли, но это не всегда оптимально.

Если серия содержит людей, при выборе широкой шапки учитывайте положение лиц относительно краёв. Если это архитектура, проверьте, не исчезает ли главный объект при адаптивном кадрировании. В любом случае оценивать результат нужно непосредственно в галерее, потому что исходная фотография в редакторе не показывает, как именно её использует интерфейс.

Сортировка альбомов и фотографий

Порядок альбомов может основываться на времени создания, названии, описании или датах содержащихся фотографий. Для фотографий доступны, среди прочего, время добавления, дата съёмки, название, описание, признак выделения и тип. Направление задаётся отдельно: по возрастанию или убыванию. Это позволяет строить как хронологическую историю, так и алфавитный каталог.

Для названий и описаний есть два подхода к сортировке. Natural-вариант учитывает числа в строках так, как ожидает человек: Photo 2 идёт перед Photo 10. Strict-вариант передаёт сортировку базе данных и работает лексикографически, поэтому порядок чисел в строках может выглядеть иначе. На небольшом альбоме естественный порядок удобнее, но при пагинации у него есть важное ограничение.

Natural-сортировка выполняется после получения записей. Если фотографии разбиты на страницы, сортируется только текущая порция, а не весь альбом. В результате каждая страница может быть внутренне упорядочена правильно, но общий порядок между страницами окажется неожиданным. При активной пагинации и необходимости стабильной сортировки по названию или описанию разумнее использовать strict-вариант либо изменить структуру именования.

Для фотоархива с корректным EXIF обычно самым естественным ориентиром является taken_at. Но в отсканированных семейных фотографиях точной даты может не быть, и тогда названия или вручную заданные даты дают более предсказуемый порядок. Перед выбором сортировки важно понять, какое поле действительно заполнено у большинства материалов.

Пагинация и большие альбомы

Для длинных списков доступны три режима интерфейса пагинации: автоматическая подгрузка при прокрутке, кнопка загрузки следующей порции и навигация по номерам страниц. Отдельно задаётся количество фотографий на страницу; стандартное значение в настройках — 100. Аналогичный выбор предусмотрен для списка альбомов.

Бесконечная прокрутка выглядит непрерывно и удобна для визуального просмотра, но при возвращении к конкретной позиции после долгой прокрутки может быть менее предсказуемой. Кнопка загрузить ещё даёт пользователю контроль над подгрузкой. Номера страниц полезны для каталога, где нужно возвращаться к определённому участку. Один универсально лучший режим отсутствует: выбор определяется длиной коллекции и привычками аудитории.

Количество элементов на странице влияет на баланс между числом запросов, временем первой отрисовки и объёмом данных, который браузер держит одновременно. Не стоит автоматически увеличивать значение до тысяч ради отсутствия переходов: слабый телефон может тяжелее обрабатывать огромное количество миниатюр. Для крупной библиотеки лучше провести тест на реальном альбоме и оценить скорость первого открытия, прокрутку и расход памяти.

Главная страница, язык и визуальные параметры

В базовых настройках задаются название галереи, имя владельца, язык интерфейса и тёмный режим. Можно выбрать стартовый раздел для корневой страницы: галерею, Flow или Timeline. Эти параметры формируют первое впечатление и должны соответствовать назначению сайта. Для семейного архива важнее простая навигация, для портфолио — обложки и визуальная последовательность, для хронологического проекта — время.

Тёмный режим подходит фотографиям с насыщенными цветами и уменьшает количество светлых областей вокруг кадра, но сам по себе не делает галерею лучше. Если большинство изображений очень тёмные, границы миниатюр могут сливаться с фоном; если серия светлая и воздушная, другой режим может выглядеть естественнее. Выбирать тему стоит по материалу и читаемости элементов управления.

Для главной галереи можно включить заголовочное изображение, а также управлять его показом после входа пользователя. Отдельные параметры задают прозрачность верхней панели и градиент под текстом, чтобы улучшить читаемость на фотографии. Эти настройки нужно проверять на конкретной шапке: текст, хорошо видимый на одном кадре, может исчезать на другом из-за локального контраста.

Предусмотрены поля для собственного логотипа галереи и отдельного логотипа приветственной страницы. Если они заданы, изображение может заменить текстовый заголовок в соответствующем месте. При подготовке логотипа важно использовать файл с прозрачностью и достаточным разрешением, а затем проверить его на светлом и тёмном фоне.

Панель сведений и элементы просмотра

Отображение EXIF можно полностью отключить, если технические параметры не нужны аудитории. Для публичного портфолио это иногда делает интерфейс чище; для учебной или технической галереи, наоборот, EXIF представляет ценность. Отдельная настройка позволяет открывать панель деталей автоматически при входе в просмотр фотографии, что удобнее во время каталогизации, но может занимать часть пространства при обычном просмотре.

Размер кнопок перехода к предыдущей и следующей фотографии регулируется. Они могут оставаться скрытыми до приближения указателя к краям. Если пользователь сообщает, что стрелок нет, сначала стоит проверить поведение курсора и размер окна, а уже затем искать неисправность. Такой интерфейс освобождает пространство вокруг снимка, но делает первое знакомство менее очевидным.

В настройках можно включать и отключать сам режим слайд-шоу. Если галерея используется как строгий каталог, автоматический просмотр может быть не нужен. Для семейного экрана или презентации серии, напротив, он полезен. Решение стоит принимать по сценарию, а не включать все функции только потому, что они доступны.

Оригиналы и производные изображения

Сохранение оригинального файла — принципиальное отличие архивного сценария от обычной веб-страницы с заранее уменьшенными JPEG. Lychee использует производные варианты для интерфейса, но способен отдавать исходное разрешение при разрешённом скачивании. Поэтому при переносе библиотеки нельзя считать миниатюры достаточной резервной копией: ценность имеют сами оригиналы и данные приложения, связывающие их с альбомами, пользователями и метаданными.

Производные файлы ускоряют сетку и просмотр, но занимают дополнительное место. Чем больше библиотека, тем заметнее эта надбавка. При расчёте хранилища стоит оставлять запас не только под будущие оригиналы, но и под варианты, временные файлы и операции обновления. Заполнение диска до последних процентов повышает риск ошибок при загрузке и генерации изображений.

Если миниатюра не появилась, а оригинал загрузился, проблема может находиться именно на этапе обработки: недостаток памяти, неподдерживаемая особенность файла, неверные права на каталог или сбой обработчика изображений. Полезно проверить один проблемный файл отдельно и сравнить его с похожим успешным кадром по размеру, формату и метаданным.

Скачивание отдельных кадров, групп и альбомов

Отдельная фотография и выделенная группа могут скачиваться в исходном разрешении, если это разрешено правами. Целый альбом можно получить ZIP-архивом с оригиналами. Эта функция удобна для передачи серии клиенту или родственнику без подготовки отдельного файлового обменника.

При большом альбоме формирование ZIP требует ресурсов сервера и свободного места для временных операций. Если загрузка отдельного кадра работает, а большой архив завершается ошибкой, это не обязательно проблема самих фотографий. Нужно проверить журналы, доступное место, лимиты времени выполнения и настройки окружения. Для диагностики полезно сравнить маленький и большой альбом.

Право скачивания следует тестировать как отдельное разрешение. Пользователь может видеть альбом, но не иметь возможности получить оригиналы. Если кнопка отсутствует для конкретной учётной записи, сначала проверьте её права и параметры альбома, а не состояние файлов. Если кнопка есть, но архив не формируется, тогда уже переходите к серверной диагностике.

Сценарий: перенос большого семейного архива

При переносе многолетней семейной коллекции главная ошибка — пытаться одновременно загрузить всё, перестроить иерархию, исправить даты и сразу открыть доступ родственникам. Надёжнее разделить работу на этапы. Сначала создайте верхние альбомы по крупным периодам или событиям, затем импортируйте один контрольный фрагмент, проверьте даты, ориентацию, миниатюры и EXIF, и только после этого переходите к остальному массиву.

Если исходные папки уже хорошо организованы, командная синхронизация может быть удобнее ручной загрузки. Перед запуском стоит удалить временные файлы, экспортные копии и очевидные дубли, которые не должны попадать в библиотеку. Lychee не следует использовать как оправдание для импорта каждого промежуточного JPEG: чем чище входной набор, тем меньше лишней работы с тегами и альбомами после переноса.

Старые сканы требуют отдельного подхода к датам. Сканер часто записывает дату оцифровки, а не момент съёмки. Если важна хронология семьи, полезнее вручную задать приблизительно известную дату или хотя бы год, чем оставлять время сканирования и затем видеть фотографии 1970-х среди современных кадров. Название и описание могут хранить пометку о том, что дата ориентировочная.

Людей лучше не кодировать чрезмерно глубокой системой альбомов. Альбомы 1978 / Лето / Дача дают основную структуру, а теги с именами или семейными ветвями позволяют находить человека во многих событиях сразу. Так один кадр не приходится копировать в отдельный альбом каждого участника, а поиск по имени остаётся доступным.

До открытия доступа родственникам проверьте закрытые материалы. В семейных архивах рядом с обычными фотографиями могут находиться документы, снимки адресов, фотографии детей и другие материалы, которые не стоит показывать всем по одной общей ссылке. Разделение на публичные и закрытые альбомы должно быть частью структуры с самого начала, а не поздним исправлением.

Сценарий: фотопортфолио

Для портфолио задача противоположна архиву: посетителю не нужен полный объём, ему нужен короткий и ясный отбор. В Lychee удобно держать большой внутренний набор и открывать только отдельные серии. Каждой публичной серии назначают выразительную обложку, подходящее заголовочное изображение и раскладку, которая соответствует пропорциям кадров.

Перед публикацией стоит отредактировать названия и описания только там, где они действительно помогают. Портфолио не обязано превращаться в базу технических подписей. Если EXIF отвлекает от визуального просмотра, его отображение можно отключить. Если аудитории, напротив, важны параметры съёмки, панель деталей можно оставить доступной.

Рейтинг помогает предварительно отбирать сильные кадры внутри рабочей серии, но финальный публичный альбом лучше собирать осознанно. Пять звёзд у двадцати похожих кадров не решают задачу ритма. Следует проверить последовательность: общий план, средние планы, детали, повторяющиеся композиции и финальный кадр. Lychee даёт инструменты организации, но художественный порядок остаётся решением автора.

Публичную страницу следует проверить без входа, на телефоне и на широком экране. Важно оценить не только качество отдельных изображений, но и то, как обложки выглядят вместе, насколько быстро открывается первая сетка и не мешает ли большое заголовочное изображение перейти к самим фотографиям. Если используется встраивание на сайт, добавляется проверка поведения внутри внешнего макета.

Сценарий: архив путешествий с картой

Для поездок удобно строить верхний уровень по годам или регионам, а внутри создавать альбомы конкретных маршрутов. GPS из EXIF даёт карту без ручного создания отдельного списка координат. После загрузки нужно открыть карту и проверить несколько контрольных точек: начало маршрута, наиболее удалённое место и участки, где камера могла потерять геопозицию.

Если в поездке использовались телефон и фотоаппарат, данные могут отличаться. Телефон часто содержит координаты, а камера без GPS — нет. Такие кадры не исчезают из альбома, но карта будет показывать только геотегированную часть. Не следует ожидать, что положение соседней фотографии автоматически распространится на снимок без координат.

Фильтр карты по альбому помогает отделить одну поездку от другой, а диапазон дат — разделить посещения одного и того же города в разные годы. Если несколько фотографий сделаны рядом, маркеры объединяются в кластер, чтобы карта не превращалась в сплошной набор наложенных точек.

Перед открытой публикацией ещё раз оцените приватность. Туристическая достопримечательность обычно не создаёт проблемы, а точка дома, места проживания или регулярно посещаемого адреса может раскрывать лишнюю информацию. В публичной серии можно оставить фотографии, но подготовить их копии без GPS, если точность координат не нужна зрителю.

Сценарий: передача готовой съёмки клиенту

Lychee можно использовать как аккуратную страницу выдачи, если заказчику нужно посмотреть серию и получить разрешённые оригиналы. Создайте отдельный альбом проекта, настройте обложку и порядок кадров, затем определите модель доступа: зарегистрированный пользователь или публичный альбом с паролем. Для материалов, которые не должны индексироваться или случайно появляться в общей витрине, не включайте такой альбом в публичный список.

Разрешение на скачивание должно соответствовать этапу работы. На предварительном отборе можно оставить только просмотр, а после утверждения открыть загрузку. Если заказчик должен получить весь альбом, ZIP удобнее скачивания по одному файлу. Перед отправкой ссылки самостоятельно проверьте архив небольшого тестового набора и затем готовой серии.

Описание альбома и названия кадров могут использоваться для понятной коммуникации, но Lychee не заменяет систему согласования с комментариями по каждому кадру, если именно такая функция требуется рабочему процессу. В этом случае галерея остаётся местом показа и выдачи, а детальное обсуждение ведётся отдельным инструментом.

Сценарий: общая медиатека небольшой команды

В командной медиатеке стоит начинать с ролей, а не с папок. Определите, кто только смотрит материалы, кто загружает, кто меняет структуру, а кто отвечает за администрацию. Затем выдайте пользователям доступ только к нужным альбомам. Это безопаснее, чем предоставлять всем максимальные возможности и надеяться на устную договорённость.

Единый словарь тегов особенно важен при нескольких авторах. Если один человек использует мероприятие, второй ивент, а третий название конкретного проекта, поиск и Tag Albums распадаются на случайные группы. Полезно заранее записать несколько основных тегов и их смысл, а новые вводить только когда существующая схема действительно не подходит.

Cross-user sharing помогает показывать альбомы между участниками без повторной загрузки. При этом стоит назначить владельца структуры каждого проекта: кто отвечает за название, обложку, порядок и финальное открытие доступа. Техническая совместная работа не разрешает автоматически спор о том, какой вариант считать окончательным.

Для команды полезна периодическая проверка пользователей. Ушедшие участники не должны сохранять лишний доступ, а временные приглашения не должны становиться постоянным способом входа. Проверка прав на несколько критичных альбомов после кадровых изменений занимает меньше времени, чем восстановление последствий случайного доступа.

Сценарий: оцифрованные плёнки и сканы

Сканированная коллекция отличается от цифровой съёмки отсутствием надёжного EXIF. Камера сканера может записать собственные данные или вообще не дать информации о времени исходного кадра. Поэтому основными инструментами организации становятся альбомы, ручные даты, названия, описания и теги.

Если известен только год, не стоит придумывать точный день. Можно выбрать последовательную условную дату и прямо указать в описании, что время приблизительное. Главное — использовать одинаковое правило по всей коллекции. Тогда временная шкала хотя бы сохраняет правильный порядок периодов, а будущий редактор архива понимает происхождение даты.

Для серий сканов полезны короткие технические теги, если они решают конкретную задачу: например, нужна пересъёмка или цвет восстановлен. После завершения реставрации временные рабочие метки можно удалить или объединить. Не нужно хранить каждое промежуточное состояние в основной публичной галерее, если оно не имеет архивной ценности.

Сценарий: смешанные фото и видео

В одном альбоме могут находиться фотографии и поддерживаемые видеофайлы. Это удобно для событий, где короткие ролики дополняют фотосерию. Но смешанный альбом нужно тестировать внимательнее: браузерная поддержка видео зависит не только от расширения контейнера, а слайд-шоу меняет поведение на видеокадре.

Если ролик не воспроизводится, сначала проверьте его в самом браузере отдельно. Затем сравните кодек с рабочим файлом того же расширения. Переименование AVI в MP4 не меняет кодек и не делает видео совместимым. Для публичной галереи лучше заранее привести важные ролики к широко поддерживаемому сочетанию контейнера и кодека во внешнем видеоредакторе.

При включённом слайд-шоу видео ожидается до окончания. Запрет автозапуска со стороны браузера может остановить автоматическую последовательность. Это особенно заметно на мобильных устройствах и в режимах энергосбережения. Если серия должна непрерывно воспроизводиться как презентация, смешанный тестовый альбом обязателен.

Сценарий: открытая галерея мероприятия

Для публичного события можно создать альбом, который появляется в общей галерее и допускает просмотр без учётной записи. Перед публикацией решите, разрешены ли скачивания. Если фотографий много, настройте пагинацию так, чтобы посетитель не ждал загрузки огромной сетки. Для быстрого просмотра обычно подходят последовательная подгрузка или кнопка продолжения.

После события полезно пройти по серии как гость и проверить названия, случайные технические кадры, координаты и EXIF. Публичный доступ увеличивает значение любой ошибочной метадаты: внутренняя подпись, которая была понятна владельцу, может выглядеть странно для внешнего человека, а GPS может быть излишним.

Если альбом должен быть доступен только участникам, пароль удобнее полностью открытой ссылки, но пароль следует передавать отдельно и не размещать рядом с самой ссылкой в публичном сообщении. Если нужен более персональный контроль, лучше создать пользователей и назначить права на альбом.

Проверка библиотеки после массового импорта

После большой загрузки не стоит сразу считать работу завершённой. Выберите фотографии из начала, середины и конца диапазона и проверьте пять типов данных: сам оригинал открывается, миниатюра корректна, ориентация верна, дата соответствует ожиданию, EXIF и GPS читаются там, где должны. Такой выборочный контроль быстрее полного просмотра, но обнаруживает систематические ошибки импорта.

Далее проверьте структуру альбомов. Названия должны быть понятными без знания исходного диска, обложки — соответствовать содержимому, а вложенность — не создавать пустых или почти пустых промежуточных уровней. Если импорт привёл к слишком буквальному копированию файловой структуры, лучше исправить дерево до того, как на него начнут ссылаться другие пользователи.

Третий этап — поиск. Возьмите несколько фотографий с заведомо заполненными названиями, описаниями и тегами и попробуйте найти их разными запросами. Это не только тест функции, но и проверка качества введённых данных. Если кадр находится только по одному нестандартному термину, возможно, классификацию нужно привести к более предсказуемому виду.

Последний этап — гостевой просмотр. Откройте публичную часть без авторизации и убедитесь, что закрытые альбомы не видны, парольные подборки действительно требуют пароль, скачивание доступно только там, где разрешено, а sensitive-содержимое ведёт себя согласно настройкам.

Почему загрузка может не проходить

Если файл не загружается, сначала определите масштаб проблемы. Один конкретный снимок указывает на особенности файла, а отказ любых крупных файлов — на лимиты окружения. Ошибка всех файлов независимо от размера чаще связана с правами записи, конфигурацией приложения, свободным местом или общим сбоем серверной части.

Chunk upload помогает передавать крупные файлы частями, но не отменяет серверные ограничения полностью. Прокси и веб-сервер могут иметь собственные лимиты тела запроса, PHP — значения размера загрузки и времени выполнения, а хранилище — недостаток свободного места. Диагностика должна идти от симптома: сравнить маленький рабочий файл и большой проблемный, затем проверить журнал и настройки на том уровне, где появляется ошибка.

Если проблема возникает только с одним изображением, сделайте копию и пересохраните её в обычный JPEG без экзотических профилей или нестандартной структуры метаданных. Если копия проходит, причина, вероятно, связана с исходным файлом. Оригинал при этом лучше сохранить отдельно, чтобы не потерять мастер-версию ради диагностики.

Файл загрузился, но миниатюры нет

Такой симптом отделяет приём файла от его обработки. Проверьте формат, размеры, доступную память, права каталогов и журналы. Большой панорамный JPEG может требовать заметно больше оперативной памяти при декодировании, чем его размер на диске: изображение разворачивается в память в несжатом виде.

Если проблема повторяется на файлах одной камеры или после одного экспортного пресета, сравните их с рабочими снимками. Общий цветовой профиль, нестандартное внедрённое превью или повреждённый EXIF могут подсказать причину. Не удаляйте массово проблемные фотографии до выяснения причины: лучше собрать небольшой набор для воспроизводимого теста.

Что делать при неверной ориентации

Lychee учитывает EXIF Orientation и автоматически поворачивает фотографии. Если отдельный кадр выглядит неверно, проверьте, что записано в его метаданных. Некоторые программы физически поворачивают пиксели, но оставляют старый Orientation; другие удаляют тег после поворота. В результате два визуально одинаковых файла могут обрабатываться по-разному.

Надёжное исправление — привести изображение и Orientation к согласованному состоянию во внешнем редакторе, затем заменить или повторно загрузить исправленный файл. Простое изменение отображения в браузере не исправляет мастер-файл и может дать другой результат при скачивании оригинала.

Почему дата фотографии оказалась неправильной

Сначала определите, какое значение содержит исходник. Возможны дата съёмки из EXIF, время изменения файла или дата, заданная пользователем. Если камера была настроена неправильно, программа не может знать реальное время события. Если EXIF отсутствует и включено использование времени последнего изменения, после копирования архив может получить даты переноса.

Для небольшой ошибки дату можно изменить вручную в карточке. Для массовой систематической ошибки лучше сначала исправить метаданные внешним инструментом или подготовить управляемый импорт, чем редактировать сотни файлов по одному. После исправления проверьте временную шкалу и сортировку, потому что именно там неверные даты заметнее всего.

Почему на карте нет части фотографий

Карта показывает только снимки с доступными GPS-координатами. Отсутствие маркера при наличии альбома не означает, что фотография потеряна. Откройте детали кадра и проверьте геоданные. Если координат нет, нужно восстановить их в метаданных исходника либо принять, что этот снимок останется вне географического представления.

Если координаты есть, но точка находится в неожиданном месте, возможна ошибка метаданных: неверный GPS камеры, некорректная запись после обработки или метаданные другого файла. Сравните соседние кадры по времени. Единичный выброс легче исправить, когда виден контекст всей серии.

Почему поиск не находит ожидаемый кадр

Поиск опирается на название и описание фотографии, имя альбома и теги. Он не следует воспринимать как универсальное распознавание содержимого каждого изображения. Если слово нигде не записано в поддерживаемых полях, обычный поиск не обязан вернуть кадр. Поэтому ожидаемое поведение начинается с проверки метаданных самой фотографии.

Второй фактор — доступ. Пользователь ищет в той части библиотеки, которую ему разрешено видеть. Администратор и гость могут получить разные результаты по одному запросу. Если публичный поиск отключён, посетитель без входа не сможет использовать его как каталог публичных альбомов.

Третий фактор — разрозненные теги. Если часть фотографий помечена street, а часть стрит, один запрос не обязательно охватит обе группы. Объединение и переименование тегов помогает поддерживать единый словарь и делает результаты предсказуемее.

Почему пользователь видит альбом, но не может скачать

Просмотр и скачивание — отдельные права. Сначала проверьте разрешение на скачивание у альбома и полномочия конкретного пользователя. Если альбом публичный, также проверьте параметры публичного доступа. Отсутствие кнопки при корректном просмотре чаще говорит о настройке прав, а не о повреждении исходных файлов.

Если кнопка есть, но загрузка всего альбома завершается ошибкой, проблема уже относится к формированию ZIP или ресурсам сервера. Сравните скачивание одного снимка, небольшой подборки и полного альбома. Такое постепенное увеличение нагрузки помогает отделить ошибку разрешений от ошибки архивирования.

Медленная сетка: что проверять

Производительность галереи зависит от количества элементов на странице, размеров производных изображений, диска, базы данных, сети и возможностей браузера. Если один альбом с тысячами кадров открывается заметно медленнее небольших, начните с пагинации и размера страницы. Нет смысла загружать огромную сетку целиком, если посетитель смотрит только первые десятки кадров.

Затем проверьте, используются ли именно производные варианты, а не оригиналы, и нет ли ошибок их генерации. Если браузер вынужден получать многомегабайтные файлы для миниатюр, сетка закономерно будет тяжёлой. На стороне сервера стоит посмотреть нагрузку и задержки базы данных; на стороне клиента — сетевые запросы и время отрисовки.

Сортировка тоже может влиять на большие библиотеки. Natural-сортировка названий выполняется иначе, чем strict и не дружит с пагинацией так же хорошо. Если важна масштабируемость длинного каталога, используйте поля и режимы сортировки, рассчитанные на работу базы данных, и не увеличивайте количество элементов на странице только ради визуальной непрерывности.

Видео есть в альбоме, но не воспроизводится

Расширение файла не гарантирует браузерную совместимость кодека. Проверьте ролик в том же браузере вне Lychee. Если браузер сам не способен декодировать видео, галерея не исправит это. Для важной публичной серии подготовьте совместимую копию внешним инструментом и загрузите её вместо экзотического исходника.

Если отдельное воспроизведение работает, но проблема появляется только в слайд-шоу, проверьте ограничения автозапуска. Некоторые браузеры блокируют автоматический старт медиаконтента. В таком случае автоматическая последовательность может ждать видео, которое не начало играть, хотя ручной переход к следующему элементу остаётся возможным.

Дубликаты тегов и близкие названия

Когда словарь накопил portrait, Portrait и портрет, сначала выберите основной вариант. Затем используйте переименование или объединение, а не ручное исправление каждого снимка. После объединения проверьте Tag Albums, которые ссылались на исходные метки: механизм управления тегами рассчитан на перенос соответствий, но визуальная проверка ключевых подборок всё равно полезна.

Чтобы проблема не возвращалась, используйте автодополнение. Если существующий тег появляется в подсказке, выбирайте его вместо создания новой почти одинаковой записи. Для команды закрепите простой словарь основных категорий и правило языка.

Слишком глубокое дерево альбомов

Если до фотографии приходится проходить пять-шесть уровней, сама иерархия начинает мешать. Выберите уровень, на котором пользователь действительно принимает решение, и уберите технические промежуточные папки. Например, вместо Архив / Фото / 2025 / Личное / Поездки / Италия публичной навигации достаточно Путешествия / 2025 / Италия.

Признаки, которые пересекают дерево, переносите в теги. Это уменьшает число веток без потери возможностей поиска. Tag Albums могут собрать динамическую тематическую подборку, не заставляя переносить исходную серию из её естественного места.

Публичная галерея показывает лишнее

Проверяйте не только сам альбом, но и связанные механизмы: публичный список, поиск, Tag Albums и sensitive-настройки. Материал может быть невидим в обычном дереве, но появляться через динамическую подборку при неудачном сочетании параметров. Особенно внимательно относитесь к настройке, при которой Tag Album способен перекрывать индивидуальную видимость фотографий.

Исправление начинается с закрытия проблемного альбома или подборки, затем права проверяются в гостевом режиме. После этого можно по одному возвращать нужные элементы публикации. Такой порядок безопаснее, чем пытаться менять несколько флажков, пока нежелательный материал остаётся доступным.

Контекстные действия в альбомах

Часть повседневных операций доступна из контекстных меню и панелей действий. Это ускоряет работу, когда нужно изменить конкретный альбом или выбранную группу, не переходя в отдельный многошаговый мастер. По скриншотам разных поколений интерфейса видно, что меню менялось визуально, поэтому ориентироваться лучше на смысл действия, а не на фиксированное положение пункта.

Перед массовой операцией всегда полезно посмотреть на счётчик выделенных элементов и название целевого альбома. Ошибка контекста опаснее ошибки единичной карточки: одно неверное действие может затронуть десятки фотографий. Если результат выглядит неожиданно, остановите дальнейшие изменения и сначала определите, какие именно элементы уже были обработаны.

Резервное копирование фотобиблиотеки

Резервная копия Lychee должна учитывать не только изображения. В библиотеке есть оригиналы и производные файлы, а структура альбомов, пользователи, права, теги, оценки и другие связи хранятся в данных приложения. Простое копирование каталога с JPEG сохраняет сами фотографии, но не гарантирует восстановление организованной галереи в прежнем виде.

Практическая схема включает резервирование файловой части и базы данных в согласованном состоянии. Частота зависит от активности: если фотографии добавляются раз в месяц, ежедневная копия может быть избыточной; если несколько пользователей работают постоянно, большой интервал создаёт риск потерять множество изменений. Главное — чтобы резервирование происходило регулярно, а не только перед обновлением.

Копия считается полезной только после проверки восстановления. Для теста можно развернуть отдельную временную среду, восстановить данные и убедиться, что открываются альбомы, сохраняются права, видны теги и доступны оригиналы. Такой тест обнаруживает ошибки намного раньше реальной аварии, когда времени на изучение структуры резервов уже нет.

Хранить единственную копию на том же диске, что и рабочая библиотека, недостаточно: отказ носителя затронет оба набора. Отдельный физический носитель или другая система хранения защищает от одной точки отказа. Для особенно ценных семейных и профессиональных архивов полезно придерживаться общего принципа нескольких независимых копий и периодически сверять их читаемость.

Перенос галереи на другой сервер

Миграция начинается с инвентаризации: где находятся оригиналы и производные файлы, какая база данных используется, какие параметры окружения важны для адреса галереи, доступа к базе и фоновых задач. Перед переносом сделайте проверенный резерв и зафиксируйте рабочее состояние, чтобы можно было вернуться к нему при ошибке.

На новом сервере сначала подготавливают совместимое окружение, затем переносят данные и только после этого открывают доступ пользователям. Не стоит одновременно менять структуру каталогов, доменное имя, базу и правила доступа без промежуточных тестов: если что-то не работает, будет трудно понять, какая перемена стала причиной.

После переноса проверьте загрузку новой фотографии, открытие старого оригинала, генерацию миниатюры, поиск, карту, авторизацию и скачивание тестового альбома. Затем сравните публичную часть в гостевом режиме. Если все эти цепочки работают, вероятность незаметного неполного переноса существенно ниже.

Совместимость серверного окружения

Lychee рассчитан на работу на собственном сервере или веб-хостинге. Для сборки из исходного кода требуется PHP 8.4 или новее, Composer и npm; рекомендуемый способ развёртывания использует контейнеры с заранее настроенными зависимостями. Пользователю важен практический вывод: обычного открытия архива на Windows или macOS недостаточно — нужна серверная среда, к которой затем обращается браузер.

В типовой конфигурации используется база данных и постоянные каталоги для фотографий и служебных данных. При контейнерном запуске эти каталоги необходимо хранить вне эфемерного слоя контейнера, иначе пересоздание окружения может привести к потере данных. Конкретные пути и параметры следует брать из документации для выбранной схемы развёртывания.

Архитектура конечного компьютера с браузером не определяет формат фотобиблиотеки: интерфейс открывается как веб-страница. Значение имеет архитектура серверной машины и доступность подходящего окружения. Официальные контейнерные каналы поддерживают распространённые 64-битные архитектуры, но при необычном NAS или старом процессоре совместимость стоит проверить до переноса большой коллекции.

Если используется обратный прокси, особое внимание требуется адресу приложения, HTTPS, размеру запросов и тайм-аутам. Неправильный внешний адрес может проявляться в ссылках и перенаправлениях, а слишком маленький лимит запроса — только на крупных загрузках. Настройку лучше проверять постепенно: вход, просмотр, небольшой файл, большой файл, скачивание и публичная ссылка.

Что Lychee не делает вместо фоторедактора

В программе нет полноценного рабочего процесса проявки RAW, локальных масок, частотного разложения, пластики, сложной ретуши кожи или многослойного монтажа. Если исходный кадр требует экспозиционной коррекции, удаления объектов или цветовой обработки, это делается до помещения финальной версии в библиотеку. Lychee затем отвечает за каталогизацию, показ и доступ.

Такое разделение полезно и организационно. Мастер-файлы редактора, RAW и промежуточные варианты не обязаны попадать в публичный альбом. В галерее можно хранить отобранные экспортные изображения, а исходный рабочий проект — в системе хранения фотографа. Тогда посетитель видит чистую серию, а архив не засоряется техническими версиями.

Встроенной подготовки макета для печати также нет. Альбом можно скачать в оригинальном разрешении, после чего печать выполняется в программе или сервисе, который умеет управлять размером листа, полями, профилями принтера и раскладкой. Не следует путать наличие исходного файла со специализированной печатной функцией.

Когда Lychee подходит лучше всего

• Нужна собственная фотогалерея с альбомами и вложенной структурой.
• Важны теги, поиск, оценки, EXIF и GPS-карта.
• Требуется разделять публичные, парольные и пользовательские альбомы.
• Нужно сохранять оригиналы и при необходимости отдавать их на скачивание.
• Есть сервер, NAS или хостинг, где можно поддерживать галерею.
• Фотографии уже подготовлены и не требуют сложной художественной обработки внутри каталога.

Если основная задача — автоматическая резервная загрузка всей фотоплёнки со смартфона, распознавание людей или интенсивный поиск по содержимому на основе машинного обучения, стоит сравнить Lychee с более тяжёлыми системами личного фотоархива. Если задача — художественная обработка, нужен редактор. Если требуется прежде всего публичная управляемая галерея с понятными альбомами и правами, Lychee попадает в свою сильную область.

Сравнение Lychee с аналогами

Программа	Лучше подходит для	Главное ограничение
Lychee	Аккуратной самоуправляемой галереи, альбомов, тегов, карты и адресного доступа	Нет развитой фоторетуши и мобильного сценария автоматического бэкапа
Immich	Автоматической загрузки фото и видео со смартфонов, семейной временной шкалы и поиска	Более сложная серверная система с дополнительными сервисами
PhotoPrism	Индексирования большой личной медиатеки, фильтрации, RAW и автоматической классификации	Индексирование и настройка требуют больше ресурсов и времени
Piwigo	Расширяемой публичной фотогалереи, организаций с пользователями, темами и плагинами	Часть специализированных возможностей реализуется расширениями
LibrePhotos	Личного архива с распознаванием лиц, объектов и семантическим поиском	Функции машинного обучения повышают требования к развёртыванию

Практический выбор зависит от центра тяжести задачи. Lychee рационален, когда нужны понятные альбомы, аккуратная публикация, метаданные, карта и контролируемый доступ без превращения фотогалереи в сложную систему автоматического анализа. Immich сильнее ориентирован на непрерывный мобильный архив, PhotoPrism — на глубокое индексирование и поиск по большой медиатеке, Piwigo — на расширяемую галерею и организационные сценарии, LibrePhotos — на автоматический анализ содержимого и лиц. Для ретуши ни один из этих вариантов не заменяет полноценный редактор.

Контрольный список перед открытием галереи

1. Откройте несколько фотографий разных форматов и убедитесь, что миниатюры и полноразмерный просмотр корректны.
2. Проверьте альбомы с горизонтальными, вертикальными и панорамными кадрами в выбранной раскладке.
3. Убедитесь, что даты съёмки дают ожидаемую сортировку и временную шкалу.
4. Проверьте EXIF и GPS на нескольких известных снимках.
5. Выполните поиск по названию, описанию альбома и нескольким тегам.
6. Откройте Tag Albums и убедитесь, что AND/OR дают ожидаемый состав.
7. Проверьте пользовательские права на чтение, изменение и скачивание.
8. Откройте публичную часть в приватном окне и повторите тест без административной сессии.
9. Скачайте отдельный оригинал и небольшой ZIP-альбом, если такая возможность должна быть доступна.
10. Проверьте резервную копию и зафиксируйте дату последнего успешного восстановления.

Этот список полезно повторять после крупных изменений конфигурации, массового импорта и переноса на другой сервер. Он покрывает не каждую возможную ошибку, но проходит по основным пользовательским цепочкам от файла до публичного просмотра.

Частые вопросы о Lychee

Можно ли использовать программу только для личного архива?

Да. Публичная публикация не обязательна. Альбомы можно держать закрытыми и открывать их только авторизованным пользователям. Для полностью личного сценария особенно полезны теги, поиск, рейтинги, карта и хронологический просмотр.

Можно ли сделать несколько уровней альбомов?

Да. Альбомы поддерживают вложенность, поэтому можно строить иерархию по годам, событиям, клиентам или другим крупным категориям. Неограниченная техническая вложенность не означает, что стоит создавать максимально глубокое дерево: навигация остаётся удобнее при небольшом числе осмысленных уровней.

Сохраняются ли исходные фотографии?

Оригиналы сохраняются, а для интерфейса создаются оптимизированные варианты. При разрешённом скачивании пользователь может получить исходное разрешение. При резервном копировании нужно учитывать и файлы, и данные приложения, чтобы не потерять структуру библиотеки.

Какие изображения можно загружать?

В документации перечислены JPG, JPEG, PNG, GIF и WebP. Если коллекция содержит другие исходники, их не стоит автоматически считать полноценно обрабатываемыми изображениями. Дополнительные расширения могут быть настроены как passthrough, а готовую версию для просмотра лучше экспортировать в поддерживаемый формат.

Поддерживается ли видео?

Да, перечислены OGV, MP4, MPG, WebM, MOV, M4V, AVI и WMV. Но расширение — это только контейнер, а фактическое воспроизведение в браузере зависит от кодека. Для публичного альбома проверяйте важные ролики на типичных устройствах.

Можно ли искать по содержимому фотографии?

Обычный поиск Lychee работает по названиям и описаниям фотографий, именам альбомов и тегам доступной библиотеки. Поэтому качественная ручная классификация остаётся важной. Для сценария, где главным требованием является семантический поиск по объектам или лицам, стоит сравнить специализированные альтернативы.

Для чего нужны Tag Albums?

Они создают динамические подборки по тегам. Условие OR включает фотографию при наличии любой выбранной метки, а AND требует все выбранные метки одновременно. После изменения разметки состав таких альбомов обновляется автоматически.

Можно ли защитить альбом паролем?

Для публичного альбома можно включить парольную защиту. Также можно работать через зарегистрированных пользователей и выдавать права конкретным людям. Для конфиденциальной коллекции пользовательский доступ обычно даёт более управляемую модель, чем одна общая ссылка.

Можно ли запретить скачивание?

Да, возможность скачивания контролируется настройками доступа. При этом запрет штатной загрузки не следует считать абсолютной защитой изображения, которое уже отображается публично в браузере. Если материал нельзя показывать посторонним, решением остаётся закрытый доступ.

Почему часть снимков отсутствует на карте?

Карта требует GPS-координаты в метаданных. Фотография без геотега останется в альбоме, но не получит маркер. Если география важна, проверяйте сохранение GPS ещё на этапе экспорта из редактора.

Можно ли менять интервал слайд-шоу?

Да. Интервал задаётся параметром в секундах, а также можно управлять циклическим переходом с конца альбома к началу. Смешанные альбомы с видео нужно тестировать отдельно из-за ограничений автозапуска браузеров.

Что лучше использовать для сортировки длинного альбома по названиям?

Если важны числовые названия в человеческом порядке, natural-сортировка удобна, но при пагинации она сортирует порции независимо. Для большого разбитого на страницы каталога strict-вариант даёт более стабильную работу базы данных, хотя порядок строк с числами может отличаться от ожидаемого человеком.

Нужна ли отдельная программа на компьютере посетителя?

Посетитель работает через обычный современный браузер. Администратору при этом всё равно требуется поддерживаемая серверная среда для самой фотогалереи. Поэтому удобство просмотра для гостя и сложность обслуживания владельцем — две разные стороны системы.

Можно ли использовать Lychee как единственное место хранения фотографий?

Технически оригиналы находятся в библиотеке, но единственное рабочее хранилище без независимой резервной копии создаёт неоправданный риск. Ценные фотографии должны иметь дополнительную копию, а восстановление базы и файлов нужно периодически проверять.

Практический итог

Lychee наиболее убедителен как управляемая фотобиблиотека и галерея: альбомы дают основную иерархию, вложенность помогает разнести крупные темы, теги и Tag Albums создают поперечные подборки, поиск обращается к названиям, описаниям и меткам, оценки помогают отбору, EXIF сохраняет технический контекст, а GPS превращает подходящие серии в карту. При этом оригиналы остаются доступными для разрешённого скачивания, а оформление альбомов позволяет использовать один архив и как личную медиатеку, и как публичную витрину.

Сильнее всего результат зависит не от количества функций, а от качества исходной организации. Понятные названия альбомов, стабильный словарь тегов, корректные даты и аккуратно настроенные права превращают большую коллекцию в предсказуемую систему. Ошибки в этих данных Lychee не скрывает: неверная дата ломает хронологию, отсутствующий GPS убирает маркер с карты, лишняя публичность открывает неподходящий альбом, а хаотичные теги ухудшают поиск.

Перед массовым переносом разумно проверить небольшой фрагмент архива, затем импортировать остальные материалы, выполнить выборочный контроль метаданных и только после этого настраивать публичный показ. Для больших библиотек стоит отдельно продумать пагинацию, сортировку и резервирование. Такой порядок позволяет использовать Lychee по назначению — как систематизированное хранилище готовых фотографий с удобным просмотром и точным управлением доступом, не ожидая от него функций RAW-конвертера, ретушёра или печатного редактора.

Регулярное обслуживание библиотеки

После первоначальной настройки полезно ввести короткий повторяемый цикл обслуживания. Раз в несколько недель или после крупной съёмки проверьте новые альбомы, приведите названия к единому правилу, назначьте обложки, объедините случайно созданные синонимы тегов и убедитесь, что временные рабочие подборки не оказались публичными. Такая профилактика занимает меньше времени, чем разбор накопившегося беспорядка через год.

Отдельно просматривайте фотографии с необычными датами и координатами. Один ошибочный год заметно искажает временную шкалу, а случайный GPS-выброс портит карту поездки. На большой коллекции невозможно вручную проверять каждый кадр после каждой загрузки, поэтому полезен выборочный контроль крайних значений: самых ранних и поздних дат, удалённых точек карты и альбомов с неожиданно малым или большим количеством фотографий.

Словарь тегов стоит обслуживать как справочник, а не как бесконечный список свободных заметок. Если новая метка используется только один раз и фактически повторяет описание кадра, возможно, она не нужна. Если два тега регулярно применяются к одному и тому же понятию, их лучше объединить. Чем стабильнее словарь, тем точнее поиск и тем предсказуемее работают динамические подборки.

Права доступа проверяйте после любых изменений состава пользователей и перед публикацией новых серий. Важный тест — открыть галерею без авторизации и пройти тот же путь, который получит внешний посетитель. Администратор видит более широкий набор материалов и поэтому легко пропускает ошибку, заметную только гостю. Для парольного альбома дополнительно проверьте вход с неверным и правильным паролем, а для пользовательского — аккаунт с минимальными правами.

Наконец, не откладывайте проверку резервов до сбоя. После заметных изменений структуры убедитесь, что в копию попадают новые оригиналы и актуальная база данных, а периодически выполняйте тестовое восстановление. Для фотобиблиотеки ценность состоит сразу в двух слоях: в самих изображениях и в многолетней организации вокруг них. Сохранение обоих слоёв делает Lychee действительно пригодным для долгого архива.

Для контрольной проверки полезно заранее держать небольшой набор эталонных файлов: обычный JPEG с EXIF и GPS, PNG-файл с прозрачностью, GIF, WebP, короткое поддерживаемое видео и снимок с XMP sidecar, если такие метаданные используются в архиве. После изменения параметров обработки или переноса библиотеки откройте этот набор и сравните ориентацию, дату, координаты, миниатюры, полноэкранный просмотр и возможность разрешённого скачивания. Такой тест не заменяет резервную копию, но быстро показывает, не изменилось ли поведение ключевых типов материалов. Если эталон проходит проверку, переходите к нескольким реальным альбомам разного размера и только затем завершайте обслуживание, зафиксировав ясный итог проверки.