Windows 10/11Ваши пресетыВывод в JSON

Командная строка filee

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

D:\Photos> filee convert *.heic --to jpg
ok    IMG_0412.heic -> IMG_0412.jpg
ok    IMG_0413.heic -> IMG_0413.jpg
ok    IMG_0414.heic -> IMG_0414.jpg
Converted 3 of 3 file(s).

Как подключить команду filee

  1. 1

    Оставьте галочку в установщике

    На странице параметров установщика Filee оставьте отмеченным пункт Add the "filee" command to PATH (он включён по умолчанию). Filee уже установлен? Запустите последнюю версию установщика ещё раз.

  2. 2

    Откройте новый терминал

    Откройте новое окно командной строки, PowerShell или Windows Terminal (уже открытое окно не видит новый PATH) и выполните filee version.

  3. 3

    Портативная версия или без PATH

    Всё лежит в папке Filee: запускайте там filee-cli.exe или сами добавьте её папку cli в PATH. Программа при этом может быть не запущена.

Быстрый старт

Передавайте имена файлов, маски вроде *.heic или целые папки. Результаты сохраняются рядом с оригиналами, если не указать -o.

Команды

filee convert

filee convert <files or folders...> (--to <format> | --preset <preset>) [options]

Конвертирует файлы, маски (*.heic) и папки. Из папки берутся файлы, которые знает Filee; добавьте -r, чтобы захватить подпапки. Укажите либо целевой формат, либо один из своих пресетов.

Параметры

-t, --to <format>Целевой формат по id или расширению: jpg, png, webp, pdf, docx, hwpx, mp4, mp3… (см. filee formats)
-p, --preset <preset>Пресет из программы, по id или названию (см. filee presets)
-o, --output <folder>Сохранять туда, а не рядом с исходными файлами
-r, --recursiveВключая подпапки
-q, --quality <1-100>Качество изображения для JPG, WebP, AVIF и других форматов со сжатием с потерями
--overwriteЗаменять существующие файлы (по умолчанию к новому имени добавляется номер)
--skipНе трогать существующие файлы
--keep-datesСтавить сконвертированным файлам даты создания и изменения оригиналов
--jsonВывести результат одним документом JSON, для скриптов
--quietВыводить только ошибки

filee watch

filee watch <folder> (--to <format> | --preset <preset>) [options]

Конвертирует каждый файл, попавший в папку, пока вы не нажмёте Ctrl+C. Готовые файлы кладутся в папку converted внутри неё, если не указать -o.

Параметры

-t, --to <format>Целевой формат
-p, --preset <preset>Пресет из программы, по id или названию
-o, --output <folder>Куда класть готовые файлы (по умолчанию <folder>\converted)
-r, --recursiveСледить и за подпапками (их файлы сохраняют подпапку в результате)
--move-originalsПеремещать каждый сконвертированный исходник в <folder>\originals и при запуске конвертировать уже ожидающие там файлы
--settle <seconds>Сколько файл должен оставаться неизменным перед конвертацией (по умолчанию 2)
--keep-datesСтавить сконвертированным файлам даты создания и изменения оригиналов
--quietВыводить только ошибки

filee formats

filee formats [<format>]

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

filee presets

filee presets

Показывает встроенные пресеты и созданные вами в программе, с их id, названием и целевым форматом.

filee help

filee help [<command>]
filee version

Объясняет, как пользоваться всеми командами или одной из них, и показывает установленную версию.

Папки наблюдения

Пусть папка сама конвертирует всё, что вы в неё кладёте: загрузки, сканы, экспорт из других программ.

  • Файлы конвертируются, когда они полностью готовы: больше не растут и не открыты в другой программе, так что загрузки и долгое копирование не помеха.
  • Временные и скрытые файлы (.crdownload, .part, .tmp, файлы ~$) и форматы, которых Filee не знает, пропускаются.
  • Готовые файлы попадают в папку converted внутри наблюдаемой папки или туда, куда указывает -o. С -r файлы из подпапок сохраняют там свою подпапку (2025\a.png → converted\2025\a.pdf).
  • С --move-originals каждый сконвертированный исходник перемещается в originals, и папка работает как входящие. Файлы, которые уже ждут там, конвертируются при запуске.

Или в программе, в фоне

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

D:\Inbox> filee watch . --to pdf --move-originals
Watching D:\Inbox → PDF, saving to D:\Inbox\converted. Press Ctrl+C to stop.
ok    scan-0412.jpg -> converted\scan-0412.pdf

В скриптах

--json выводит один документ JSON с результатом по каждому файлу, а код завершения сообщает скрипту, как всё прошло.

--json

{
  "preset": "WEBP",
  "target": "webp",
  "converted": 2,
  "skipped": 0,
  "failed": 1,
  "files": [
    {
      "source": "D:\\Exports\\cover.png",
      "state": "done",
      "outputs": [ "D:\\Exports\\cover.webp" ]
    },
    {
      "source": "D:\\Exports\\broken.png",
      "state": "failed",
      "outputs": [],
      "error": "The engine reported an error (improper image header)"
    }
  ]
}

Коды завершения

0Ошибок нет
1Часть файлов не удалось сконвертировать (остальные готовы)
2Неверные аргументы, неизвестный формат или пресет либо отсутствующий входной файл
3Нечего конвертировать

Пример для PowerShell

$result = filee convert D:\Exports\*.png --to webp --json | Out-String | ConvertFrom-Json
if ($LASTEXITCODE -eq 1) {
  $result.files | Where-Object state -eq 'failed' | ForEach-Object { "$($_.source): $($_.error)" }
}

Полезно знать

  • Те же движки и пресеты, что и в программе: пресет, созданный или изменённый в Filee, сразу работает с --preset по id или названию.
  • Дополнительные движки (FFmpeg, LibreOffice…) устанавливаются в программе в разделе Настройки → Движки. filee formats <format> показывает, каким конвертациям они нужны.
  • Маски раскрывает сам filee, поэтому *.heic работает и в командной строке, и в PowerShell. Пути с пробелами берите в кавычки.
  • Ничего не загружается в сеть, интернет не нужен: файлы конвертируются на вашем компьютере, как и в программе.
  • Сообщения выводятся на английском, чтобы скрипты и журналы читались одинаково на любом компьютере.

Получите Filee вместе с командой filee

Командная строка входит в Filee для Windows 10/11: бесплатно, с открытым кодом и офлайн.

Скачать для Windows

Версия для macOS — предварительная. Для Linux нужна Ubuntu 22.04 или новее; жестам перетаскивания нужен X11 (в KDE Plasma с Wayland — экспериментально).

Все выпуски Исходный код

Filee бесплатный и останется бесплатным. Поддержать разработку