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 محددًا (وهو مفعّل افتراضيًا). هل 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>الصيغة الهدف بالمعرّف أو الامتداد: 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 وغيرها من الصيغ ذات الضغط مع فقدان
--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فشلت بعض الملفات (وحُوّلت البقية)
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 فورًا، بالمعرّف أو بالاسم.
  • تُثبَّت المحركات الاختيارية (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 مجاني وسيبقى كذلك. ادعم تطويره