
شنو هو Cinecode؟
Cinecode هو طقم مفتوح المصدر لصناعة الأفلام باستعمال وكلاء البرمجة بالذكاء الاصطناعي. كتوصف فيلم، إشهار، فيديو تفسيري، وثائقي، ولا فيديو موسيقي، وكيعاونك وكيل فكتابة السيناريو، وبناء كل لقطة بالكود، وتصميم الموسيقى التصويرية، ورندرة المسودات، وتسليم ملف MP4 نهائي.
كيخدم الطقم محليا عبر Claude Code ولا Cursor. وكيستعمل سير عمل الرندرة رسومات المتصفح بحال Canvas 2D وthree.js/WebGL، وChrome بلا واجهة، وffmpeg. ما كايناش حاجة لخدمة مدفوعة لتوليد الفيديو. التعليق الصوتي يقدر يستعمل الولوج ديالك لـ Gemini ولا ElevenLabs، أو محرك صوت تركي اختياري، أو صوت مؤقت ديال النظام.
يقدر Cinecode ينتج مشاريع كتبدأ من إعلانات عمودية مدتها 15 ثانية وكتوصل لوثائقيات ومقالات فيديو أطول من عشر دقايق. المشاريع القصيرة تقدر تبنى فجلسة خدامة وحدة، بينما الإنتاجات الطويلة كتستعمل مسار موافقات على مراحل.
الإمكانيات الرئيسية
- أفلام قصيرة مبنية بالكود: اختار معالجة واقعية ثلاثية الأبعاد، أو تحريك ثنائي الأبعاد، أو الرسم، أو الحبر، أو الورق، أو الطين، أو الرسومات الحركية، أو أسلوب مستوحى من البيكسل.
- فيديوهات طويلة: كيدعم نمط الفيلم سيناريوهات مبنية على البحث، وفصولا، وأجزاء، وتعليقا صوتيا، ومواد أرشيفية، وخرائط، ورسومات توضيحية، وفضاءات معاد بناؤها.
- الإعلانات وأفلام المنتجات: وفّر ألوان العلامة التجارية، والخطوط، والشعارات، وتفاصيل المنتج، والدعوة لاتخاذ إجراء. يمكن تجهيز مشاريع الإشهار للتسليم بصيغ 9:16 و1:1 و16:9 مع مناطق آمنة.
- الفيديوهات التفسيرية العمودية: أنشئ فيديوهات مدتها 30–60 ثانية بسؤال مباشر، وطباعة حركية، ورسومات توضيحية، ونص مقروء على الهاتف.
- الفيديوهات الموسيقية: يقدر Cinecode يقيس شبكة إيقاع الأغنية، ويحط القطوع على الموازير، ويطابق اللمسات مع الإيقاعات، ويربط الصور بأسطر الكلمات.
- مونتاج اللقطات: يمكن تقطيع تسجيلات المتحدث أمام الكاميرا وتسجيلات الشاشة انطلاقا من نصوص مضبوطة زمنيا حسب الكلمات، مع حذف التوقفات وربط الرسومات بالكلمات المنطوقة. هاد المسار الاختياري كيحتاج Whisper.
- صيغ قابلة لإعادة الاستعمال: حفظ صيغة فيلم واستعمالها كأساس لحلقات لاحقة.
- صوت مصمم: كيدعم سير العمل الأجواء، والمؤثرات، ومعالجة التعليق الصوتي، والموسيقى، والصدى المشترك، وإتقان الصوت عند −14 LUFS.
كيفاش كيخدم سير العمل
- وصف الفكرة. جملة وحدة كافية، ولكن موجز كامل يقدر ينقص عدد الأسئلة الإضافية.
- الجواب على الأسئلة الإبداعية. كيسول الوكيل على التأويل، والوسيط البصري، والمدة، ونسبة الأبعاد، والمظهر، والتعليق الصوتي، والموسيقى. الأجوبة المقترحة معلّمة بنجمة.
- مراجعة الخطة. كتوصل بإيقاعات مضبوطة زمنيا وببطاقة مخرج قابلة للتعديل. وقبل بناء الفيلم كامل، كيقدم الوكيل لقطات من مشهدين مختلفين بوضوح.
- مراجعة المسودة. كيرندر Cinecode مسودة وكي провер الحركة انطلاقا من اللقطة الأولى، وعلو الصوت، وسهولة القراءة، والتكرار. وكتدخل حتى مراجعة من مشاهد مستقل ضمن المسار الموثق.
- طلب تعديلات مركزة. خاص الملاحظات تبدل غير المجالات اللي كتهمها، بلا ما تعاود تبني أعمال أخرى تمت الموافقة عليها.
- رندرة الفيلم النهائي. كتتصدّر النتيجة بالحجم الكامل، وكيتم إتقانها عند −14 LUFS، وكترافقها معلومات الاعتمادات لوصف الفيديو.
اختار النمط السريع ولا نمط الفيلم
النمط السريع
النمط السريع مخصص للخدمة اللي كتكون أقل تقريبا من ثلاث دقايق، خصوصا المقاطع الاجتماعية، والإعلانات، والفيديوهات المروية، والمسودات الأولى ديال الأفلام القصيرة. الخط الزمني البصري كامل كاين فملف واحد مستقل اسميتو film.html. المشاهد هي دوال زمنية وتقدر تستعمل Canvas 2D ولا three.js/WebGL.
التسلسل العادي هو حوار قصير، وبحث اختياري، وخطة مكتوبة، وجوج لقطات للمعاينة، ومسودة بنصف الحجم، حتى لجوج جولات ديال التعديلات، ثم الرندرة بالحجم الكامل. كيتصمم الصوت من النسخة الأولى ويقدر يشمل الأجواء، والمؤثرات المتزامنة، والأصوات المولدة، والموسيقى، والصدى.
نمط الفيلم
نمط الفيلم مصمم للإنتاجات الأطول، والمتعددة المشاهد، والمبنية على البحث، والمروية، أو المعتمدة على الأرشيف. كيبدا بستة أسئلة عبر ثلاث جولات قصيرة، من بعدها خارطة طريق، والسيناريو كامل، ولقطة أسلوب بجودة نهائية، ونسخة تحريكية أولية. يقدر الإنتاج يتقدم مرحلة بمرحلة مع الموافقات، أو يكمل من السيناريو الموافق عليه حتى مسودة كاملة.

كيشمل نمط الفيلم ثمانية إعدادات بصرية موثقة: الواقعية السينمائية، والأنيمي أو التحريك الخلوي، وكتاب القصص بألوان الباستيل، والتحريك بالطين، والقصاصات الورقية أو الكولاج، والريترو أو السِنثوايف أو VHS، والإشهار المصقول، والحبر اليدوي. ويقدر حتى يستخرج توجها مخصصا من الصور المرجعية.
بدا بالنمط السريع ملي كتحتاج السرعة ولا بغيتي تجرب فكرة. الإيقاعات ديالو المضبوطة زمنيا تقدر من بعد تولي خارطة الطريق لإنتاج بنمط الفيلم.
اختار الهدف من المشروع
النمط كيتحكم فمدى تعمق مسار الإنتاج. والهدف كيتحكم فنوع النتيجة اللي كيسعى المشروع يخلقها.
- فيلم سينمائي: كيعطي الأولوية للقصة، والإحساس، ولغة الكاميرا الفوتوغرافية، وطابع العدسة، وعمق المجال، والتحبب، وخمول حركة المشغل، والصوت اللي كيقوده المكان. تأثيرات الإنهاء الاختيارية بحال ضبابية الحركة، وألوان الفيلم، وحركة الشريط الجانبية كتكون معطلة افتراضيا.
- الإشهار والمنتج: كيعطي الأولوية لموضوع محدد، وهوية العلامة التجارية، وفعل تال واضح، وفحوصات المنافسين والخصوصية، ولقطات بطولية لواجهة البرامج، وتسميات الأسماء، وطباعة العلامة التجارية، ونهاية فيها دعوة لاتخاذ إجراء.
متطلبات النظام
قبل التثبيت، تأكّد بلي الحاسوب ديالك يقدر يشغّل وكيل للبرمجة بالذكاء الاصطناعي وأدوات سطر الأوامر المحلية.
- Claude Code فالتطبيق المكتبي، أو إضافة VS Code، أو فالطرفية؛ وبديلًا على ذلك Cursor Agent
- Node.js 22 ولا أحدث
- Python 3.9 ولا أحدث
- ffmpeg
- Google Chrome أو Chromium أو Edge
- بطاقة GPU يقدر Chrome يستعملها
- بضع مئات ديال الميغابايتات خاوين لوضع Quick، أو عدة جيغابايتات لكل تصيير بوضع Film
إلى كانت شي تبعية ناقصة، يقدر الوكيل يفحص الحاسوب ويقترح تثبيتها. السكريبتات ديال Cinecode كتستعمل وحدات مدمجة، بينما إصدارات مكتبة three.js المثبّتة كتتحمّل من CDN. خاص الوكيل يطلب الإذن قبل ما يثبّت أي حاجة.
الدردشة العادية ديال Claude فالويب ما كتقدرش تشغّل ffmpeg وChrome والسكريبتات المحلية فالحاسوب ديالك. استعمل Claude Code، وماشي محادثة عادية فـ claude.ai.
تثبيت Cinecode
الخيار 1: طلب تثبيتو من Claude Code
حلّ Claude Code وطلب منّو يثبّت مهارة Cinecode من المستودع:

Install the cinecode skill from https://github.com/sarpstar/cinecode
كيتم استنساخ المستودع فـ ~/.claude/skills/cinecode. فـ Windows، المكان المكافئ هو %USERPROFILE%\.claude\skills\cinecode. من بعد التثبيت، بدا محادثة جديدة باش تتعرّف المهارة بشكل صحيح.
الخيار 2: استنساخو يدويًا من أجل Claude Code
git clone https://github.com/sarpstar/cinecode.git ~/.claude/skills/cinecode
ثبّت نسخة وحدة فقط. النسخ المتعددة تقدر تخلّي الوكيل ما يعرفش شنو هي النسخة اللي خاصّو يستعمل. باش تجيب نسخة أحدث من بعد، طلب من Claude Code يحدّث Cinecode.
الخيار 3: تثبيتو من أجل Cursor
git clone https://github.com/sarpstar/cinecode.git ~/.cursor/skills/cinecode
حلّ مجلد مشروع خاوي فـ Cursor وبدا من دردشة Agent ديالو. الفحوصات ديال Cinecode، make.py وqc.py، كتبقى خدامة فـ Cursor. ولكن حواجز الحماية الخاصة بـ Claude Code، اللي كتوقّف فورًا بعض أخطاء سير العمل، ما كايناش تما.
صايب أول فيلم ديالك
1. حلّ مجلد مشروع خاوي
فالتطبيق المكتبي ديال Claude، اختار القسم Code ومن بعد اختار مجلد خاوي. فـ VS Code ولا Cursor، حلّ مجلد خاوي قبل ما تبدا دردشة الوكيل.
فجلسة Claude Code عبر الطرفية، نفّذ:
mkdir my-film
cd my-film
claude
2. قدّم الفكرة

المعلومة الوحيدة الضرورية هي الفكرة. أول طلب عملي يقدر يكون:
Let’s make a film with Cinecode.
Idea: A forgotten lighthouse remembers every ship it guided home.
Duration: 60 seconds
Destination: YouTube, 16:9
Sound: No narration; music and effects only
Appearance: Handmade ink, or suggest a better direction
ما تختارش الوضع مسبقًا إلا إلا كان عندك سبب باش تبدّل التوصية. الوكيل كيقيّم حجم المشروع وكيقترح وضع Quick ولا Film.
إلى ما كنتيش عارف المدة، أو الصيغة، أو طريقة الصوت، أو المعالجة البصرية، حيد هاد الخانات وخلي Cinecode يسولك. وبالعكس، موجز كامل فيه الإيقاعات الموقّتة، والنص، والمدة، والصيغة يقدر يمشي مباشرة نحو المسودة.
3. اختار الوضع والهدف
بالنسبة لمثال المنارة، وضع Quick مناسب حيث الفيلم غير دقيقة وحدة. اختار فيلم سينمائي إلا كان التركيز على الأجواء والقصة. وبالنسبة لإطلاق منتوج ولا شرح إعلاني لعلامة تجارية، اختار الإعلانات والمنتوج.
4. وافق على الخطة
قرا الملخص فالجملة الواحدة، والتحوّل، ولائحة الإيقاعات الموقّتة، والحوار ولا النص اللي غادي يبان فالشاشة، وتوجيهات الكاميرا، وبطاقة المخرج. تعليمات الكاميرا كتستعمل مفردات مختصرة، بحال:
dolly in, 3 s, slow ease-in-out, toward the figure
بدّل السطور المعنية بدل ما تعطي موافقة عامة ملي يكون شي قرار مهم غلط. وتقدر حتى تطلب مراجع مختلفة ولا بحث إضافي.
5. تفقد جوج مشاهد المعاينة
وضع Quick كيعرض المشهد الافتتاحي ومشهد آخر مختلف بصريًا قبل ما يبني باقي الفيلم. راقب التكوين، ولوحة الألوان، والطباعة، وتصميم الموضوع، والإضاءة، وواش الوسيط المختار باين ومفهوم.
6. راجع المسودة وبدّلها
المسودة الأولى كتترندر بنصف الحجم، مع تعطيل مؤثرات الإنهاء الاختيارية. تفرّج فيها بالصوت وجمّع الملاحظات المرتبطة فجواب واحد. وضع Quick كيدعم حتى جوج جولات موجّهة لمراجعة المسودة.

طلب مراجعة مفيد كيكون محدد ومرتبط بالوقت:
At 00:08–00:12, slow the camera move and keep the lighthouse centered.
Make the title larger for phone viewing.
Lower the music under the final sound effect.
Do not change the approved ink texture or ending.
7. ترندر ملف MP4 النهائي
من بعد الموافقة، Cinecode كيترندر بالحجم الكامل، وكيشغّل أي مؤثرات إنهاء اخترتيها، وكيعاود يدوز الفحوصات ديالو، وكيكتب الملف النهائي فالمستوى الأعلى من مجلد الفيلم باسم <title>.mp4.
الخدمة بالمراجع والوسائط الموجودة
حط مواد المراجع فمجلد refs/ ديال المشروع. Cinecode يقدر يقيس خصائص بحال مدة اللقطة، وإيقاع المونتاج، ولوحة الألوان، والإضاءة، وBPM، والعلاقة بين القطوعات والإيقاعات. ومن بعد كيبني فيلم جديد حول هاد البنية الشكلية، بلا ما ياخذ لقطات ولا موسيقى من المرجع.
تقدر حتى تزيد لقطات ديال التيبوغرافيا فـ refs/type/. الكيت كيوثّق الفونطات المفتوحة المرخّصة، اختبارات الحروف التركية، قابلية القراية فحجم التليفون، اختبارات التباين، واقتراحات ديال تنسيق الفونطات.
إلى جبتي الأغنية ديالك، قول للوكيل فين كاين الملف. Cinecode يقدر يقدّر السرعة عبر التراك كامل، يوافق القطوعات مع الموازير، يحطّ التأكيدات فوق الضربات، يصاوب فيزيوال للسطر الغنائي، وينقص الموسيقى أوتوماتيكياً منين كاين التعليق الصوتي.
اختيارات التعليق الصوتي
التعليق الصوتي اختياري. Cinecode كيعالج السرد باش يولي جزء من الفيلم، بلا ما يصدّر صوت المحرّك كيف ما هو. يقدر يعطي للصوت طابع قريب، مسجّل فشريط، منقول عبر الراديو، تحت الماء، كورالي، ولا ميكانيكي، ويحطّو داخل فضاء صوتي مناسب.
الـREADME فيه بزاف ديال أنظمة الصوت التركية الاختيارية. هادو ما كيتسطّباوش أوتوماتيكياً:
- EMA Lightning: صوت تركي واحد خدام بلا إنترنت ويقدر يخدم بالـCPU. ثبّت الدعم بهاد الأمر
python3 tools/tts.py --install ema، ومن بعد اختار المحرّكema. - تصميم الصوت التركي فـVoxCPM2: كيوفّر أصوات تقدر توصفها وسبعة ديال أساليب الراوي واجدين. كيحتاج Apple Silicon ولا كارت NVIDIA، وحوالي 3.7 GB.
- Ahenk: كيدعم خصائص بحال نبرة السؤال والتعبير على الإحساس. أوزان الموديل ديالو مرخّصة بـCC BY 4.0، وهاد الشي كيعني باللي الأفلام اللي كتستعملها خاصها تذكر Ahenk فالمصادر.
إلى ما كان حتى واحد من هاد الاختيارات المحلية، السرد يقدر يستعمل مفتاح Gemini TTS ديالك ولا يرجع مؤقتاً لصوت النظام.
نصائح متقدمة لسير العمل
- بدا بأصغر موجز مفيد. فكرة فـجملة وحدة كتخلي الوكيل يقترح تأويلات يمكن ما فكرتيش فيها. الموجز المفصّل أحسن ملي كيكون التوقيت، النص، وقواعد العلامة التجارية محددين من قبل.
- صادق على البنية قبل التلميع. صحّح التحوّل، ترتيب الضربات، الخطّاف، والنهاية فالخطة. ما تستناش حتى للرندر النهائي باش تحل مشكل فالسكريبت.
- استعمل المراجع على الشكل، ماشي للتقليد. طلب من Cinecode يحافظ على الإيقاع، منطق الإضاءة، ولا إيقاع المونتاج، مع تبديل الموضوع والمادة البصرية.
- عطي ملاحظات مراجعة مجمّعة. الوضع السريع كيسمح بجوج جولات ديال مراجعة المسودة كحد أقصى، لذلك جمع ملاحظات التوقيت، التيبوغرافيا، الصوت، والتكوين فجواب واحد.
- صمّم للوجهة النهائية. ذكر واش الفيلم مخصص للمشاهدة العمودية فـInstagram، للتسليم المربّع، ولا للتشغيل الأفقي فـYouTube. الكلمات اللي كتتقرا فالتليفون مهمة بزاف خصوصاً فالأفلام الشارحة.
- خلي مؤثرات التشطيب الاختيارية مقصودة. ضبابية الحركة، معالجة ألوان الفيلم، واهتزاز الشريط مطفّيين افتراضياً. فعّلهم غير إلا كانو كيدعمو الاتجاه المختار.
- نقل الاختبارات الواعدة لوضع Film. ورقة الإيقاع الناجحة فـQuick mode تقدر تولّي خارطة طريق أطول للإنتاج.
- حسب مساحة القرص للرندرات الطويلة. Quick mode كيدفق الإطارات مباشرة لـMP4 وكيحتاج عادة غير بضع مئات ديال الميغابايت. Film mode يقدر يحتاج عدة جيغابايت لكل مشروع أثناء الرندر.
- استعمل الإصدارات الحالية ديال Claude Code. حواجز الحماية الموثقة كتحتاج دعم للـhooks بنمط exec و
onFailure. الإصدارات القديمة يمكن ليها تبقى ترندر الأفلام، ولكن الحاجز يقدر ما يتفعّلش.
الخلاصة
Cinecode كيحوّل وكيل برمجة بالذكاء الاصطناعي لسير عمل محلي وموجّه لصناعة الأفلام، ماشي غير برومبت بسيط من النص للفيديو. ثبّت المهارة، حلّ مجلداً خاوي، وصف الفيلم، صادق على الخطة ولقطات المعاينة، ومن بعد حسّن المسودة السمعية البصرية قبل ما ترندر MP4 النهائي. بدا بمشروع قصير فـQuick mode، تعلّم مراحل المصادقة، وانتقل لـFilm mode ملي كتحتاج القصة للبحث، السرد، الأرشيف، ولا بنية أطول.
تحديثات المصدر والتثبيت متوفرة فـمستودع Cinecode على GitHub.
