Веб-интерфейс

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

mediatoolz ui

mediatoolz ui is running at http://127.0.0.1:52144/?token=5f3c…
Press Ctrl+C to stop.

Браузер открывается по этому адресу сам. В меню слева перечислены модули: Image Hash и Image Batch.

Запуск

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

По умолчанию сервер выбирает свободный порт (--port <n> задаёт свой) и слушает 127.0.0.1, так что достучаться до него может только этот компьютер. --no-open только печатает адрес. Ctrl+C останавливает сервер.

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

Безопасность

• Только этот компьютер. Сервер слушает 127.0.0.1. В адрес, который печатается при запуске, вшит одноразовый токен: открытие адреса ставит cookie, и каждый следующий запрос обязан её нести. Запрос с чужим заголовком Host или Origin отклоняется.
• Запись всегда явная. Image Hash пишет файл только по вашей просьбе и спрашивает, прежде чем заменить существующий. Image Batch пишет только в выбранную вами папку, рядом с оригиналами, если вы выбрали это, или поверх них — с бэкапом и подтверждением.
• Секреты не нужны. Интерфейс не просит ни аккаунт, ни ключ и не обращается к сети, кроме адресов изображений, которые вы укажете сами.

Хеши изображений

Команда image-hash с наглядным результатом. Добавьте папки и изображения через файловый браузер (он показывает миниатюры) и сразу увидите, сколько найдено изображений, в скольких папках и сколько они весят. Отметьте плейсхолдеры (сразу отмечены hazehash и доминирующий цвет; blurhash, thumbhash и крошечное превью выключены), задайте размер hazehash и компоненты blurhash и выберите формат вывода.

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

Пакетная обработка изображений

Команда image-batch в четырёх разделах. В шапке указана папка проекта: именно её означает «This project» везде, где можно сохранить конфигурацию или пресет, а «All projects» — это ваша домашняя папка.

• Convert — выберите изображения, затем куда класть результат: в отдельную папку, рядом с каждым оригиналом или поверх оригиналов. Потом скажите, что делать: быстрыми настройками (необязательный переключатель Resize the images с методом размера — по умолчанию выключен, и тогда изображения только конвертируются в выбранный формат, — затем форматы, качество, предел размера файла, шаблон имён с переменными и живым примером, резкость) или выбором сохранённой конфигурации. Preview показывает план без записи, Convert выполняет его с индикатором прогресса и списком миниатюр «было → стало», размеров и экономии. Замена оригиналов просит подтверждение, оставляет каждый файл в его формате и делает бэкап.
• Configs — сохранённые конфигурации проекта и домашней папки. Создайте новую, правьте формой (размеры, форматы, качество, имена, резкость для каждого рецепта и общие значения для всех) или как JSON и сразу видьте, корректна ли конфигурация и что она создаст. Конфигурацию можно дублировать и удалять; удалённая оставляет копию .bak.
• Sharpening — сохранённые пресеты резкости и шесть встроенных. Редактор принимает назначение, степень и тонкие настройки, показывает, что получит sharp, и предпросматривает результат на любой выбранной фотографии с ползунком для сравнения до и после.
• Backups — бэкапы, которые сделала замена оригиналов, новые сверху. Откройте бэкап, чтобы увидеть каждый файл таким, каким он был и каким стал, что можно восстановить и что изменилось позже. Restore возвращает оригиналы; файлы, правленные после замены, не трогаются, пока вы не отметите флажок. Бэкап из другой папки можно открыть по пути.

Параметры

--port <n>

Порт, на котором слушать. По умолчанию 0 — выбрать свободный.

--host <address>

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

--no-open

Напечатать адрес и не открывать браузер.

--token <value>

Использовать этот токен доступа вместо случайного. Для разработки.

--cwd <path>

Папка, из которой стартует интерфейс. По умолчанию — текущая.

--plain

Отключить цвет и баннер, даже в настоящем терминале.

--color

Принудительно включить цветной вывод, даже если он перенаправлен.

Проблемы и коды выхода

• Порт занят: error: port 4000 is already in use — pick another with --port, or leave it out, код выхода 1.
• Порт не целое число от 0 до 65535: код выхода 2.
• Остановка по Ctrl+C — нормальный выход, код 0.
• Если страница больше не достаёт до сервера (его остановили), перезагрузите страницу по адресу, который напечатала команда.