> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# وثائق Youka

> أدلة ومرجع لإنشاء فيديوهات كاريوكي باستخدام تطبيق Youka على الويب، وتطبيق سطح المكتب، وواجهة سطر الأوامر CLI، وواجهة API، وSDK

يحوّل Youka أي أغنية إلى فيديو كاريوكي. يغطي هذا الموقع كل طرق استخدامه — بالنقر داخل تطبيق الويب أو تطبيق سطح المكتب، أو بالأتمتة من سطر الأوامر، أو بتضمينه داخل منتجك عبر واجهتَي API وSDK.

## ما هو Youka؟

يقوم Youka بفصل الغناء عن أي ملف صوتي أو URL، ويزامن كلمات الأغنية كلمةً بكلمة، ويعرض فيديو كاريوكي نهائيًا يمكنك تعديله وتصديره ومشاركته. تتوفر نفس السلسلة في المتصفح وعلى سطح المكتب وعبر API عامة.

## أي خيار ينبغي أن أستخدم؟

<Columns cols={2}>
  <Card title="Web App" icon="globe" href="/ar/web">
    أنشئ وعدّل الكاريوكي داخل متصفحك. الأفضل للحالات السريعة لمرة واحدة،
    ولعمليات العمل المعتمدة على المتصفح، ولمحرر Studio.
  </Card>

  <Card title="Desktop App" icon="display" href="/ar/desktop">
    ثبّت Youka على جهازك. الأفضل لإنشاء الكاريوكي من الملفات أو
    URLs، وللتحرير باستخدام اختصارات لوحة المفاتيح، ولتصدير MP4 محليًا.
  </Card>

  <Card title="CLI" icon="terminal" href="/ar/cli">
    أتمت السلسلة كاملة من خلال السكربتات. الأفضل للمهام الدفعية وعمليات
    الرندر المحلية.
  </Card>

  <Card title="SDK" icon="code" href="/ar/sdk">
    استدعِ Youka من Node.js أو Bun. الأفضل لبناء ميزات الكاريوكي داخل
    منتجك.
  </Card>

  <Card title="API" icon="server" href="/ar/api">
    استدعِ REST API العامة من أي لغة. الأفضل لعمليات
    التكامل بين الخدمات.
  </Card>

  <Card title="AI Agents" icon="robot" href="/ar/agents">
    قواعد التشغيل وأنماط سير العمل للوكلاء الذين يقودون Youka
    تلقائيًا.
  </Card>
</Columns>

## جديد على Youka؟

<Steps>
  <Step title="اختر الواجهة التي تناسبك">
    يبدأ معظم المستخدمين لأول مرة باستخدام [تطبيق الويب](/ar/web/create-karaoke). إذا
    كنت تريد سير عمل مُثبّتًا، فابدأ بـ[تطبيق سطح المكتب
    app](/ar/desktop/youtube-to-karaoke). عادةً ما يبدأ المطورون بـ
    [CLI](/ar/cli).
  </Step>

  <Step title="أنشئ أول كاريوكي لك">
    ارفع ملفًا أو ألصق URL. يقوم Youka بفصل المسارات، ومزامنة الكلمات، ثم
    يعرض معاينة.
  </Step>

  <Step title="خصّص المظهر">
    اختر خلفية، واضبط نمط الترجمة، وقصّ الأغنية.
  </Step>

  <Step title="تصدير">
    نزّل الفيديو النهائي أو شارك رابط تشغيل.
  </Step>
</Steps>

## أدلة شائعة

* [أنشئ أول كاريوكي لك (web)](/ar/web/create-karaoke) — ارفع أغنية وصدّر خلال دقائق
* [استخدام محرر Studio](/ar/web/using-studio) — حرّر الكلمات والتوقيت والتخطيط والتنسيق في المتصفح
* [تحويل URL فيديو إلى كاريوكي](/ar/desktop/youtube-to-karaoke) — حوّل أي فيديو على الإنترنت إلى مسار كاريوكي
* [إصلاح مزامنة الكلمات](/ar/desktop/fix-lyrics-sync) — حلول عندما يكون التوقيت غير دقيق
* [بدء سريع لـ CLI](/ar/cli) — أتمت السلسلة كاملة من الطرفية
* [بدء سريع لـ SDK](/ar/sdk/quickstart) — أنشئ مشروعًا من Node.js ببضعة أسطر