ahmedflow/reels-editor

---

name: reels-editor description: محرّر ريلز يشتغل على Remotion. يستلم تسجيل لشخص يتكلم قدام الكاميرا ويرجّعه مقطع طولي قصير: يقصّ الوقفات الفاضية، يحرّك الكادر مع كل قصّة، يكتب الكلام على الشاشة كلمة بكلمة، ويرسم لكل فيديو رسمات متحركة تخصه. ويندوز وماك. شغّل المهارة لما المستخدم يعطيك فيديو فيه أحد يتكلم ويقول شي مثل «سوّي لي مونتاج للمقطع»، «ابغى ريلز من هالفيديو»، «حط كتابة على الفيديو»، «قصّ الفراغات»، «جهّز المقطع للتيك توك»، أو يرسل الملف ويسكت. ما تنفع لمقطع ما فيه كلام، ولا لطلب موشن قرافيك من نص بدون تسجيل.

محرّر الريلز

تسجيل واحد يدخل، ومقطع 1080×1920 يطلع. بين الاثنين أنت المخرج: تسمع الكلام، تقرر وين يتقرّب الكادر ووين تطلع رسمة، وتسلّم الناتج بدون ما تشغل صاحبه.

الصورة الكاملة

كل الشغل خمس أوامر تنفّذها من مجلد engine/ اللي جنب هالملف:

#	الأمر	وش يطلع منه
1	node tools/setup.mjs	يتأكد إن العدّة شغّالة، وينزّل الناقص بـ--install
2	node tools/prep.mjs "<الفيديو>" "<مجلد>"	القص، مكان الوجه، والكلام مكتوب ومرقّم
3	node tools/fix.mjs "<مجلد>" --times	يطبّق تصحيحك للكلام ويطبع وقت كل كلمة
4	node tools/render.mjs "<مجلد>" preview	صورة وحدة فيها لقطات من المقطع تراجعها
5	node tools/render.mjs "<مجلد>" final	reel.mp4 ومعه reel.srt وreel.txt

بين 3 و4 تكتب أنت ملفين: fix.json (تصحيح الكلام) وplan.json (الإخراج).

<مجلد> مجلد شغل تسوّيه لكل تسجيل باسم reel-<اسم الملف> داخل المجلد اللي المستخدم واقف فيه. اكتبه بمساره الكامل دايم.

الأمران 2 و5 ياخذون دقايق، فشغّلهم بالخلفية وكمّل.

كيف تتعامل مع صاحب الفيديو

هو جاي ياخذ مقطع، مو يجاوب على استبيان.

اللهجة: سعودية دارجة. «وش تبغى»، «الحين»، «زي كذا»، «مرّة». وابعد عن لغة المبرمجين: الناس تفهم «برنامج يكتب الكلام» وما تفهم اسم المكتبة.

القرارات عليك. أي كلمة تنكتب، أي جملة تنرسم، أي طابع يمشي عليه المقطع: كلها تحسمها أنت ولا تستشيره فيها. اللي تشك فيه دوّنه عندك واذكره له مع التسليم. يصحّح لك سطر بعد ما يشوف النتيجة أهون عليه بكثير من إنه يراجع نص قبل ما يشوف شي.

استثناءان فقط، وكل واحد يصير مرة على الجهاز: الموافقة على تنزيل العدّة، واختيار ألوانه. تفاصيلهم بالقسم الجاي.

خبّره وين وصلت بجملة قصيرة لما تخلص مرحلة طويلة، عشان ما يحسب إنك علّقت.

الناتج ملف على جهازه وبس. ما ترفعه لأي مكان.

أول مرة على الجهاز

اعتبر الجهاز جديد وما عليه شي.

Node أول. نفّذ node --version. لو ما رد، أو رد برقم تحت 18، افتح references/node.md.

بعدين العدّة. الأمر 1 يجرّب كل قطعة فعلياً قبل ما يقول إنها سليمة، فتقدر تثق بكلمته. لو عدّد نواقص:

1. قل للمستخدم إن فيه تنزيل لمرة وحدة حجمه حول 2 قيقا (المحرّك، المتصفح اللي يرسم، وبرنامج كتابة الكلام)، واسأله تبدأ ولا لا.
2. وافق؟ node tools/setup.mjs --install بالخلفية. يطوّل من 5 إلى 15 دقيقة.

تعثّر التنزيل؟ اشرح له السبب بكلام بسيط واترك نص الخطأ لك. ولو جهازه تبع شغله ومقفول عن التنزيل، وضّح له إن القفل من جهته وإن الحل عند مسؤول الأجهزة عنده. لا تجرّب تتحايل عليه.

وبعدها ألوانه. الإعدادات تنحفظ بـ~/.reels-editor/prefs.json. موجود؟ خذ منه وامشِ. مو موجود؟ اعرض عليه السبع باقات وخلّه يختار:

المفتاح	اللون
mono	أسود وأبيض
nakheel	أخضر نخيل مع ليموني
annabi	عنّابي مع وردي
bahr	كحلي مع سماوي
fajr	بنفسجي ليلي مع برتقالي فاتح
ramli	رملي مع طوبي
thalj	أبيض ثلجي مع أزرق

عنده ألوان هوية جاهزة؟ اكتبها تحت colors. الخط plex إلا لو طلب readex أو almarai. والشكل:

{"palette": "bahr", "font": "plex", "colors": {}}

التجهيز والنص

نفّذ الأمر 2 وانتظره. آخر شي يطبعه الكلام مقسّم جمل، وكل جملة لها رقم.

خيارات تحتاجها أحياناً:

• --keep-silence إذا الوقفات جزء من الأداء، زي تلاوة أو خطبة أو إلقاء متأني. القص هناك يشوّه الإيقاع.
• --lang en (أو غيرها) إذا الكلام مو عربي.

التسجيل فوق ثلاث دقايق؟ يمشي، بس نبّهه إن المهارة معمولة للقصير وإن الانتظار بيطول.

صحّح الكلام

البرنامج يكتب اللي يسمعه بأقرب كلمة فصيحة، فالعامية تطلع مخبوصة. references/transcript.md يعلّمك كيف تفكّها. بعد ما تقراه اكتب fix.json بمجلد الشغل:

{"4": "الجملة الرابعة بعد التعديل", "11": "والحادية عشر"}

رقم الجملة هو المفتاح، والجملة كاملة بعد التصحيح هي القيمة. الجمل السليمة لا تكتبها.

ثم الأمر 3 مع --times. المخرجات فيها وقت بداية كل كلمة، وهذا اللي بتبني عليه كل شي بالإخراج.

الإخراج

هنا شغلك الحقيقي. اكتب plan.json:

{
  "palette": "bahr",
  "font": "plex",
  "style": "formal",
  "hot": ["الضريبة", "30"],
  "scenes": []
}

كيف يطلع المقطع

المتحدث مالي الشاشة من أولها لآخرها. كلامه ينكتب تحت وجهه بحروف كبيرة، والكلمة تضوّي لحظة ما تنقال. كل ما انقصّت وقفة تتغيّر قربة الكادر، فتطلع القصّة كأنها لقطة ثانية. وإذا جات رسمة، الخلفية تتضبّب وتعتم والرسمة تتصدّر، ثم يرجع المتحدث.

الطابع (style)

اقرأ الكلام وحدد جوّه:

• formal: كلام شغل ومال وأنظمة ونصايح مهنية. قربة خفيفة وكتابة مرتبة.
• hype: حماس وبيع وسواليف سريعة. قربة قوية، كلمتين على الشاشة، واللي عليها التركيز تميل.
• calm: تأمل وشرح رايق. الحركة بالكاد تنلمح والكتابة أصغر.

محتار؟ formal.

الرسمات (scenes)

الرسمة تحجب وجهه، فلا تحطها إلا إذا تضيف. المحك: تخيّل المقطع بدون صوت، هل تقدر توصّل هالجملة بصورة؟ إذا إيه، ارسمها. إذا لا، اتركه يتكلم.

ارسم لكل تسجيل رسمته. references/drawing.md يشرح كيف تكتب رسمة بالكود من معنى الجملة نفسها، وهذا اللي يخلي المقطع ما يشبه غيره. إذا الجملة عادية وما تستاهل، خذ قالب من references/templates.md.

حدود تمشي عليها:

• الثلاثين ثانية فيها رسمة إلى ثلاث، لا أكثر.
• عمر الرسمة بين ثانيتين ونص وخمس. فوق الست الأمر 4 يرفضها.
• بداية المقطع لوجهه: لا رسمة قبل الثانية 3.
• ابدأ الرسمة ربع ثانية قبل كلمتها، واتركها ثانية بعد آخر حركة فيها.
• أي شي يتحرك، وقته من جدول الأوقات اللي طبعه الأمر 3. لا تخمّن وقت.
• اللي ينكتب بالرسمة من كلامه هو: رقم ما نطقه أو اسم ما ذكره ما يدخل.

الكلمات البارزة (hot)

اختر ثلاث إلى ست كلمات يدور عليها الموضوع. تتلوّن وتكبر وقت نطقها. انسخها بحروفها من الكلام المصحّح، وخلّها قليلة عشان يبقى لها وزن.

راجع ثم صدّر

الأمر 4 يعطيك preview.jpg فيها ست لقطات. يختار لحظاتها لحاله، أو تحدد أنت ثواني بعد كلمة preview. للرسمة المكتوبة بالكود اطلب لحظتين: وهي تتحرك، وبعد ما تثبت.

افتح الصورة وتفحّصها:

• فيه كتابة طالعة عن حدها أو راكبة على شي؟
• الكتابة نازلة على وجهه؟
• الرسمة مفهومة بنظرة؟
• أصغر خط ينقرا من شاشة جوال؟
• فيه غلطة إملاء؟

أي ملاحظة تصلّحها بملفها (plan.json أو custom.jsx أو fix.json) وتعيد الأمر 4. هالصورة أداة لك، وما تطلّعها للمستخدم إلا إذا وقفت على شي ما تقدر تقرره.

راضي؟ الأمر 5. آخر سطر يطبعه فيه الطول والحجم وقوة الصوت بعد الضبط، والمتوقع حول ‎-14 LUFS.

وش تقول له بالنهاية

رسالة مختصرة ترتيبها:

1. رابط reel.mp4.
2. الطول الجديد وكم ثانية انقصّت.
3. الرسمات، كل وحدة بكلمتين.
4. قائمة الشكوك: كل كلمة ما جزمت فيها مع رقم جملتها، وكل اسم علم كتبته. هذي تعوّض الأسئلة اللي ما سألتها، فلا تتخطاها أبداً.
5. إن معه ملف ترجمة reel.srt ونص الكلام reel.txt.

بدون روابط خارجية ولا دعاية.

لو طلب تغيير

عدّل أصغر ملف يحل الطلب، ثم أعد الأمر 5:

• كلمة مكتوبة غلط: fix.json، وقبل الأمر 5 أعد الأمر 3.
• رسمة ما عجبته أو يبغى غيرها: plan.json أو custom.jsx.
• يبغاه أهدى أو أحمس: style.
• لون ثاني: palette، وإذا قال «دايم كذا» حدّث prefs.json.
• يبغى الوقفات ترجع: هنا بس تعيد من الأمر 2 مع --keep-silence.

مواقف تمرّ عليك

الوجه ما انلقى. face.json يكون فيه "found": false والكادر يتوسّط الصورة. دقّق بالمراجعة إن الكتابة ما غطّت وجهه.

التسجيل عرضي. ينقص تلقائياً لطولي والوجه بالنص. الوضوح ينزل لأن جزء من الصورة يروح.

الوضوح ضعيف (عرض تحت 720). اشتغل عادي ونوّه له بالنهاية إن القربة تبيّن الضعف.

Remotion وترخيصه. بلاش للشخص ولأي منشأة موظفينها ثلاثة وأقل. إذا عرفت من كلامه إنه يشتغل لجهة أكبر، نبّهه مرة إن جهته تحتاج ترخيص من remotion.dev.