حوّل تسجيل أغنية لنوتة قابلة للعزف لفرقة من خمسة أجزاء

شنو هو Audio to Band Score؟

Audio to Band Score هي مهارة ديال وكيل كتبدّل تسجيل ديال أغنية واجد لترتيب عملي لفرقة مدرسية فيها خمسة ديال العازفين. عوض ما تقدّم المسارات الخام ولا تعتبر التعرّف الآلي على MIDI تفريغ نهائي، كتوجّه الوكيل عبر فصل المصادر، والتحليل الموسيقي، وتوزيع الآلات، والتدوين، وفحوصات الجودة، والتصدير من MuseScore.

الطريقة العادية كتنتج ثلاثة ديال الملفات واجدين للتدريب: ملف MIDI للتشغيل ولا الفحص فـ DAW، وملف PDF قابل للطباعة، وملف MSCZ أصلي قابل للتعديل ديال MuseScore.

مهم: هاد المشروع مهارة ديال وكيل، وماشي تطبيق مستقل لسطح المكتب. خاصك توفّر المستودع لبيئة تشغيل متوافقة مع الوكيل، وتوفّر أدوات الصوت والتدوين المحلية المطلوبة.

كيفاش كتخدم طريقة ترتيب الأغنية

المهارة كتتبع واحد المسار على مراحل:

التسجيل المخلّط
    → فصل المصادر مع الحفاظ على التزامن الزمني
    → تحليل النبض، والأقسام، والهارموني، والمرشحين ديال النوطات
    → توزيع الآلات وتعديلات قابلية العزف
    → التدوين فـ MuseScore
    → تدقيق البنية وفحوصات بصرية وفحوصات الملفات
    → MIDI + PDF + MSCZ قابل للتعديل

المبدأ اللي كيوجّه هاد العملية هو الوفاء القابل للعزف. الهدف هو الحفاظ على بنية التسجيل، والحركة الهارمونية، والغروف، والريفات اللي ساهل يتعرف عليها المستمع، والانتقالات المهمة، مع تبسيط ولا إعادة توزيع التفاصيل اللي غادي تكون صعيبة على العازفين المطلوبين.

المزايا الرئيسية

• كتفصل التسجيل المخلّط لمسارات تحليل متزامنة زمنياً باستعمال Demucs.
• كتقدر تقارن بين نتائج الفصل من أربعة مصادر ومن ستة مصادر.
• كتحلل الأقسام، والسرعات المحتملة، والمقامات الإيقاعية، والهارموني، وحركة الباص، والريفات، والملءات، ونقط الدخول الموسيقية.
• كتوزع المادة بين الغيتار الرئيسي، والغيتار الإيقاعي، والباص، والكلافيي، والدرامز.
• كتدعم مستويات صعوبة المبتدئين، والمتوسط المدرسي الهاوي، والمتقدم.
• كتنشئ تدوين MuseScore منظم وقابل للتعديل، عوض ما تسلّم ناتج التعرّف بلا تعديل.
• كتفحص بنية السكور، والعلاقات بين النوطات والأوتار فـ TAB المختار، وسلامة التصدير، وتناسق الملفات.
• كتستعمل الأدوات المحلية والمجانية بشكل افتراضي عوض رفع الصوت لواجهة API خارجية مؤدى عنها.

التوزيع الافتراضي ديال خمسة ديال الآلات

السكور الافتراضي هو مرافقة للمغني، ولكن الخط الصوتي ما كيتضمنش فالسكور الآلي إلا إلا تبدّل الطلب هاد السلوك. المسار الصوتي كيتستعمل بدلاً من ذلك باش يتحددو بنية الأغنية، ومساحات التنفس، ونقط دخول الآلات.

• الغيتار الرئيسي: TAB إيقاعي بستة أوتار للريفات المميزة، والهوكات، والملءات، والمواضيع الآلية.
• الغيتار الإيقاعي: TAB إيقاعي بستة أوتار للكوردات، والضربات، والأربيجات، ودعم الغروف.
• الباص: TAB إيقاعي بأربعة أوتار لحركة الجذور، والانتقالات، والحركة فالطبقات المنخفضة.
• الكلافيي: تدوين على المدرجين للهارموني، والبادات، والخطوط المضادة، والجمل الخاصة بالكلافيي.
• الدرامز: تدوين قياسي للدرامز على خمسة خطوط للغروف، والتأكيدات، والانتقالات، والملءات.

التوزيع المطلوب، والدوزان، والمقام، والصعوبة، والمدة، وقيود الترتيب عندها الأولوية على هاد الإعدادات الافتراضية.

التثبيت والإعداد المحلي

1. نسخ المستودع

git clone https://github.com/kiri603/To-Sheet-Music-Skill.git
cd To-Sheet-Music-Skill

2. إنشاء بيئة Python

Python 3.11 هي النسخة الموصى بها كأساس للتوافق. أنشئ بيئة افتراضية مخصصة باش ما يتداخلوش Demucs والحزم المساندة مع مشاريع Python الأخرى.

python3.11 -m venv work/audio-env
source work/audio-env/bin/activate
python -m pip install demucs numpy soundfile imageio-ffmpeg

فـ Windows، استعمل برامج Python والتفعيل الموجودة داخل work/audio-env/Scripts/. تأكد باللي الحزم متوافقة مع مفسّر Python المثبّت فالحاسوب ديالك قبل ما تثبتها.

3. تثبيت المتطلبات الخارجية

• FFmpeg: ضروري لفك ترميز الصوت. يقدر يجي من نظام التشغيل ديالك، ولا من مسار --ffmpeg كتحددو بشكل صريح، ولا من imageio-ffmpeg.
• MuseScore Studio: ضروري لفتح التدوين وتصدير ملفات MIDI وPDF.
• أدوات التحليل الاختيارية: حسب المهمة، تقدر تستعمل librosa، أو basic-pitch، أو pretty_midi، أو mido، أو music21، أو pypdf، أو Poppler.
• CUDA: اختيارية. مسار الفصل يقدر يخدم بالمعالج CPU إلا ما كانتش كاينة وحدة معالجة رسومية متوافقة.

المستودع ما كيثبتش البرامج أوتوماتيكياً وما كيضمّنش أوزان النماذج. أوزان النماذج المطلوبة كيتحمّلو من طرف البيئة المحلية ملي كيكونو ضروريين.

4. إتاحة المهارة للوكيل

المهارة منظمة حول SKILL.md وagents/openai.yaml. زِد المستودع لبيئة تشغيل الوكيل ولا وفّرو ليها حسب طريقة تحميل المهارات الخاصة بهاد البيئة. حيث بيئات التشغيل مختلفة، المستودع ما كيحددش أمر تثبيت موحّد لهاد الخطوة.

الاستعمال الأساسي: طلب ترتيب

منين كتولي المهارة متاحة، عطِ الوكيل التسجيل الأصلي وطلب واضح ديال الترتيب. مثلاً:

Use $audio-to-band-score to arrange "song.wav" for lead guitar, rhythm guitar,
bass, keyboard, and drums at the default school-amateur intermediate level.
Preserve the original song structure and recognizable riffs, then deliver MIDI,
PDF, and editable MSCZ files.

الطلب المفيد خاصّو يحدّد ملف الإدخال، والآلات المستعملة فالقياس، ومستوى العازف، والخصائص الموسيقية اللي كتهمّ بزاف. إلا كان مناسب، حدّد حتى السلم المطلوب، وضبط الغيتار ولا الباص، وطول التوزيع، والمقاطع المحيّدة، والأقسام المعاودة، ولا أي قيود أخرى مرتبطة بالأداء.

شغّل فصل المصادر مباشرة

يمكن تشغيل أداة المساعدة ديال فصل المصادر بوحدها ملي بغيتي تفحص ولا تجهّز المسارات المفصولة للتحليل قبل ما تكمل التوزيع:

python scripts/separate_audio.py \
  --input "path/to/song.wav" \
  --out-dir "work/separation-v1" \
  --profile high \
  --device auto

البروفايل high كيشغّل تحليلات Demucs بأربعة وبستة مصادر باش يمكن تقارن الأدلة ديالهم. أما البروفايل balanced كيشغّل غير تحليل الستة مصادر، ومخصّص للتجارب الداخلية ولا للأنظمة اللي الموارد ديالها محدودة.

خاص مجلد الإخراج يكون جديد. أداة المساعدة كترفض عمداً الكتابة فوق مجلد موجود، وهادشي كيحمي المسارات المفصولة وأدلة التحليل السابقة. استعمل مسار فيه رقم النسخة بحال work/separation-v1 ولا work/separation-v2 فكل تشغيل.

دير تدقيق لملف MuseScore مكتمل

من بعد ما ينشئ الوكيل الملف work/final.mscz، شغّل أداة التدقيق قبل ما تصدّر الملفات النهائية:

python scripts/score_tools.py audit \
  --score "work/final.mscz" \
  --report "work/audit.json"

التدقيق كيدير فحوصات بنيوية وفحوصات مختارة ديال TAB، من بينها العلاقات بين النغمة والوتر والـfret. يقدر يلقا التناقضات التقنية، ولكن ما كيضمنش أن كل نغمة، ولا ضربة، ولا تعبير أدائي، ولا مقطع موسيقي مشترك بين الآلات صحيح موسيقياً.

صدّر MIDI وPDF وMSCZ

صدّر جميع الصيغ من نفس ملف MuseScore الأصلي باش تبقى النسخ القابلة للطبع والتشغيل والتعديل متطابقة:

python scripts/score_tools.py export \
  --score "work/final.mscz" \
  --out-dir "work/export-v1" \
  --name "song_band" \
  --musescore "/path/to/MuseScore"

أداة التصدير ما كتكتبش فوق مجلد إخراج موجود. كتنشر المجلد الجديد غير من بعد ما كتتولّد الصيغ الثلاث المطلوبة بنجاح.

• song_band.mid كيوفّر التشغيل والفحص عبر DAW ولا MIDI.
• song_band.pdf كيوفّر نوتة قابلة للطبع للتداريب.
• song_band.mscz كيوفّر مشروع MuseScore أصلي قابل للتعديل.

مجلدات الخدمة تقدر تحتوي حتى على manifest.json، ومسارات WAV مفصولة، وملاحظات التحليل، ومرشحين بصيغة MIDI، وMusicXML، وتقارير التدقيق، وصفحات PDF مرندرة. هاد الملفات كتعتبر أدلة وملفات لضمان الجودة، إلا طلبها المستخدم كملفات نهائية.

نصائح متقدمة لنتائج أحسن

كتب مذكرة دقيقة للتوزيع

ما تعتمدش غير على طلب عام باش تفرّغ أغنية. وضّح شكون غادي يعزف النتيجة وشنو كيقدر يعزف. مثلاً، فرّق بين نوتة للمبتدئين ووحدة متقدمة، حدّد الضبط غير الاعتيادي، وبيّن الريفات ولا الانتقالات اللي خاصها تبقى معروفة.

اعتبر المسارات المفصولة أدلة

المخرجات ديال الستة مصادر اللي مكتوب عليها guitar ولا piano غير مرشحين، وماشي آلات معزولة مضمونة. ما خاصش يتفسّر مسار الغيتار تلقائياً على أنه جزء كامل ديال غيتار واحد، وما كيثبتش حتى أن كاينين جوج أجزاء مستقلين ديال الغيتار. قارن المرشحين مع الميكس الأصلي، والأقسام المعاودة، والسياق الهارموني، والإيقاع، والقيود الخاصة بكل آلة.

حافظ على اتساق الخط الزمني

سير العمل كيخلي المسارات فوق خط زمني مشترك وكيตรวจّ معدلات أخذ العينات، وتوزيعات القنوات، وعدد الإطارات ديالها. تجنّب تقليم ولا تحريك المسارات بشكل منفصل إلا حافظتي حتى على التوافق ديالها مع التسجيل الأصلي.

استعمل مجلدات خدمة مرقّمة

حيت أدوات الفصل والتصدير كترفض الكتابة فوق المجلدات الموجودة، استعمل أسماء بحال separation-v1 وseparation-v2 وexport-v1 وexport-v2. هادشي كيسهّل حتى مقارنة إعدادات البروفايلات والاحتفاظ بالأدلة ديال المحاولات السابقة.

راجع النوتة موسيقياً من بعد الفحوصات الآلية

التدقيق الناجح كيتحقق من بعض الخصائص البنيوية وخصائص الكتابة الموسيقية، وماشي من الكمال الموسيقي. سمع الـMIDI، وفحص الـPDF، وحلّ ملف MSCZ فـMuseScore، وتأكد أن الدخولات، والانتقالات، والإعادات، وترقيمات أصابع الغيتار، وقوامات الكلافيي، وحركة الباص، وملءات الطبول عملية ومناسبة للفرقة.

خلي مصدر واحد معتمد للنوتة

دير التصحيحات النهائية فالنوتة الأصلية بصيغة MSCZ، ومن بعد عاود ولّد MIDI وPDF من نفس الملف. التعديل فالصيغ المصدّرة بشكل مستقل يقدر يخلّي الملفات النهائية الثلاثة ما متطابقاش.

شغّل مجموعة الاختبارات

شغّل الاختبارات المرفقة من جذر المستودع:

python -m unittest discover -s scripts -p "test_*.py" -v

الاختبارات كتغطّي الحالات الخاصة بفصل المصادر، وإعادات تحميل النماذج بعدد محدود من المحاولات، والتحقق من الخط الزمني، وفحوصات نغمة ووتر TAB، والفحوصات البنيوية للنوتة، ووسائل الحماية ديال التصدير. النجاح فيها كيأكد أن سير عمل أدوات المساعدة كيتصرف كما هو متوقع؛ وما كيقيسش دقة التفريغ ولا جودة التوزيع.

القيود والاستعمال المسؤول

• المشروع ما كيدّعيش بلي التفريغ خالي من الأخطاء ولا بلي الصوت محافظ على الجودة ديالو كاملة.
• الفحوصات الآلية ما كتقدرش تعوّض الاستماع الموسيقي ومراجعة التدوين.
• سير العمل ما كيوفّرش تحويل الكلام لنص، ولا ترجمة الكلمات، ولا تحميل النوتة الموسيقية.
• أوزان النماذج ما مدموجاش فالمستودع، وقد يتم تحميلها عند الطلب.
• المستودع ما فيهش حاليا ملف ترخيص على مستوى المشروع، لذلك ما تفترضش بلي الكود ولا الأصول ديالو مسموح بإعادة توزيعها.
• الأدوات والنماذج ومجموعات البيانات والتسجيلات ديال الجهات الخارجية كيبقاو خاضعين للتراخيص وشروط الاستعمال ديالهم.

عالج غير التسجيلات والمواد المرجعية اللي عندك الحق تستعملها. ما ترفعش للمستودع تسجيلات خاصة، ولا بيانات الولوج، ولا ذاكرة النماذج المؤقتة، ولا ملفات Python المؤقتة المُولَّدة، ولا الملفات المؤقتة الكبيرة.

الخلاصة

Audio to Band Score كيوفّر مسارا منظما من تسجيل مختلط حتى لتوزيع قابل للتعديل وموجّه للتداريب، مكوّن من خمسة أجزاء. القيمة الرئيسية ديالو ماشي فالتفريغ الآلي الكامل، ولكن فالجمع بين معطيات فصل المصادر، والقرارات الموسيقية الواضحة، والتوزيع اللي كيركّز على قابلية العزف، والفحوصات البنيوية، وتصديرات MuseScore المتسقة. باش تحصل على نتائج موثوقة، عطِ الوكيل موجزا دقيقا، واحتافظ بأدلة التحليل، ودير التدقيق والاختبارات، وسالي بمراجعة موسيقية بشرية.