﻿ROLL WIZARD  -  Premiere panel that removes shaky parts of your clips and stabilizes the rest
================================================================================================

التثبيت (ضغطة واحدة)
1. فك ضغط الحزمة كاملة في أي مكان.
2. أغلق Premiere.
3. انقر نقراً مزدوجاً على:  Install Roll Wizard.bat
4. افتح Premiere ثم: Window  ←  UXP Plugins  ←  Roll Wizard
لا يحتاج صلاحيات مدير. يحتاج الإنترنت مرة واحدة أثناء التثبيت لتنزيل FFmpeg (حوالي 110 ميجابايت)، والباقي (بايثون وOpenCV) داخل الحزمة.
بدون إنترنت: نزّل ffmpeg-release-essentials.zip من gyan.dev وضعه بجانب ملف التثبيت (لا تفك ضغطه) ثم شغّل التثبيت.

INSTALL (one click)
1. Extract the whole package anywhere.
2. Close Premiere.
3. Double-click:  Install Roll Wizard.bat
4. Open Premiere, then: Window > UXP Plugins > Roll Wizard
No administrator rights needed. Internet is needed once during install to download FFmpeg (about 110 MB); the rest (Python, OpenCV) is inside.
Offline: download ffmpeg-release-essentials.zip from gyan.dev, put it next to the installer (do not extract it), then run the installer.

المتطلبات / REQUIREMENTS
- Windows 10 / 11 (64-bit)
- Internet connection during the first install (FFmpeg download)
- Adobe Premiere 2025 (25.6) or newer + the Creative Cloud desktop app (it provides Adobe's plugin installer)

الاستعمال / USE
1. حدّد لقطة أو أكثر في التايم لاين (Select clips in the timeline).
2. اضغط «تحليل اللقطات المحددة» (Analyze).
3. راجع النتائج ثم اضغط «حذف الأجزاء المهتزة وإغلاق الفراغات» (Remove shaky parts and close gaps).
4. للتراجع اضغط زر ↶ (Undo).

إلغاء التثبيت / UNINSTALL
Double-click:  Uninstall Roll Wizard.bat

أين تُثبَّت الملفات / WHERE THINGS GO
- المحرك / engine :  %USERPROFILE%\AppData\Local\RollWizard
- اللوحة / panel  :  installed by Adobe's Unified Plugin Installer (visible in Creative Cloud > Plugins)
- سجل التثبيت / install log:  %TEMP%\RollWizard-install.log

إذا حجب برنامج الحماية المحرك / If security software blocks the engine
أضف المجلد %USERPROFILE%\AppData\Local\RollWizard إلى الاستثناءات (Add it to the exclusions).

إذا لم تظهر اللوحة أو حدثت مشكلة / IF THE PANEL DOES NOT SHOW OR SOMETHING GOES WRONG
1. افتح Premiere ومشروعك وانتظر دقيقة أو دقيقتين. Open Premiere and your project and wait one or two minutes.
2. إن بقيت اللوحة فارغة ستظهر فيها رسالة بزرّين: «إعادة المحاولة» و«إرسال تقرير». Press Retry; if it does not help press Send report.
3. وفي نافذة «حول» (أيقونة اللوحة) زر «إرسال تقرير» أيضًا. The About window has a Send report button too.
4. تعذّر الإرسال؟ شغّل «Roll Wizard - Problem report.bat» وأرسل الملف RollWizard-diagnose.txt الذي يظهر على سطح المكتب إلى المطوّر. If sending fails, double-click "Roll Wizard - Problem report.bat" and send the RollWizard-diagnose.txt file from your Desktop to the developer.
(التقرير لا يتضمن كود التفعيل ولا أسماء المشاريع. The report holds no license code and no project names.)
