Claude Code · مؤثرات صوتية · Openverse + earshot

Claude ممتاز بالموشن والمونتاج… بس المؤثرات الصوتية سيئة: أداتين مجانيتين بتصلّحانها

المشكلة مش إنه Claude ما بيعرف يحط صوت؛ المشكلة إنه ما بيسمع. الأداة الأولى (Openverse) بتعطيه مكتبة مؤثرات مفتوحة الترخيص بيدوّر فيها وبينزّل لحاله. الثانية (earshot) بتعطيه أذنين: بتسمع المونتاج، بتلاقي اللحظة اللي بدها صوت، وإذا ما لقت الصوت المناسب بتصنعه بالكود. هون الرابطين، التركيب الحرفي من ملفات المستودعات، وطريقة ربطهم بـ Claude Code، وبرومت يخلّيه يصوّت ريلك كامل.

ليش مؤثرات Claude سيئة؟

لما تطلب من Claude Code يحط مؤثرات على مونتاج، هو بيتعامل مع ملفات ما بيسمعها: بيحط whoosh على كل قطع لأنه «هيك المفروض»، بيختار أول ملف بيلاقيه، وبيحطه بمستوى صوت عشوائي. النتيجة اللي بتسمعها: مؤثرات كتير، بالمكان الغلط، وأعلى من الكلام.

بدون أداتينClaude بيخمّن: مؤثر على كل قطع، من أي ملف، بأي مستوى. وما بيعرف إذا الصوت اللي حطه رخيص.
مع Openverse + earshotبيدوّر بمكتبة مرخّصة، بيسمع المونتاج وبيلاقي اللحظات اللي فعلاً بدها صوت، بيقيّم المؤثر قبل ما يحطه، وإذا ما لقى المناسب بيصنعه.
01
Openverse
مكتبة صوتيات وصور مرخّصة CC أو ملكية عامة، مع API مجاني.
02
earshot
أداة بتحوّل الصوت لمعلومات الوكيل بيقدر يحكم عليها. 3,200+ نجمة بأسبوعين.
03
Claude Code
بيربط الاثنين: بيسمع، بيدوّر، بينزّل، بيحط بالفريم الصح.
Openverse

المكتبة. ببلاش، وبرخصة بتقدر تنشر فيها.

1

Openverse: مكتبة المؤثرات المفتوحة

الموقع: openverse.org · المستودع: github.com/WordPress/openverse · توثيق الـ API: api.openverse.org/v1/.

محرك بحث مفتوح المصدر (من مشروع WordPress) لوسائط مرخّصة Creative Commons أو ملكية عامة: صور وصوتيات. الـ API مجاني، وبيشتغل بدون تسجيل بحدود أقل، والتسجيل (مجاني) بيرفع الحدود.

شو بدككيف
تبحث عن مؤثرGET https://api.openverse.org/v1/audio/?q=whoosh: بيرجّع قائمة فيها رابط الملف والرخصة والمصدر
بدون تسجيلبيشتغل مباشرة، بحدود أقل على عدد الطلبات وعدد الصفحات
بتسجيل (مجاني)POST /v1/auth_tokens/register/ بالاسم والإيميل، تأكيد الإيميل، وبعدها /v1/auth_tokens/token/ بيعطيك توكن تحطه بـ Authorization: Bearer
الرخصةكل نتيجة معها الرخصة: CC0 وملكية عامة بدون شروط؛ CC BY بدها ذكر المصدر بوصف الفيديو
المستودع الصح: WordPress/openverse (المستودع الموحّد الشغّال). المستودع القديم WordPress/openverse-api مؤرشف من 2023؛ لو لقيته بأي شرح، تجاهله.
2

خلّي Claude Code يدوّر وينزّل لحاله

ما بدك أي تركيب: Claude Code بيعرف يطلب من API. افتحه بمجلد مشروع الريل والصق:

بدي مؤثرات صوتية من Openverse (التوثيق: https://api.openverse.org/v1/ والبحث على /v1/audio/?q=...). دوّر على: whoosh قصير، click ناعم، pop خفيف. لكل واحد نزّل أفضل 3 نتائج (أقصر من ثانيتين، ترخيص CC0 أو CC BY) بمجلد sfx/، وسمّيها باسم المؤثر. اكتب ملف sfx/LICENSES.md فيه لكل ملف: المصدر، صاحب العمل، والرخصة بالضبط، عشان أذكرهم بوصف الفيديو. إذا طلع خطأ 429 (حد الطلبات) استنى وأعد المحاولة، أو اسألني إذا بدي أسجّل تطبيق.
  • «أقصر من ثانيتين»: المؤثر الطويل بيصير موسيقى. للريلز بدك ضربات قصيرة.
  • «CC0 أو CC BY»: رخص بتسمح بالنشر التجاري. تجنّب NC (غير تجاري) إذا الريل لعميل أو فيه إعلان.
  • ملف الرخص: هو اللي بيحميك. CC BY بدها سطر «الصوت: اسم، المصدر، CC BY 4.0» بالوصف.
earshot

الأذنين. بتشتغل على جهازك بدون كرت شاشة.

3

earshot: أذنين لـ Claude

الرابط: github.com/Leonxlnx/earshot (MIT، أُنشئ 2026-10-15، أكثر من 3,200 نجمة يوم 2026-10-30). الشعار: «Ears for coding agents». بتشتغل على المعالج بس (بدون GPU)، وبدها Python 3.10 أو أحدث وffmpeg.

describe
شو هاد الصوت؟ وصف بيقدر الوكيل يقرأه.
timeline
أحداث الصوت مع الوقت.هون بيعرف وين القطعات واللحظات اللي بدها مؤثر.
sheet
صورة مشروحة للصوت بيقرأها الوكيل كصورة.
rank · match · find
يرتّب مؤثرات حسب قربها من وصف، أو يلاقي الأقرب لتسجيل حقيقي.هون بيختار الأحسن من نتائج Openverse بدل أول ملف.
forge
يصنع مؤثر بالكود ويحسّنه بناقد بيسمع ويقارن بتسجيلات حقيقية.لما ما يلاقي الصوت المناسب.
kit
طقم أصوات كامل لفيديو، موزّع على الأدوار.
mcp
يشغّل MCP server عشان Claude Code يستعمل كل اللي فوق مباشرة.

وفي أوامر تانية (compare، realness، critique، measure، sfx، gallery…) بالـ README.

4

التركيب وربط الـ MCP بـ Claude Code

التركيب من المستودع (ما في حزمة pip install earshot: الحزمة اللي بهالاسم على PyPI مشروع تاني لا علاقة إله). الأوامر حرفياً من الـ README:

Mac / Linux

git clone https://github.com/Leonxlnx/earshot && cd earshot python -m venv .venv .venv/bin/python -m pip install torch --index-url https://download.pytorch.org/whl/cpu .venv/bin/python -m pip install -e ".[mcp,llm,dev]" .venv/bin/python -m earshot doctor --load

Windows (نفس الأوامر، بس المسار .venv\Scripts\python)

git clone https://github.com/Leonxlnx/earshot ; cd earshot python -m venv .venv .venv\Scripts\python -m pip install torch --index-url https://download.pytorch.org/whl/cpu .venv\Scripts\python -m pip install -e ".[mcp,llm,dev]" .venv\Scripts\python -m earshot doctor --load
  • doctor --load بيفحص التثبيت وبيحمّل النماذج. أول استعمال بينزّل حوالي 1.1 GB (نموذجين صوت). بدك تنزّلهم من هلأ؟ earshot doctor --fetch.
  • ffmpeg لازم يكون مثبّت ومعروف بالـ PATH. على Mac: brew install ffmpeg، على Windows: winget install Gyan.FFmpeg.

ربطه بـ Claude Code (MCP)

سطر واحد، بدّل المسار بمكان المجلد عندك:

Mac / Linux

claude mcp add earshot --scope user -e EARSHOT_THREADS=3 -- /path/to/earshot/.venv/bin/python -m earshot mcp

Windows

claude mcp add earshot --scope user -e EARSHOT_THREADS=3 -- C:\path\to\earshot\.venv\Scripts\python.exe -m earshot mcp
  • --scope user: متاح بكل مشاريعك. بدون هاد بيكون للمجلد الحالي بس.
  • تأكد: افتح Claude Code واكتب /mcp؛ لازم تشوف earshot متصل. أو claude mcp list من الطرفية.
  • بديل: ملف .mcp.json بمجلد المشروع بنفس الأمر (الـ README فيه المثال).
5

صوّت ريلك كامل: البرومت

بعد ما الـ MCP متصل، افتح Claude Code بمجلد الريل (فيه reel.mp4 ومجلد sfx/ من القسم 2) والصق:

اسمع reel.mp4 بـ earshot (timeline + sheet) ولاقي اللحظات اللي بدها مؤثر: القطعات الكبيرة، ظهور نص على الشاشة، والحركات المفاجئة. ما تحط مؤثر على كل قطع؛ أقصى 6 مؤثرات بالريل، ولا مؤثر بأول ثانية. لكل لحظة: اختار الأقرب من مجلد sfx/ (استعمل rank)، وإذا ما في مناسب اصنع واحد بـ forge. حط كل مؤثر بالفريم الصح، بمستوى تحت الكلام بـ 12 لـ 15 dB، واطلعلي reel-sfx.mp4 وجدول: الوقت، المؤثر، المصدر، المستوى. اعرضلي الجدول قبل ما ترندر.

ما لقى الصوت المناسب؟ هيك بيصنعه (الأمر حرفياً من الـ README):

earshot forge whoosh --target "a fast crisp air whoosh" --alts "a wind gust" "a sword swing" \ --refs path/to/real/whooshes/ --mode real --dir made/whoosh
  • --target: وصف الصوت اللي بدك ياه. --alts: أوصاف لازم يبعد عنها. --refs: تسجيلات حقيقية بيقارن فيها الناقد.
  • earshot forge --list بيعرض أنواع المؤثرات اللي بيعرف يصنعها.
  • الـ refs من Openverse: نزّل 5 whoosh حقيقية بالقسم 2 وحطها بمجلد refs/. هيك المصنوع بيقرب من الحقيقي.
قبل ما تضغط رندر

الأدوات بتعطيك الصوت الصح. القاعدة بتعطيك المكان الصح.

6

القاعدة الذهبية وأخطاء المونتاج «الصامت»

صوت واحد بالمكان الصح أحسن من عشرة بالمكان الغلط.

مؤثر على كل قطعالريل بيصير «ووش ووش ووش». الناس بتحس بالمونتاج بدل ما تحس بالقصة.
مؤثر على القطعات الكبيرة بستغيير مشهد، ظهور رقم، حركة مفاجئة. 4 لـ 6 بالريل.
المؤثر أعلى من الكلامبيغطّي الكلمة، والمشاهد بيرجع ثانيتين.
تحت الكلام بـ 12 لـ 15 dBبينحس ولا بينتبه إله. earshot بيقيس المستوى بـ measure.
مؤثر بأول ثانيةالصوت المفاجئ بأول الريل بيقرأ كإعلان، والناس بتسحب.
الثانية الأولى صوتك أو صمتأول مؤثر مع أول قطع، مش قبله.
أول ملف بيلاقيهwhoosh رخيص من 2009 بجودة 64kbps.
rank من 3 مرشحينearshot بيرتّب حسب القرب من الوصف ومن التسجيلات الحقيقية. وإذا كلهم سيئين: forge.
بدون ذكر المصدرمؤثر CC BY بدون سطر بالوصف.
ملف LICENSES.mdمن القسم 2، وسطر بالوصف لكل مؤثر CC BY.
?

أسئلة شائعة

بدي GPU لـ earshot؟
لا، بتشتغل على المعالج بس (النماذج بتنزّل بنسخة CPU). لابتوب عادي بيكفي؛ تحليل ريل 30 ثانية بياخد ثواني لدقيقة.
بتشتغل مع Remotion أو مع أي أداة مونتاج؟
earshot بتشتغل على ملف الفيديو أو الصوت، أي كان مصدره. مع Remotion بتعطيك توقيت الكلام والقطعات، وClaude بيحط المؤثرات بالكود. الريل بالكود كامل بـ دليل برومت الريل.
Openverse فيها موسيقى كمان؟
فيها مقاطع صوتية متنوعة بينها موسيقى، بس للموسيقى الخلفية بتلاقي مكتبات أكبر. قوّتها بالمؤثرات القصيرة والأصوات المحيطة، ورخصها واضحة.
في أداة ثالثة بالريل الأصلي؟
بالنسخة الإنجليزية من هالفكرة في أداة ثالثة لتسجيل مؤثرات حقيقية. ما قدرت أتحقق منها وقت التسجيل، فخلّيت الريل والدليل على أداتين متأكد منهم. earshot نفسها فيها أمر realness بيقيّم قديش الصوت حقيقي.
الـ MCP ما ظهر بـ /mcp؟
جرّب الأمر بالطرفية لحاله: /path/to/earshot/.venv/bin/python -m earshot mcp. إذا طلع خطأ، غالباً المسار غلط أو التركيب ما كمّل (أعد doctor --load). وتأكد إنك فتحت جلسة Claude Code جديدة بعد الإضافة.
✓ تم النسخ

Get the next guide first

Leave your email and new guides reach you as soon as they are out. No spam.

Your email stays with me, and you can ask me to delete it any time.