Windows 10/11Twoje ustawienia wstępneWynik JSON

Wiersz poleceń filee

Konwertuj pliki z Wiersza polecenia, PowerShella lub własnych skryptów tymi samymi silnikami i ustawieniami wstępnymi co w aplikacji albo zostaw folder, który konwertuje wszystko, co do niego trafi. Wszystko zostaje na Twoim komputerze.

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).

Konfiguracja polecenia filee

  1. 1

    Zostaw zaznaczone w instalatorze

    Na stronie opcji instalatora Filee zostaw zaznaczoną opcję Add the "filee" command to PATH (dodaj polecenie filee do PATH; domyślnie jest włączona). Filee jest już zainstalowane? Uruchom ponownie najnowszy instalator.

  2. 2

    Otwórz nowy terminal

    Otwórz nowe okno Wiersza polecenia, PowerShella lub Windows Terminal (okno otwarte wcześniej nie widzi nowego PATH) i uruchom filee version.

  3. 3

    Wersja przenośna lub bez PATH

    Wszystko jest w folderze Filee: uruchom tam filee-cli.exe albo sam dodaj jego folder cli do PATH. Aplikacja nie musi być uruchomiona.

Szybki start

Podaj nazwy plików, symbole wieloznaczne, np. *.heic, lub całe foldery. Wyniki są zapisywane obok oryginałów, chyba że dodasz -o.

Polecenia

filee convert

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

Konwertuje pliki, symbole wieloznaczne (*.heic) i foldery. W folderze konwertowane są pliki, które Filee zna; dodaj -r, aby objąć podfoldery. Podaj format docelowy albo jedno ze swoich ustawień wstępnych.

Opcje

-t, --to <format>Format docelowy według id lub rozszerzenia: jpg, png, webp, pdf, docx, hwpx, mp4, mp3… (zob. filee formats)
-p, --preset <preset>Ustawienie wstępne z aplikacji, według id lub nazwy (zob. filee presets)
-o, --output <folder>Zapis w tym folderze zamiast obok plików źródłowych
-r, --recursiveUwzględnij podfoldery
-q, --quality <1-100>Jakość obrazu dla JPG, WebP, AVIF i innych formatów stratnych
--overwriteZastępuj istniejące pliki wynikowe (domyślnie do nowej nazwy dodawany jest numer)
--skipNie zmieniaj istniejących plików wynikowych
--keep-datesNadaj przekonwertowanym plikom daty utworzenia i modyfikacji oryginałów
--jsonWypisz wynik jako jeden dokument JSON, dla skryptów
--quietWypisuj tylko błędy

filee watch

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

Konwertuje każdy plik, który trafi do folderu, dopóki nie naciśniesz Ctrl+C. Przekonwertowane pliki trafiają do folderu converted wewnątrz niego, chyba że dodasz -o.

Opcje

-t, --to <format>Format docelowy
-p, --preset <preset>Ustawienie wstępne z aplikacji, według id lub nazwy
-o, --output <folder>Dokąd trafiają przekonwertowane pliki (domyślnie: <folder>\converted)
-r, --recursiveObserwuj też podfoldery (ich pliki zachowują podfolder w wyniku)
--move-originalsPrzenoś każdy przekonwertowany plik źródłowy do <folder>\originals, a przy starcie konwertuj pliki, które już czekają w folderze
--settle <seconds>Jak długo plik musi pozostać niezmieniony, zanim zostanie przekonwertowany (domyślnie 2 s)
--keep-datesNadaj przekonwertowanym plikom daty utworzenia i modyfikacji oryginałów
--quietWypisuj tylko błędy

filee formats

filee formats [<format>]

Wypisuje każdy format z jego id i rozszerzeniami albo to, na co można przekonwertować jeden format – łącznie z tym, co dodałby opcjonalny silnik.

filee presets

filee presets

Wypisuje wbudowane ustawienia wstępne i te utworzone w aplikacji, z ich id, nazwą i formatem docelowym.

filee help

filee help [<command>]
filee version

Pokazuje, jak używać wszystkich poleceń lub jednego z nich, oraz zainstalowaną wersję.

Obserwowane foldery

Niech folder konwertuje wszystko, co do niego włożysz: pobrane pliki, skany, eksporty z innych aplikacji.

  • Pliki są konwertowane, gdy są kompletne – już nie rosną i nie są otwarte w innym programie – więc pobierane pliki i długie kopiowanie są bezpieczne.
  • Pliki tymczasowe i ukryte (.crdownload, .part, .tmp, pliki ~$) oraz formaty nieznane Filee są pomijane.
  • Przekonwertowane pliki trafiają do folderu converted w obserwowanym folderze albo tam, gdzie wskazuje -o. Z -r pliki z podfolderów zachowują tam swój podfolder (2025\a.png → converted\2025\a.pdf).
  • Z --move-originals każdy przekonwertowany plik źródłowy trafia do originals, więc folder działa jak skrzynka odbiorcza. Pliki, które już w nim czekają, są konwertowane przy starcie.

Albo w aplikacji, w tle

Strona Obserwowane foldery w Filee robi to samo bez terminala: dodaj foldery, wybierz dla każdego ustawienie wstępne, a pliki będą konwertowane, gdy Filee działa w zasobniku.

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

Użycie w skryptach

--json wypisuje jeden dokument JSON z wynikiem każdego pliku, a kod wyjścia mówi skryptowi, jak poszło.

--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)"
    }
  ]
}

Kody wyjścia

0Wszystko się udało
1Niektórych plików nie udało się przekonwertować (pozostałe zostały przekonwertowane)
2Błędne argumenty, nieznany format lub ustawienie wstępne albo brak danych wejściowych
3Nie ma czego konwertować

Przykład w PowerShellu

$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)" }
}

Warto wiedzieć

  • Te same silniki i ustawienia wstępne co w aplikacji: ustawienie utworzone lub zmienione w Filee od razu działa z --preset, według id lub nazwy.
  • Opcjonalne silniki (FFmpeg, LibreOffice…) instaluje się w aplikacji w Ustawienia → Silniki. filee formats <format> pokazuje, które konwersje wymagają silnika.
  • Symbole wieloznaczne rozwija samo filee, więc *.heic działa zarówno w Wierszu polecenia, jak i w PowerShellu. Ścieżki ze spacjami ujmij w cudzysłów.
  • Nic nie jest przesyłane i internet nie jest potrzebny: pliki są konwertowane na Twoim komputerze, tak jak w aplikacji.
  • Komunikaty są po angielsku, więc skrypty i logi wyglądają tak samo na każdym komputerze.

Pobierz Filee z poleceniem filee

Wiersz poleceń jest częścią Filee dla Windows 10/11: za darmo, open source i offline.

Pobierz dla Windows

macOS i Linux to wersje zapoznawcze.

Wszystkie wydania Kod źródłowy

Filee jest darmowe i takie zostanie. Wesprzyj rozwój