Filee
繁體中文
GitHub 下載

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 安裝程式的選項頁面，保持勾選 將「filee」命令新增到 PATH（預設已勾選）。已經安裝過了？再執行一次最新的安裝程式即可。

  2. 2

    開啟新的終端機

    開啟新的命令提示字元、PowerShell 或 Windows 終端機視窗（先前已開啟的視窗看不到新的 PATH），然後執行 filee version。

  3. 3

    可攜版或不使用 PATH

    所需檔案都在 Filee 資料夾中：直接執行其中的 filee-cli.exe，或自行把它的 cli 資料夾加入 PATH。Filee 應用程式不需要在執行中。

快速上手

可以傳入檔名、*.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。沒有加上 -o 時，轉換後的檔案會儲存到該資料夾內的 converted 資料夾。

選項

-t, --to <format>目標格式
-p, --preset <preset>應用程式中的預設，依 ID 或名稱指定
-o, --output <folder>轉換後檔案的儲存位置（預設：<資料夾>\converted）
-r, --recursive同時監視子資料夾（轉換結果也保留相同的子資料夾結構）
--move-originals把轉換過的來源檔案移到 <資料夾>\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 <格式> 會顯示哪些轉換需要引擎。
  • 萬用字元由 filee 自行展開，所以 *.heic 在命令提示字元和 PowerShell 中都能用。含空格的路徑請加上引號。
  • 不上傳任何檔案，也不需要網路：和應用程式一樣，在你的電腦上轉換。
  • 訊息一律使用英文，因此指令碼和記錄在每台電腦上都一樣。

下載 Filee，取得 filee 命令

命令列隨 Windows 10/11 版 Filee 一起提供：免費、開放原始碼、可離線使用。

下載 Windows 版

macOS 為預覽版。Linux 需要 Ubuntu 22.04 或更新版本；拖曳手勢需要 X11（在 KDE Plasma 的 Wayland 下為實驗性功能）。

所有版本 原始碼

Filee 免費，並將一直免費。 贊助開發