ImageMagick
ImageMagick Studio LLC · лицензия ImageMagick License
Сжимает картинки и переводит их в WebP, меняет размер, делает обложки с надписью и водяные знаки. Агенту нужна, чтобы обработать всю папку картинок сайта за один раз.
✓ Проверено 28.09.2026: Docker Desktop 29.2.1 на Mac с Apple Silicon: одноразовый контейнер ubuntu:24.04 для amd64 в эмуляции x86_64, ImageMagick 7.1.2-32 - официальный AppImage с GitHub, распакованный через --appimage-extract. Что именно проверяли
Какую задачу решает
Обрабатывает картинки командами: сжимает и переводит в WebP, меняет размер, обрезает, делает обложки с надписью, ставит водяной знак, склеивает превью. Окон у программы нет, агент запускает её сам и обрабатывает целую папку за один раз. Понимает больше 200 форматов.
- Уменьшает картинки сайта до нужной ширины и переводит в WebP, целой папкой за раз.
- Делает обложку для поста или ролика: фон, надпись по-русски, нужный размер, например 1280x720.
- Ставит водяной знак или логотип в угол каждой картинки.
- Склеивает превью в одну картинку-таблицу, обрезает, поворачивает, показывает размер и вес файлов.
- Переводит страницы PDF в картинки, если стоит Ghostscript.
Пример результата
Говоришь агенту
Сожми все картинки из папки images: ширина не больше 1200, формат WebP, качество 80. Результат положи в папку images-web, исходники не трогай. Скажи, сколько весили файлы до и после.
Что получится
В папке images-web появляются файлы WebP с теми же именами: широкие уменьшены до 1200 пикселей, узкие остались своего размера. Агент называет общий вес до и после, папка images не меняется.
Паспорт
- Кто делает
- ImageMagick Studio LLC
- Сайт
- imagemagick.org
- Исходный код
- github.com/ImageMagick/ImageMagick
- Инструкция
- imagemagick.org/download
- Лицензия
- ImageMagick License
- Версия
- 7.1.2-32 на 28.09.2026
- Системы
- macOS · Windows · Linux
- Где работает
- На компьютере, на сервере и в контейнере
- Цена
- Бесплатно
- Проверка
- Проверено 28.09
Установить агентом
Установи программу «ImageMagick». Работай по шагам и после каждого коротко говори, что сделал.
Что это за программа (каталог smyslokod.ru, официальные источники сверены 28.09.2026):
- официальный сайт: https://imagemagick.org/
- исходный код: https://github.com/ImageMagick/ImageMagick
- инструкция по установке: https://imagemagick.org/download/
- актуальная версия на 28.09.2026: 7.1.2-32
- лицензия: ImageMagick License
- для работы нужно (очень желательно): Шрифт с русскими буквами - для надписей на обложках и водяных знаках; какие шрифты видит программа, покажет magick -list font, на Linux подойдёт DejaVu
- для работы нужно (в отдельных случаях): Ghostscript - нужен, чтобы читать PDF, PS и EPS; по документации ImageMagick использует и его шрифты
- для работы нужно (в отдельных случаях): FUSE - только для AppImage на Linux: без FUSE файл не запустится как есть, его распаковывают флагом --appimage-extract
- для работы нужно (в отдельных случаях): Библиотеки libfontconfig, libfreetype, libX11, libharfbuzz, libfribidi - только для AppImage в минимальном Linux (контейнер, голый сервер): программа берёт их из системы, в Ubuntu и Debian их ставит apt
Правила:
1. Ничего не устанавливай и не меняй, пока я не скажу «да» на твой план.
2. Ставь только способами из этого промпта. Сторонние сборки, скрипты с форумов и из чужих репозиториев не бери.
3. Мои проекты не трогай: не меняй их файлы, виртуальные окружения и списки зависимостей (package.json, requirements.txt, pyproject.toml).
4. Команды с sudo, правку профиля оболочки (~/.zshrc, ~/.bashrc) и переменной PATH делай только после моего отдельного «да» на каждую.
5. Не проси у меня пароли и ключи и не выводи их. Если нужен пароль администратора, дай команду, я выполню её сам.
6. Исходные картинки не перезаписывай: результат клади в отдельную папку, у magick mogrify всегда указывай -path.
7. Перед пакетной обработкой покажи план: какая папка, сколько в ней файлов, что с ними сделаешь и куда положишь результат. Жди моего «да».
8. Если magick нет, а convert есть на macOS или Linux, это старая версия 6: скажи мне и предложи поставить 7 способом из этого промпта. На Windows convert - системная команда для дисков, её не запускай.
9. В Ubuntu 24.04 и Debian 12 не ставь через apt: там версия 6.
10. Если ставишь на сервер, где будут обрабатываться картинки от посторонних людей, до первой обработки предложи строгую политику безопасности в policy.xml (готовые варианты - на imagemagick.org/security-policy).
Шаги:
0. Определи, где ты работаешь: мой компьютер, сервер или контейнер. Какая система и процессор, какие менеджеры пакетов есть (Homebrew, apt, winget, uv, pipx). Ставить нужно туда, где ты сам запускаешь команды.
- на компьютере: на Mac - Homebrew, на Windows - winget или установщик, на Linux - AppImage.
- на сервере: файл AppImage работает без установки. Если на сервере нет FUSE, его распаковывают командой --appimage-extract. Для картинок от посторонних людей сначала включи строгую политику безопасности в policy.xml.
- в контейнере: в чистом образе Ubuntu 24.04 AppImage заработал после распаковки и установки пяти библиотек: libfontconfig1, libfreetype6, libx11-6, libharfbuzz0b, libfribidi0. Для надписей по-русски нужен шрифт с кириллицей, например из пакета fonts-dejavu-core.
1. Проверь, не стоит ли программа уже: magick -version. Если стоит и запускается, ничего не ставь и переходи к шагу 5.
2. Проверь, что есть всё нужное для работы: Шрифт с русскими буквами. Чего нет, внеси в план отдельным пунктом. Проверь свободное место на диске: нужно около 33 МБ на файл AppImage для Linux (после распаковки 102 МБ), около 25 МБ весит установщик для Windows; Homebrew добавляет библиотеки, итог он покажет до установки. Плюс место под обработанные картинки.
3. Составь план: каким одним способом из списка ниже будешь ставить, что появится на диске и сколько места займёт, что поменяется в системе и как потом удалить. Покажи план и жди моего «да».
Способы из официальных источников:
- macOS, Homebrew: brew install imagemagick
- macOS, MacPorts: sudo port install ImageMagick7 (порт ImageMagick без семёрки в названии ставит старую версию 6)
- Windows, winget: winget install --id ImageMagick.Q16-HDRI -e (официальный пакет, его выкладывает сам проект; версия в winget может отставать от сайта на выпуск-два)
- Windows, установщик с сайта: .\ImageMagick-7.1.2-32-Q16-HDRI-x64-dll.exe (файл скачать со страницы загрузки, для Windows на ARM - ImageMagick-7.1.2-32-Q16-HDRI-arm64-dll.exe; галочка добавления в PATH включена по умолчанию)
- Linux, AppImage: mkdir -p ~/.local/bin && curl -fL -o ~/.local/bin/magick https://github.com/ImageMagick/ImageMagick/releases/download/7.1.2-32/ImageMagick-7.1.2-32-gcc-x86_64.AppImage && chmod +x ~/.local/bin/magick (только x86_64; без FUSE файл распаковывают и ставят вместо него ссылку: mkdir -p ~/.local/opt/imagemagick && cd ~/.local/opt/imagemagick && ~/.local/bin/magick --appimage-extract && ln -sf ~/.local/opt/imagemagick/squashfs-root/AppRun ~/.local/bin/magick)
- Linux, apt: sudo apt install imagemagick (только Debian 13, Ubuntu 26.04 и новее: там версия 7. В Ubuntu 24.04 и Debian 12 этот способ не бери: apt поставит версию 6 без команды magick)
4. Установи по согласованному плану. Если что-то идёт не так, как в плане, остановись и спроси.
5. Проверь результат:
- magick -version: программа запускается без ошибки;
- Сделай две тестовые картинки, переведи их в WebP шириной не больше 1200 в отдельную папку и покажи размеры и вес до и после. Потом сделай обложку 1280x720 с надписью по-русски: шрифт с кириллицей возьми из списка magick -list font (на Linux обычно DejaVu-Sans-Bold, на Mac подойдёт -font "/System/Library/Fonts/Supplemental/Arial Bold.ttf") и посмотри на результат. Делай это во временной папке и не трогай мои файлы.
magick -size 3000x2000 plasma:fractal -quality 92 photo.jpg
magick -size 2000x1500 plasma:fractal -depth 8 banner.png
mkdir web && magick mogrify -path web -resize '1200x>' -quality 80 -format webp photo.jpg banner.png
magick identify -format '%f %wx%h %B\n' photo.jpg banner.png web/*.webp
magick -list font | grep Font:
magick -size 1280x720 'gradient:#1f2937-#d97757' -font DejaVu-Sans-Bold -pointsize 64 -fill white -gravity center -annotate +0+0 'Проверка' cover.png
- если ты работаешь в папке моего проекта, покажи git status: от установки в проекте не должно появиться изменений.
6. Итог одним сообщением: что установлено, какой версии и куда, сколько места заняло, что поменялось в системе и как всё удалить (macOS, Homebrew: brew uninstall imagemagick; macOS, MacPorts: sudo port uninstall ImageMagick7; Windows, winget: winget uninstall --id ImageMagick.Q16-HDRI -e; Windows, установщик с сайта: & "$env:ProgramFiles\ImageMagick-7.1.2-Q16-HDRI\unins000.exe"; Linux, AppImage: rm -rf ~/.local/opt/imagemagick && rm -f ~/.local/bin/magick; Linux, apt: sudo apt remove imagemagick).
Если на любом шаге ошибка, не чини наугад: покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/cli/imagemagick#problemyПромпт собран из официальных инструкций, сверенных 28.09.2026. Агент сначала проверит, что уже стоит, покажет план с местом на диске и способом удаления и без твоего «да» ничего не поставит.
Как ставят вручную
Способы из официальных источников, у каждого ссылка на первоисточник.
macOS · Homebrew · источник
brew install imagemagick
macOS · MacPorts · источник
sudo port install ImageMagick7
порт ImageMagick без семёрки в названии ставит старую версию 6
Windows · winget · источник
winget install --id ImageMagick.Q16-HDRI -e
официальный пакет, его выкладывает сам проект; версия в winget может отставать от сайта на выпуск-два
Windows · установщик с сайта · источник
.\ImageMagick-7.1.2-32-Q16-HDRI-x64-dll.exe
файл скачать со страницы загрузки, для Windows на ARM - ImageMagick-7.1.2-32-Q16-HDRI-arm64-dll.exe; галочка добавления в PATH включена по умолчанию
Linux · AppImage · источник
mkdir -p ~/.local/bin && curl -fL -o ~/.local/bin/magick https://github.com/ImageMagick/ImageMagick/releases/download/7.1.2-32/ImageMagick-7.1.2-32-gcc-x86_64.AppImage && chmod +x ~/.local/bin/magick
только x86_64; без FUSE файл распаковывают и ставят вместо него ссылку: mkdir -p ~/.local/opt/imagemagick && cd ~/.local/opt/imagemagick && ~/.local/bin/magick --appimage-extract && ln -sf ~/.local/opt/imagemagick/squashfs-root/AppRun ~/.local/bin/magick
Linux · apt · источник
sudo apt install imagemagick
только Debian 13, Ubuntu 26.04 и новее: там версия 7. В Ubuntu 24.04 и Debian 12 этот способ не бери: apt поставит версию 6 без команды magick
Как удалить
- macOS, Homebrew:
brew uninstall imagemagick - macOS, MacPorts:
sudo port uninstall ImageMagick7 - Windows, winget:
winget uninstall --id ImageMagick.Q16-HDRI -e - Windows, установщик с сайта:
& "$env:ProgramFiles\ImageMagick-7.1.2-Q16-HDRI\unins000.exe" - Linux, AppImage:
rm -rf ~/.local/opt/imagemagick && rm -f ~/.local/bin/magick - Linux, apt:
sudo apt remove imagemagick
Что нужно для работы
- Шрифт с русскими буквами (очень желательно) - для надписей на обложках и водяных знаках; какие шрифты видит программа, покажет magick -list font, на Linux подойдёт DejaVu
- Ghostscript (в отдельных случаях) - нужен, чтобы читать PDF, PS и EPS; по документации ImageMagick использует и его шрифты
- FUSE (в отдельных случаях) - только для AppImage на Linux: без FUSE файл не запустится как есть, его распаковывают флагом --appimage-extract
- Библиотеки libfontconfig, libfreetype, libX11, libharfbuzz, libfribidi (в отдельных случаях) - только для AppImage в минимальном Linux (контейнер, голый сервер): программа берёт их из системы, в Ubuntu и Debian их ставит apt
Системы
- macOS - Homebrew (готовые сборки для Apple Silicon, macOS 15 и новее) или MacPorts.
- Windows - Windows 10 и новее, процессоры x64, arm64 и x86: установщик exe с сайта, переносной архив 7z или winget.
- Linux - официальная готовая сборка одна: файл AppImage для x86_64. Есть и пакеты дистрибутивов, но в Ubuntu 24.04 и Debian 12 это старая версия 6.
Где запускать
Ставить нужно туда, где работает агент: на твой компьютер, сервер или в контейнер.
- На компьютере - на Mac - Homebrew, на Windows - winget или установщик, на Linux - AppImage.
- На сервере - файл AppImage работает без установки. Если на сервере нет FUSE, его распаковывают командой --appimage-extract. Для картинок от посторонних людей сначала включи строгую политику безопасности в policy.xml.
- В контейнере - в чистом образе Ubuntu 24.04 AppImage заработал после распаковки и установки пяти библиотек: libfontconfig1, libfreetype6, libx11-6, libharfbuzz0b, libfribidi0. Для надписей по-русски нужен шрифт с кириллицей, например из пакета fonts-dejavu-core.
Сколько ресурсов нужно
- Место на диске
- Около 33 МБ на файл AppImage для Linux (после распаковки 102 МБ), около 25 МБ весит установщик для Windows; Homebrew добавляет библиотеки, итог он покажет до установки. Плюс место под обработанные картинки
- Память
- Разработчики советуют от 512 МБ оперативной памяти, для больших картинок больше.
- Видеокарта
- Не нужна. На нескольких ядрах процессора программа сама работает параллельно.
- Сеть
- Только чтобы скачать программу.
Лимиты памяти, диска и времени задаются в policy.xml: так одна огромная картинка не отнимет все ресурсы сервера.
Лицензия и платные замены
Лицензия ImageMagick License. Своя лицензия проекта: бесплатно можно пользоваться и лично, и в работе компании. Условия важны тем, кто распространяет ImageMagick вместе со своим продуктом: приложить копию лицензии и указать авторство ImageMagick Studio LLC. Текст лицензии
Цена: Бесплатно
Платные замены
Платной замены, которую стоит брать для работы агента, нет: ImageMagick и libvips бесплатные. Графические редакторы по подписке делают то же руками, а облачные службы сжимают картинки сайта на лету, но для этого раздачу картинок переносят к ним.
Бесплатные замены
О чём помнить
- Обновляй программу. В 2026 году до 27 сентября разработчики опубликовали 212 предупреждений об уязвимостях, 20 из них высокой важности, больше половины - в разборе и записи отдельных форматов. Из 17 выпусков с марта по сентябрь 14 закрывали уязвимости.
- На сервере не обрабатывай картинки от посторонних людей (загрузки на сайт, вложения из почты) с политикой по умолчанию: она открытая. Разработчики советуют ограничить её в policy.xml. Готовая политика websafe из комплекта оставляет обычные форматы (BMP, GIF, JPEG, PNG, TIFF, WebP), запрещает внешние программы и ставит лимиты памяти и времени. Свою политику кладут в ~/.config/ImageMagick/policy.xml и смотрят командой magick -list policy.
- magick mogrify меняет файлы на месте: по документации исходный файл перезаписывается, если не сменить расширение параметром -format. Проси агента класть результат в отдельную папку параметром -path.
- Ставь ImageMagick туда, где работает агент. Если агент на сервере, программа на твоём компьютере ему не поможет.
Частые проблемы
magick: command not found, а convert работает
Стоит старая версия 6: её ставит apt install imagemagick в Ubuntu 24.04 и Debian 12. Команды magick в версии 6 нет. Поставь версию 7: на Linux официальный AppImage, в Debian 13 и Ubuntu 26.04 подойдёт пакет дистрибутива. Homebrew на Mac и установщик на Windows ставят 7.
WARNING: The convert command is deprecated in IMv7, use "magick" instead of "convert"
В версии 7 старую команду convert оставили для совместимости, и она предупреждает об этом. Пиши magick вместо convert, остальные команды тоже через magick: magick mogrify, magick montage, magick identify. Разработчики просят не писать magick convert.
Cannot mount AppImage, please check your FUSE setup
AppImage запускается через FUSE, а его нет: так бывает в контейнерах и на части серверов. Распакуй файл в отдельную папку и поставь вместо него ссылку: mkdir -p ~/.local/opt/imagemagick && cd ~/.local/opt/imagemagick && ~/.local/bin/magick --appimage-extract && ln -sf ~/.local/opt/imagemagick/squashfs-root/AppRun ~/.local/bin/magick. Или запускай с переменной APPIMAGE_EXTRACT_AND_RUN=1. Распакованная папка весит около 100 МБ, удаление: rm -rf ~/.local/opt/imagemagick && rm -f ~/.local/bin/magick.
error while loading shared libraries: libfontconfig.so.1: cannot open shared object file
AppImage берёт часть библиотек из системы, а в минимальной системе (контейнер, голый сервер) их нет. В Ubuntu и Debian: sudo apt install libfontconfig1 libfreetype6 libx11-6 libharfbuzz0b libfribidi0. В Ubuntu 24.04 этого хватило.
unable to read font
Не нашёлся шрифт по умолчанию: по документации ImageMagick использует шрифты Ghostscript, а он не стоит. Укажи шрифт явно: -font и имя из списка magick -list font. Для надписей по-русски нужен шрифт с кириллицей, на Linux подойдёт DejaVu-Sans из пакета fonts-dejavu-core. Ещё варианты: поставить Ghostscript или прописать шрифт по умолчанию в policy.xml (строка policy с domain="system" name="font" и путём к файлу шрифта).
gs: not found или FailedToExecuteCommand 'gs' при чтении PDF
PDF, PS и EPS программа читает через Ghostscript, а он не стоит. Поставь Ghostscript: brew install ghostscript на Mac, sudo apt install ghostscript в Ubuntu и Debian, на Windows - установщик с ghostscript.com.
На Windows команда с одинарными кавычками не срабатывает
В командной строке Windows разработчики ImageMagick просят брать двойные кавычки. Бери пути и параметры в двойные кавычки: magick "e:/myimages/image.png" "e:/myimages/image.jpg".
attempt to perform an operation not allowed by the security policy
Действует политика policy.xml, которая запрещает этот формат или действие. Посмотри, какая политика действует: magick -list policy. Если запрет стоит на сервере для чужих картинок, оставь его: он защищает сервер. Для своих файлов разрешение добавляют в policy.xml.
Проверка
✓ Проверено 28.09.2026: Docker Desktop 29.2.1 на Mac с Apple Silicon: одноразовый контейнер ubuntu:24.04 для amd64 в эмуляции x86_64, ImageMagick 7.1.2-32 - официальный AppImage с GitHub, распакованный через --appimage-extract.
- Когда
- 28.09.2026
- Среда
- Docker Desktop 29.2.1 на Mac с Apple Silicon: одноразовый контейнер ubuntu:24.04 для amd64 в эмуляции x86_64, ImageMagick 7.1.2-32 - официальный AppImage с GitHub, распакованный через --appimage-extract
- Объём
- Установили и прогнали задачу на тестовых данных
- Что именно сделали
- Скачали ImageMagick-7.1.2-32-gcc-x86_64.AppImage (33 311 224 байт) в ~/.local/bin/magick, sha256 совпал со сводкой выпуска на GitHub.
- В эмуляции x86_64 на Apple Silicon файл как есть не запустился (Exec format error). Чтобы обойти эмуляцию, после сверки sha256 обнулили 3 байта подписи AppImage в заголовке (смещение 8) в копии файла внутри контейнера, после этого он запустился. На обычном x86_64 это не нужно.
- Без FUSE: Cannot mount AppImage, please check your FUSE setup. magick --appimage-extract распаковал 102 МБ в squashfs-root, ссылка ~/.local/bin/magick указывает на squashfs-root/AppRun.
- В чистом Ubuntu 24.04 не хватило libfontconfig.so.1, libfreetype.so.6, libX11.so.6, libharfbuzz.so.0, libfribidi.so.0. После apt install libfontconfig1 libfreetype6 libx11-6 libharfbuzz0b libfribidi0: magick -version - ImageMagick 7.1.2-32 Q16-HDRI x86_64, форматы WebP, AVIF, HEIC, JPEG, PNG, PDF, SVG.
- magick -list policy: политика по умолчанию открытая, ограничений нет.
- Сделали 6 тестовых картинок: JPEG 4000x3000, 3000x2000 и 1600x1200 с качеством 92, 8-битные PNG 2560x1920, 1920x1080 и 800x600; всего 6 558 310 байт.
- magick mogrify -path web -resize '1200x>' -quality 80 -format webp: за 1,7 с получили 6 файлов WebP на 249 498 байт, в 26,3 раза меньше, по файлам - от 8,5 до 46,7 раза. Широкие стали 1200 по ширине, 800x600 не растянулась, исходники не изменились.
- Только смена формата без уменьшения: JPEG 1600x1200 в WebP с качеством 80 - в 5,8 раза меньше, PNG 2560x1920 - в 11,4 раза. Картинки сгенерированные, на фотографиях числа будут другими.
- Обложка 1280x720 без -font: unable to read font. Со шрифтом DejaVu-Sans-Bold (пакет fonts-dejavu-core пришёл вместе с libfontconfig1) надпись «Как сжать картинки сайта» отрисовалась по-русски, картинку смотрели. Шрифт по умолчанию в policy.xml (system font) тоже убрал ошибку.
- PDF без Ghostscript: gs: not found и FailedToExecuteCommand. После apt install ghostscript (10.02.1) страница PDF прочиталась в PNG.
- Водяной знак: PNG с надписью «© Мой сайт» наложили в правый нижний угол всех 6 WebP, результат в отдельной папке marked, картинку смотрели.
- magick montage с -font DejaVu-Sans и подписями %f склеил 6 превью в contact.jpg 1128x550.
- Старая команда convert из комплекта работает и пишет WARNING: The convert command is deprecated in IMv7.
- Политика websafe из комплекта в ~/.config/ImageMagick/policy.xml: PNG в WebP переводится, генератор gradient: запрещён.
- Отдельно, в родном arm64-контейнере ubuntu:24.04: apt install imagemagick ставит 6.9.12-98, команды magick нет, есть convert.
| Дата | Версия | Объём | Где | Итог |
|---|---|---|---|---|
| 28.09.2026 | 7.1.2-32 | задача | контейнер, Linux | получилось |
| 28.09.2026 | 7.1.2-32 | источники | без установки | получилось |
«Проверено» ставим, только когда сами поставили программу и прогнали её на задаче. Сверка ссылок и вывод версии так не называются.
Похожие программы
Программу делают её авторы. Мы сверяем официальные источники и описываем, что ей нужно, но код остаётся чужим. Перед установкой посмотри план агента: что он поставит и что поменяет в системе.