# 🎬 دليل تثبيت وتشغيل إضافة «كلمات» لبرنامج Adobe Premiere Pro

أهلاً بك! هذا الدليل يشرح لك خطوة بخطوة وبكل وضوح كيفية تثبيت الإضافة وتشغيلها داخل Premiere Pro.

---

## ⚡ الطريقة الأولى: التثبيت التلقائي بنقرة واحدة (موصى بها)

يحتوي هذا المجلد على ملف تثبيت تلقائي يوفّر عليك كل الخطوات اليدوية:

1. **أغلق برنامج Adobe Premiere Pro** إن كان مفتوحاً.
2. انقر نقراً مزدوجاً على الملف:
   👉 **`install.bat`**
3. ستظهر لك شاشة سوداء تقوم تلقائياً بـ:
   - تفعيل وضع تصحيح الإضافات (Debug Mode) في نظام ويندوز.
   - نقل وتركيب ملفات الإضافة في مجلد Adobe الصحيح.
4. عند ظهور رسالة:
   `✓ اكتمل التثبيت بنجاح!`
   اضغط أي مفتاح لإغلاق النافذة.

---

## 🛠️ الطريقة الثانية: التثبيت اليدوي (إذا رغبت بذلك)

إذا واجهت أي مانع في تشغيل ملف التثبيت التلقائي، يمكنك اتباع الخطوات التالية يدوياً:

### الخطوة ١: تفعيل وضع تصحيح الإضافات (Debug Mode)
لكي يقبل Adobe Premiere تشغيل الإضافات:
1. اضغط من لوحة المفاتيح على: `Windows + R`
2. اكتب `regedit` واضغط **Enter**.
3. توجّه للمسار التالي:
   `HKEY_CURRENT_USER\Software\Adobe`
4. ابحث عن المجلدات التي تبدأ بـ `CSXS.` (مثل `CSXS.10` أو `CSXS.11` أو `CSXS.12`).
5. داخل كل مجلد منها، انقر بالزر الأيمن واختر:
   **New** ➔ **String Value**
   وسمّها: `PlayerDebugMode`
6. انقر عليها نقراً مزدوجاً واجعل قيمتها: `1`

---

### الخطوة ٢: نسخ ملفات الإضافة
1. اضغط من لوحة المفاتيح على: `Windows + R`
2. الصق المسار التالي واضغط **Enter**:
   ```
   %APPDATA%\Adobe\CEP\extensions
   ```
   *(إن لم تجد مجلد `extensions` أنشئه بنفسك).*
3. أنشئ مجلداً جديداً داخل هذا المسار باسم:
   ```
   com.aivideo.arabictranslator
   ```
4. انسخ جميع الملفات والمجلدات الموجودة في هذا الملف المضغوط (ما عدا `install.bat` و `README.txt`) والصقها داخل المجلد الجديد، بحيث يصبح شكل المسار:
   ```
   %APPDATA%\Adobe\CEP\extensions\com.aivideo.arabictranslator\
   ├── CSXS/
   │   └── manifest.xml
   ├── css/
   ├── js/
   ├── jsx/
   ├── presets/
   └── index.html
   ```

---

## 🚀 كيفية فتح الإضافة والبدء بالاستخدام

1. افتح برنامج **Adobe Premiere Pro**.
2. افتح مشروعك وضع الفيديو في خط التايم‌لاين (Timeline).
3. من القائمة العلوية للبرنامج اذهب إلى:
   **Window** ➔ **Extensions** ➔ **AI Arabic Subtitle Translator**
4. ستفتح لك نافذة الإضافة:
   - سجّل دخولك بحسابك في **كلمات** (تحصل على رصيد تجريبي مجاني).
   - اختر لغة الفيديو الأصلية واللغة المطلوب الترجمة إليها (أو اختر النسخ الحرفي).
   - اضغط **✦ ترجمة التسلسل النشط**.
5. سيتم معالجة الصوت وتوليد ملف الترجمة (SRT) وإدراجه مباشرة على خط التايم‌لاين!

---

## ❓ استفسارات أو مشاكل شائعة

* **لم تظهر الإضافة في قائمة Window ➔ Extensions؟**
  - تأكد من إعادة تشغيل Premiere Pro بالكامل بعد التثبيت.
  - تأكد من تطبيق خطوة `PlayerDebugMode = 1`.
* **ظهرت شاشة بيضاء أو لم تتصل الإضافة؟**
  - تأكد من اتصالك بالإنترنت وأن خادم الخدمة يعمل.

💙 فريق عمل «كلمات» نتمنى لك تجربة ممتعة ومونتاجاً أسرع وأسهل!
