Filee
فارسی
GitHub دانلود

Windows 10/11پیش‌تنظیم‌های شماخروجی JSON

خط فرمان filee

فایل‌ها را از Command Prompt، 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

    یک ترمینال جدید باز کنید

    یک پنجره جدید Command Prompt، 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>فرمت مقصد با شناسه یا پسوند: jpg، png، webp، pdf، docx، hwpx، mp4، mp3… (filee formats را ببینید)
-p, --preset <preset>یک پیش‌تنظیم از برنامه، با شناسه یا نام (filee presets را ببینید)
-o, --output <folder>ذخیره در آنجا به جای کنار فایل‌های مبدأ
-r, --recursiveشامل زیرپوشه‌ها
-q, --quality <1-100>کیفیت تصویر برای JPG، WebP، AVIF و سایر فرمت‌های با فشرده‌سازی پراتلاف
--pages <range>صفحه‌های PDF، مثلاً 13-55 یا 1-3,8,12-15 (به طور پیش‌فرض صفحه‌های پیش‌تنظیم)
--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>یک پیش‌تنظیم از برنامه، با شناسه یا نام
-o, --output <folder>محل فایل‌های تبدیل‌شده (پیش‌فرض: ‎<folder>\converted)
-r, --recursiveزیر نظر گرفتن زیرپوشه‌ها نیز (فایل‌هایشان زیرپوشه خود را در خروجی حفظ می‌کنند)
--move-originalsانتقال هر فایل مبدأ تبدیل‌شده به ‎<folder>\originals و تبدیل فایل‌هایی که هنگام شروع از قبل در آنجا منتظرند
--settle <seconds>مدتی که یک فایل باید بدون تغییر بماند تا تبدیل شود (پیش‌فرض 2)
--keep-datesدادن تاریخ ایجاد و ویرایش فایل‌های اصلی به فایل‌های تبدیل‌شده
--quietچاپ نکردن هیچ چیز جز خطاها

filee formats

filee formats [<format>]

همه فرمت‌ها را با شناسه و پسوندهایشان فهرست می‌کند، یا فرمت‌هایی را که یک فرمت به آن‌ها تبدیل می‌شود، از جمله آنچه یک موتور اختیاری اضافه می‌کند.

filee presets

filee presets

پیش‌تنظیم‌های داخلی و آن‌هایی را که در برنامه ساخته‌اید، با شناسه، نام و فرمت مقصدشان فهرست می‌کند.

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برخی فایل‌ها ناموفق بودند یا لغو شدند (state هر فایل در --json مشخص می‌کند کدام)
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 در یک عامل هوش مصنوعی

Filee یک Agent Skill در skills/filee/SKILL.md دارد. این مهارت به عامل‌های برنامه‌نویسی یاد می‌دهد دستور filee را چطور اجرا کنند: بررسی نصب بودن Filee، پرسیدن از filee formats <format> --json درباره امکان یک تبدیل، تبدیل با --json و -o و خواندن نتیجه.

برای استفاده، پوشه skills/filee را در پوشه مهارت‌های (skills) عامل خود کپی کنید. برای Codex این پوشه ~/.agents/skills/ فقط برای خودتان، یا .agents/skills/ داخل یک پروژه است. برای Claude Code از ~/.claude/skills/ یا .claude/skills/ پروژه استفاده کنید (مستندات). عامل‌های دیگری که از Agent Skills پشتیبانی می‌کنند پوشه خودشان را دارند، پس مستندات آن‌ها را ببینید.

این مهارت به عامل می‌گوید فقط به کد خروج اعتماد نکند. عامل converted، state و outputs را از JSON می‌خواند و اگر فایلی به موتوری نیاز داشته باشد که Filee هنوز ندارد، از شما می‌خواهد آن را در تنظیمات ← موتورها دریافت کنید.

خوب است بدانید

  • همان موتورها و پیش‌تنظیم‌های برنامه: پیش‌تنظیمی که در Filee می‌سازید یا تغییر می‌دهید، بلافاصله با ‎--preset، با شناسه یا نام، کار می‌کند.
  • موتورهای اختیاری (FFmpeg، LibreOffice…) در برنامه از تنظیمات ← موتورها نصب می‌شوند. filee formats <format> نشان می‌دهد کدام تبدیل‌ها به یکی از آن‌ها نیاز دارند.
  • نویسه‌های عام را خود filee باز می‌کند، بنابراین ‎*.heic هم در Command Prompt و هم در PowerShell کار می‌کند. مسیرهای دارای فاصله را داخل گیومه بگذارید.
  • هیچ چیزی آپلود نمی‌شود و به اینترنت نیازی نیست: فایل‌ها مثل خود برنامه روی رایانه شما تبدیل می‌شوند.
  • پیام‌ها به انگلیسی هستند، تا اسکریپت‌ها و گزارش‌ها روی هر رایانه‌ای یکسان خوانده شوند.

Filee را همراه با دستور filee دریافت کنید

خط فرمان همراه Filee برای Windows 10/11 ارائه می‌شود: رایگان، متن‌باز و آفلاین.

دانلود برای Windows دانلود از Microsoft Store

یا با WinGet winget install KnifeLemon.Filee

نسخه macOS پیش‌نمایش است. Linux به Ubuntu 22.04 یا جدیدتر نیاز دارد؛ حرکت‌های کشیدن به X11 نیاز دارند (روی KDE Plasma با Wayland آزمایشی است).

همه نسخه‌ها کد منبع

Filee رایگان است و رایگان می‌ماند. از توسعه آن حمایت کنید