منصوبے کے بارے میں

# html-video **HTML ویڈیو بن جاتا ہے — آپ کے لیپ ٹاپ پر۔** html-video ایک پروگرامیٹک ویڈیو ٹول ہے جو کوڈنگ ایجنٹس (Open Design، Windsurf CLI، Trae CLI، Claude Code، Cursor، Codex، Gemini، Grok، Qwen، OpenCode، Copilot، Aider، Hermes، یا Anthropic API) کو HTML، CSS اور ڈیٹا کو حقیقی MP4 فائلوں میں تبدیل کرنے دیتا ہے۔ ویڈیو بیان کریں، آرٹیکل لنک یا GitHub ریپو پیسٹ کریں، اور ایجنٹ ایک ملٹی فریم اینیمیٹڈ ویڈیو تیار کرتا ہے، جو پلگ ایبل انجنوں کے ساتھ مقامی طور پر رینڈر ہوتی ہے۔ Apache-2.0 لائسنس، کوئی فی رینڈر فیس نہیں، کوئی وینڈر لاک ان نہیں۔ ## اہم خصوصیات - **14 ایجنٹ بیک اینڈز**: خودکار طور پر Open Design (Vela)، Windsurf CLI، Trae CLI، Claude Code، Cursor Agent، Codex CLI، Gemini CLI، Grok Build، Qwen Code، OpenCode، GitHub Copilot CLI، Aider، Hermes اور Anthropic Messages API کو سپورٹ کرتا ہے۔ - **21 کیوریٹڈ ٹیمپلیٹس**: لائسنس کلین، اینیمیٹڈ HTML ٹیمپلیٹس جو ڈیٹا ویژولائزیشن (NYT طرز کے چارٹس، Swiss/Vignelli گرڈز)، ٹائٹلز اور VFX (glitch، kinetic type، typewriter cursor)، ہیروز اور سنیمیٹکس (liquid gradients، light-leak، warm grain)، پروڈکٹ پروموز (15s/30s ملٹی سین) اور ایکسپلینر اسکیفولڈز (decision trees) کا احاطہ کرتے ہیں۔ - **حقیقی MP4 رینڈرنگ**: Headless Chromium اینیمیٹڈ HTML ریکارڈ کرتا ہے، ffmpeg (libx264) مقامی طور پر MP4 میں انکوڈ کرتا ہے — کوئی کلاؤڈ رینڈر نہیں، کوئی فی کلپ فیس نہیں۔ - **لنک ٹو ویڈیو**: ویب آرٹیکلز (بشمول WeChat 公众号) یا GitHub ریپوز سرور سائیڈ سے لاتا ہے، مارک ڈاؤن میں فلیٹ کرتا ہے، اور جنریشن پرامپٹ میں حقیقی مواد فیڈ کرتا ہے۔ - **AI ساؤنڈ ٹریک**: MiniMax کے ذریعے اختیاری بیک گراؤنڈ میوزک اور وائس اوور، ایکسپورٹ پر MP4 میں مکس کیا جاتا ہے (میوزک وائس کے نیچے، fade-in/out)۔ - **اسٹوڈیو + CLI**: ایک لوکل براؤزر اسٹوڈیو (چیٹ، ٹیمپلیٹ گیلری، فریمز، ساؤنڈ ٹریک، ایکسپورٹ) اور اسکرپٹ ایبل `html-video` CLI۔ - **پلگ ایبل انجن آرکیٹیکچر**: ایک `render(input, ctx)` اڈاپٹر انٹرفیس؛ انجن تبدیل کرنا (مثلاً Remotion، Motion Canvas) صرف رینڈر مرحلہ بدلتا ہے، اسٹوری بورڈ اور ایجنٹ لوپ کو چھوڑ کر۔ - **تعمیر کے لحاظ سے لائسنس کلین**: ٹیمپلیٹس اصل لائسنس رکھتے ہیں، `NOTICE.md` میں ذرائع اور SPDX درج ہیں؛ کوئی غیر واضح پرمیسیو لائسنس شامل نہیں۔ ## یہ کیسے کام کرتا ہے 1. **سورس فیچ**: اسٹوڈیو URL یا ریپو سرور سائیڈ سے کھینچتا ہے، مارک ڈاؤن میں فلیٹ کرتا ہے۔ 2. **ایجنٹ لوپ**: ایجنٹ مواد + ٹیمپلیٹ اسٹائل پڑھتا ہے، ایک مواد گراف (اسٹوری بورڈ) + ہر فریم کے لیے ایک HTML بلاک خارج کرتا ہے۔ 3. **مواد گراف**: ملٹی فریم IR جس میں نوڈس (entity/data/text) اور ایجز (sequence/transition) ہیں۔ 4. **فی فریم HTML**: ہر نوڈ ڈسک پر ایک خود ساختہ اینیمیٹڈ HTML فریم بن جاتا ہے۔ 5. **رینڈر**: ہر فریم → webm (headless Chromium کے ذریعے)، پھر ffmpeg MP4 (libx264) میں انکوڈ کرتا ہے اور جوڑتا ہے۔ 6. **ساؤنڈ ٹریک**: اختیاری MiniMax میوزک + وائس اوور ffmpeg کے ذریعے مکس کیا جاتا ہے۔ سنگل فریم ویڈیوز مواد گراف کو چھوڑ کر تیز راستہ اختیار کرتی ہیں۔ ## شروع کرنا Node.js 20+ اور ffmpeg درکار ہے۔ اگر موجود نہ ہو تو Playwright کا Chromium انسٹال کریں۔ `pnpm -r build` کے ساتھ بلڈ کریں۔ CLI یوٹیلیٹیز: - `node packages/cli/dist/bin.js doctor` — انسٹال شدہ ایجنٹس + انجنز کا پتہ لگائیں - `node packages/cli/dist/bin.js search-templates --intent "github stars race" --top 3` اسٹوڈیو میں: ایک ٹیمپلیٹ منتخب کریں (یا ویڈیو بیان کریں / لنک پیسٹ کریں)، اپنے ایجنٹ سے چیٹ کریں، فی فریم ٹیکسٹ ایڈٹ کریں، ساؤنڈ ٹریک شامل کریں، اور MP4 ایکسپورٹ کریں۔ ## پروجیکٹ کا ڈھانچہ - `runtime/` — تمام 14 بیک اینڈز کے لیے ایجنٹ رن ٹائم (detect/spawn/stream) - `cli/` — `html-video` کمانڈ، اسٹوڈیو HTTP سرور، سورس فیچنگ - `project-studio/` — براؤزر اسٹوڈیو UI (چیٹ، ٹیمپلیٹ گیلری، فریمز، ساؤنڈ ٹریک، ایکسپورٹ) - `templates/` — 21 کیوریٹڈ، لائسنس کلین ویڈیو ٹیمپلیٹس ## متعلقہ پروجیکٹس - [Open Design](https://github.com/nexu-io/open-design) — سسٹر پروجیکٹ، ڈیزائن ایجنٹ میٹا لیئر - [HTML Anything](https://github.com/nexu-io/html-anything) — سٹیٹک HTML ڈیلیوریبلز کے لیے سسٹر پروجیکٹ ## لائسنس Apache-2.0 — کوئی فی رینڈر فیس نہیں، کوئی سیٹ کیپ نہیں، کوئی کنٹریبیوٹر معاہدہ نہیں۔ Open Design ٹیم (nexu-io) کا ایک آفیشل پروجیکٹ۔