المطورون

واجهة سطر الأوامر

ثبّت أداة SubFT واربط المشاريع المحلية وشغّل عمليات الترجمة من الطرفية.

بدء سريع
pip install subft-cli
subft login
subft project sync /media/library --create
subft operation start /media/library --lang de

سير العمل

من تسجيل الدخول إلى المخرجات المحلية

صادق مرة واحدة، واربط مجلداً محلياً، وابدأ العمل البعيد، ثم طبّق النتيجة محلياً.

  1. 1تسجيل الدخولاحفظ الرمز واختر بوابة واجهة البرمجة.
  2. 2الربط والمزامنةاربط مجلداً بمشروع ووفّق ملفات الوسائط.
  3. 3البدء والمراقبةأنشئ عملية وانتظر تقدمها أو افصلها للعودة إليها لاحقاً.
  4. 4تطبيق المخرجاتاكتب المسارات المكتملة أو المخرجات المضمنة في المجلد المحلي.

المرجع

الأوامر والخيارات

هذه هي مجموعات الأوامر العامة المستقرة. يمكن استخدام خيارات الأتمتة العامة حيث تكون مدعومة.

الخيارات العامة

الأمرالخياراتالغرض
subft COMMAND[--json] [--yes]

تشغيل أي أمر بمخرجات JSON ذات إصدار أو معالجة تأكيد حتمية.

subft --version—

طباعة إصدار CLI المثبت.

subft --help—

عرض مرجع الأمر الرئيسي؛ ويدعم كل أمر فرعي --help أيضاً.

المصادقة

الأمرالخياراتالغرض
subft login[--api-url URL] [--token TOKEN]

المصادقة برمز واختيار بوابة أخرى اختيارياً.

subft status[--api-url URL]

عرض البوابة والهوية ومصدر بيانات الاعتماد الحالية.

subft logout—

إزالة الرمز الذي حفظته أداة سطر الأوامر.

المشاريع والمزامنة

الأمرالخياراتالغرض
subft project bind PATH[--project-id ID | --create [--name NAME]] [--api-url URL]

ربط مسار محلي بمشروع موجود أو جديد.

subft project forget PATH[--project-id ID | --all] [--api-url URL]

إزالة رابط مشروع محلي واحد أو كل الروابط.

subft project bindings[PATH]

سرد الروابط المحفوظة مع إمكانية تصفيتها حسب المسار.

subft project sync PATH[--preview] [--include-hidden] [--project-id ID | --create [--name NAME]] [--api-url URL]

معاينة أو تطبيق مزامنة حتمية بين المسار المحلي والمشروع.

العمليات

الأمرالخياراتالغرض
subft operation start PATH --lang CODE[--output-target TARGET] [--remove-track] [--wait | --detach] [--include-hidden] [--project-id ID | --create [--name NAME]] [--allow-partial] [--api-url URL]

بدء عملية ترجمة للمشروع المرتبط واللغة المختارة.

subft operation watch OPERATION_ID[--api-url URL]

متابعة العملية حتى تصل إلى حالة نهائية.

subft operation apply OPERATION_ID PATH[--output-target TARGET] [--remove-track | --keep-track] [--allow-partial] [--api-url URL]

تنزيل عملية مكتملة وتطبيقها على الملفات المحلية.

مدخلات CLI المدعومة

فيديوMP4, MKV, AVI, MOV, WEBM
صوتMP3, WAV, FLAC, AAC, OGG, M4A
ترجماتSRT, VTT, ASS
زوج VobSubIDX + SUB

أهداف الإخراج

اختر ملف ترجمة خارجياً أو JSON من SubFT أو مخرج وسائط مضمناً.

  • external_srt
  • external_vtt
  • external_ass
  • external_csubs_json
  • embedded

البوابة والإعداد المحلي

مرّر --api-url أو استخدم متغيرات البيئة هذه للبوابات وبيانات الاعتماد غير الافتراضية.

  • SUBFT_API_URL
  • SUBFT_API_TOKEN

تستخدم الأداة مواقع XDG هذه وتعود إلى مسارات مجلد المنزل الموضحة. تتطلب أنظمة POSIX صلاحيات خاصة.

  • $XDG_CONFIG_HOME/subft/config.json~/.config/subft/config.json
  • $XDG_STATE_HOME/subft/projects.json~/.local/state/subft/projects.json

استكشاف الأخطاء

الأخطاء الشائعة

لم يتم العثور على FFmpegثبّت ffmpeg وffprobe وتأكد من توفرهما في PATH.
المصادقة قديمةشغّل status ثم سجل الدخول مجدداً بالرمز النشط إذا فشل التحقق.
المجلد غير مرتبطاربطه بمشروع أو أضف --project-id أو --create إلى الأمر.
اكتملت العملية جزئياًراجع الأخطاء المبلغ عنها واستخدم --allow-partial فقط عند قبول النتائج الجزئية.