متطلبات النظام
تعمل الأداة على Windows وMac وLinux. قبل التثبيت، تأكد من توافر المتطلبات التالية:
Windows 10 / 11
مدعوم أيضاً على macOS 12+ وUbuntu 20.04+. Windows هو الأسهل للإعداد.
Python 3.10+
مطلوب لتشغيل واجهة الويب Streamlit وجميع معالجات الخلفية. يُنصح بـ Python 3.11.
4 جيجابايت RAM على الأقل
يُنصح بـ 8 جيجابايت لأداء سلس عند إنشاء مقاطع فيديو أطول بمشاهد متعددة.
FFmpeg
مطلوب لتجميع الفيديو وعرض الترجمة. يجب أن يكون في PATH الخاص بنظامك. مجاني للتحميل.
ImageMagick
مطلوب لعرض نص الترجمة المنسّق على إطارات الفيديو. ثبّته بالإعدادات الافتراضية.
مفتاح Pexels API مجاني
سجّل في pexels.com/api — الخطة المجانية تتيح عمليات بحث وتحميل غير محدودة للاستخدام الشخصي.
الإعداد والتثبيت
اتّبع هذه الخطوات الأربع لتثبيت الأداة وتشغيلها على جهازك:
استنساخ المستودع
افتح الطرفية في المجلد الذي تريد تثبيت الأداة فيه وشغّل:
# Contact TechVisionEra to get started with the AI video generator tool
python -m venv venv
venv\Scripts\activate # Windows
pip install -r requirements.txt
إعداد config.toml
انسخ config.example.toml إلى config.toml في جذر المشروع. عيّن مزوّد LLM — Pollinations AI مهيّأ مسبقاً ولا يحتاج مفتاح API:
# config.toml
[app]
llm_provider = "pollinations"
[pollinations]
model = "mistral"
إضافة مفتاح Pexels API
في config.toml، الصق مفتاح Pexels API المجاني. هذا يتيح تحميل مقاطع الفيديو التلقائي لكل مشهد:
[pexels]
api_key = "مفتاح_PEXELS_المجاني_هنا"
تشغيل واجهة الويب
شغّل واجهة Streamlit وافتح متصفحك على localhost:8501:
venv\Scripts\python main.py
venv\Scripts\streamlit run webui\Main.py --browser.gatherUsageStats false
كتابة نصك مع علامات المشهد للمستوى 3
يولّد الذكاء الاصطناعي نصاً كاملاً من موضوعك، لكن يمكنك تعزيز دقة المقاطع بتضمين علامات المشهد في أي مكان في النص. تُكتب العلامات داخل أقواس مربعة وتخبر النظام بالضبط ما يجب البحث عنه في Pexels لكل جملة.
قاعدة مهمة: تُحذف علامات المشهد من السرد قبل تحويل النص إلى كلام، لذا لن تُنطق أبداً. تؤثر فقط على مقاطع الفيديو التي يتم البحث عنها.
مثال على نص بعلامات المشهد (فيديو Fractify AI)
تصبح كل علامة مضمّنة مصطلح بحث في Pexels. تحمّل الأداة أفضل مقطع مطابق، تقصّه ليناسب مدة الجملة، وتجمع الفيديو النهائي بالتسلسل.
اختيار المستويات البصرية
تتراكم ثلاثة مستويات من التحكم البصري فوق بعضها. يمكنك استخدام الثلاثة في آنٍ واحد للتحكم الأقصى.
المستوى 1 — خيارات أسلوب اللقطة
| اسم الأسلوب | مسبقة البحث في Pexels | الأنسب لـ |
|---|---|---|
| جوي سينمائي | cinematic aerial |
السفر، العقارات، المناظر الطبيعية |
| قريب دراماتيكي | close up dramatic |
عروض المنتجات، الطب، القصص العاطفية |
| زاوية عريضة احترافية | wide angle professional |
الشركات، المكاتب، الهندسة المعمارية |
| وثائقي | documentary |
التعليم، الأخبار، المحتوى الواقعي |
| لقطة زمنية | time lapse |
حياة المدينة، الطبيعة، التقدم في البناء |
| حركة بطيئة | slow motion |
الرياضة، اللحظات الدرامية، عروض المنتجات |
المستوى 2 — خيارات تدرج الألوان
| اسم التدرج | التأثير | الأنسب لـ |
|---|---|---|
| عادي | بدون فلتر | الأغراض العامة، مطابقة المقاطع الأصلية |
| شريط سينمائي | أشرطة سوداء + تدرج أزرق-برتقالي خفيف | أسلوب فيلمي، مقاطع العلامات التجارية المميزة |
| ذهبي دافئ | رفع أصفر-برتقالي في الظلال | الأسلوب الحياتي، السفر، الطعام، العافية |
| أزرق بارد | انزياح أزرق-تيل عبر المنتصف | التقنية، الطب، المؤسسات، المال |
| داكن كئيب | سواد معمّق، تشبع خافت في المنتصف | الدراما، الأمن، الفخامة، الإثارة |
نمط علامة المشهد في المستوى 3
ضع علامات المشهد في أي مكان بنصك باستخدام هذا النمط بالضبط:
تُحذف العلامة قبل تحويل النص إلى كلام. تصبح الجملة المتبقية هي التعليق الصوتي لذلك المقطع. يمكن أن تظهر علامات متعددة في فقرة واحدة — كل جملة بعلامة تحصل على مقطعها الخاص.
دليل الأصوات العربية
يدعم الأداة عبر Edge TTS 22 نوعاً من اللهجات العربية. هذه هي الأصوات الـ 8 الأكثر استخداماً في إنتاج الفيديو، تغطي جميع مناطق الوطن العربي الرئيسية:
| اسم الصوت | اللهجة | الجنس | الأنسب لـ |
|---|---|---|---|
ar-SA-HamedNeural |
المملكة العربية السعودية | ذكر | رسمي، تعليمي، مؤسسي — وصول عربي واسع |
ar-SA-ZariyahNeural |
المملكة العربية السعودية | أنثى | سرد رسمي، أسلوب إخباري، جمهور خليجي |
ar-EG-SalmaNeural |
مصر | أنثى | تحادثي، تسويق، وسائل التواصل الاجتماعي |
ar-EG-ShakirNeural |
مصر | ذكر | قصص، مقاطع شرح، وصول واسع |
ar-AE-FatimaNeural |
الإمارات | أنثى | العلامات الفاخرة، التقنية، محتوى خليجي |
ar-AE-HamdanNeural |
الإمارات | ذكر | الأعمال، المال، المؤسسات الخليجية |
ar-JO-SanaNeural |
الأردن | أنثى | التعليم، جمهور الشام، نبرة هادئة |
ar-MA-MounaNeural |
المغرب | أنثى | محتوى شمال أفريقيا / المغرب العربي |
توصية: للمحتوى الموجّه لجميع العرب (عربي عام)، استخدم ar-SA-HamedNeural (ذكر) أو ar-EG-SalmaNeural (أنثى). العربية السعودية والمصرية لهما أوسع نطاق فهم في جميع أنحاء العالم العربي.
دليل الإعدادات المسبقة للعلامات التجارية
هيّأت TechVisionEra أربعة إعدادات مسبقة مدمجة للعلامات التجارية. يؤدي اختيار إعداد مسبق في واجهة المستخدم إلى ملء جميع حقول العلامة التجارية تلقائياً — لون الترجمة ونص العلامة المائية والموسيقى الخلفية ومحتوى بطاقة الختام — بنقرة واحدة.
| العلامة التجارية | العلامة المائية | لون الترجمة | أسلوب الموسيقى | نص الختام |
|---|---|---|---|---|
| Fractify AI | fractify.net | #38bdf8 (أزرق بارد) | تقنية هادئة | "تشخيص ذكاء اصطناعي — fractify.net" |
| TechVisionEra | techvisionera.com | #00b619 (أخضر) | مؤسسي نشيط | "النمو الرقمي — techvisionera.com" |
| Study Malaysia | studymalaysia.tv | #38bdf8 (أزرق سماوي) | إلهامي | "الدراسة في ماليزيا — studymalaysia.tv" |
| Vetta Engineering | vetta.techvisionera.com | #fce057 (أصفر) | صناعي دراماتيكي | "حلول هندسية — vetta.techvisionera.com" |
إعداد علامة تجارية مخصصة
لإضافة علامتك التجارية الخاصة، حرّر config.toml تحت قسم [brand_presets]. يقبل كل إعداد مسبق الحقول التالية: