التثبيت
انسخ المستودع (git clone https://github.com/TerminalDZ/vidcreat.git) أو فك ضغط أرشيف إصدار في أي مكان تريده (مثل Documents/ReelForge). وللحصول على تصدير أسرع، تجنّب المجلدات التي يزامنها OneDrive أو iCloud.
على Windows 10 و11
- ثبّت Node.js 22 LTS من https://nodejs.org (مع الإعدادات الافتراضية). إن لم يكن مثبتاً، يستطيع المثبّت تثبيته عبر
winget. - انقر مرتين على
install.bat. سيتولى ما يلي:- التحقق من Node.js،
- عرض تثبيت ffmpeg عبر
winget(أجب بـ Y)، - تثبيت اعتماديات ReelForge،
- تنزيل إصدار Chromium المحدَّد الذي يُستخدم في التصدير،
- تشغيل فحص كامل للبيئة.
- انقر مرتين على
start.batلفتح لوحة التحكم.
إذا حذّرك Windows SmartScreen من السكربت، اختر More info ← Run anyway. وإذا ثُبّت ffmpeg للتو، أغلق
start.batوأعد فتحه حتى يتعرف Windows على قيمة PATH الجديدة.
على macOS
ثبّت Node.js 22 LTS من https://nodejs.org وHomebrew من https://brew.sh.
افتح Terminal داخل مجلد ReelForge (من Finder: انقر بالزر الأيمن على المجلد ثم New Terminal at Folder) وشغّل:
bash./install.shأجب بـ Y عندما يعرض عليك تشغيل
brew install ffmpeg.انقر مرتين على
ReelForge.command(أو شغّل./start.sh) لفتح لوحة التحكم.
على Linux
./install.sh # add --yes to accept every prompt
./start.sh # opens the dashboardيستخدم المثبّت مدير الحزم لديك (apt أو dnf أو pacman أو zypper) لتثبيت ffmpeg، ويستطيع تثبيت مكتبات النظام التي يحتاجها Chromium (سيطلب صلاحية sudo).
من المصدر (للمطورين)
git clone https://github.com/TerminalDZ/vidcreat.git && cd vidcreat
corepack enable && pnpm install && pnpm build && pnpm reelforge doctor --fixيشرح دليل المساهمة إعداد بيئة التطوير الكاملة على كل نظام.
افحص الإعداد في أي وقت
reelforge doctor # Windows: reelforge.cmd doctorيفحص الأمر Node.js وffmpeg (الإصدار والمرمّزات والمرشحات) وChromium والخطوط المضمّنة، ويطبع الإصلاح الدقيق لكل ما ينقص. وتعرض لوحة التحكم الفحص نفسه في مؤشر الحالة بالشريط العلوي.

نماذج الكلام الاختيارية
تعمل المحاذاة التلقائية للـ cues دون أي تنزيل (بكشف فترات التوقف في الكلام ومطابقتها مع النص المعروف). وللحصول على دقة على مستوى الكلمة مع وجود موسيقى في الخلفية، ثبّت نماذج الكلام الاختيارية مرة واحدة (نحو 180 MB):
reelforge align --setup # downloads Whisper and Silero VAD into your user cache
reelforge align --status # shows what is installedحل المشكلات
| العَرَض | الحل |
|---|---|
| تعرض لوحة التحكم “setup issues” | انقر على المؤشر: يعرض كل فحص فاشل طريقة إصلاحه. السبب الأكثر شيوعاً غياب ffmpeg. |
الرسالة ffmpeg not found | على Windows: winget install Gyan.FFmpeg، وعلى macOS: brew install ffmpeg، وعلى Linux: مدير الحزم. ثم افتح طرفية جديدة أو start.bat. |
| الرسالة “Cannot launch Chromium” | شغّل reelforge doctor --fix. وعلى Linux أعد تشغيل المثبّت ووافق على تثبيت مكتبات النظام. |
| لا يُعثر على ffmpeg رغم تثبيته (Windows) | أغلق كل الطرفيات وstart.bat ثم أعد فتحها: لا يقرأ Windows قيمة PATH الجديدة إلا في النوافذ الجديدة. |
الأمر pnpm غير معروف | شغّل corepack enable مرة واحدة (يأتي Corepack مع Node.js 22)، ثم افتح طرفية جديدة. |
| التصدير بطيء أو يفشل بأخطاء القرص | انقل المجلد خارج OneDrive أو iCloud واترك نحو 2 GB متاحة للملفات المؤقتة. |
تجد إجابات أخرى في أسئلة شائعة وحل المشكلات.
التحديث
إذا نسخت المستودع، شغّل git pull ثم أعد تشغيل المثبّت (أو pnpm install && pnpm build).
إذا نزّلت أرشيف إصدار، نزّل الإصدار الجديد من صفحة الإصدارات، وفك ضغطه بجانب القديم، وانسخ مجلد episodes/ (وأي themes/ أو presets/ خاصة بك) إلى المجلد الجديد، ثم شغّل المثبّت مجدداً. حلقاتك ملفات عادية، فلا شيء آخر يحتاج إلى ترحيل.
إلغاء التثبيت
احذف مجلد ReelForge. أما Chromium المنزَّل فيوجد في مجلد التخزين المؤقت (cache) الخاص بالمستخدم (%LOCALAPPDATA%\ms-playwright على Windows، و~/Library/Caches/ms-playwright على macOS، و~/.cache/ms-playwright على Linux)، ويمكن حذفه أيضاً. وتوجد نماذج الكلام الاختيارية التي يثبّتها الأمر reelforge align --setup في المجلد reelforge داخل مجلد التخزين المؤقت نفسه (%LOCALAPPDATA%\reelforge و~/Library/Caches/reelforge و~/.cache/reelforge).