گانے کی ریکارڈنگ کو بجانے کے قابل پانچ حصوں کے بینڈ اسکور میں تبدیل کریں

آڈیو سے بینڈ اسکور کیا ہے؟

آڈیو سے بینڈ اسکور ایک ایجنٹ اسکل ہے جو مکمل گانے کی ریکارڈنگ کو پانچ رکنی اسکول بینڈ کے لیے ایک عملی ارینجمنٹ میں تبدیل کرتا ہے۔ خام اسٹیمز پیش کرنے یا خودکار MIDI شناخت کو مکمل نقل سمجھنے کے بجائے، یہ ایجنٹ کو سورس علیحدگی، موسیقی کے تجزیے، سازوں کی تفویض، نوٹیشن، معیار کی جانچ، اور MuseScore ایکسپورٹ کے مراحل سے گزارتا ہے۔

معیاری ورک فلو ریہرسل کے لیے تیار تین فائلیں تیار کرتا ہے: پلے بیک یا DAW معائنے کے لیے MIDI فائل، پرنٹ کے قابل PDF اسکور، اور قابلِ تدوین مقامی MuseScore MSCZ فائل۔

اہم: یہ منصوبہ ایک ایجنٹ اسکل ہے، خودمختار ڈیسک ٹاپ ایپلیکیشن نہیں۔ آپ کو ریپوزٹری کو کسی مطابقت رکھنے والے ایجنٹ رن ٹائم کے لیے دستیاب کرنا ہوگا اور مطلوبہ مقامی آڈیو اور نوٹیشن ٹولز فراہم کرنے ہوں گے۔

ارینجمنٹ ورک فلو کیسے کام کرتا ہے

یہ اسکل ایک مرحلہ وار عمل کی پیروی کرتا ہے:

مکس شدہ ریکارڈنگ
    → وقت کے مطابق ہم آہنگ سورس علیحدگی
    → بیٹ، حصے، ہارمونی اور نوٹ کے ممکنہ امیدواروں کا تجزیہ
    → سازوں کی تفویض اور بجانے کے قابل بنانے والی ترامیم
    → 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 پر work/audio-env/Scripts/ کے اندر موجود Python اور ایکٹیویشن ایگزیکیوٹیبلز استعمال کریں۔ انہیں انسٹال کرنے سے پہلے تصدیق کریں کہ پیکیجز آپ کے کمپیوٹر پر انسٹال Python انٹرپریٹر کے ساتھ مطابقت رکھتے ہیں۔

3. بیرونی تقاضے انسٹال کریں

• FFmpeg: آڈیو ڈی کوڈنگ کے لیے ضروری ہے۔ یہ آپ کے آپریٹنگ سسٹم، واضح طور پر فراہم کردہ --ffmpeg پاتھ، یا imageio-ffmpeg سے حاصل کیا جا سکتا ہے۔
• MuseScore Studio: نوٹیشن کھولنے اور MIDI اور PDF فائلیں ایکسپورٹ کرنے کے لیے ضروری ہے۔
• اختیاری تجزیاتی ٹولز: کام کے لحاظ سے آپ librosa، basic-pitch، pretty_midi، mido، music21، pypdf یا Poppler استعمال کر سکتے ہیں۔
• CUDA: اختیاری ہے۔ اگر مطابقت رکھنے والا GPU دستیاب نہ ہو تو علیحدگی کا ورک فلو 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.

ایک مفید درخواست میں ان پٹ فائل، سازوں، بجانے والے کی سطح، اور اہم ترین موسیقی کی خصوصیات کی نشاندہی ہونی چاہیے۔ اگر قابل اطلاق ہو تو مطلوبہ کلید، گٹار یا باس کی ٹیوننگ، ارینجمنٹ کی لمبائی، کٹوتیوں، دہرائے گئے حصوں، یا کارکردگی سے متعلق دیگر پابندیوں کی بھی وضاحت کریں۔

Source Separation براہِ راست چلائیں

جب آپ ارینجمنٹ مکمل کرنے سے پہلے تجزیاتی اسٹیمز کا معائنہ یا تیاری کرنا چاہیں تو source-separation مددگار کو آزادانہ طور پر چلایا جا سکتا ہے:

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

high پروفائل چار-source اور چھ-source دونوں Demucs تجزیے چلاتا ہے تاکہ ان کے شواہد کا موازنہ کیا جا سکے۔ balanced پروفائل صرف چھ-source تجزیہ چلاتا ہے اور اندرونی آزمائشوں یا محدود وسائل والے سسٹمز کے لیے موزوں ہے۔

آؤٹ پٹ ڈائریکٹری نئی ہونی چاہیے۔ مددگار جان بوجھ کر موجودہ ڈائریکٹری کو اوور رائٹ کرنے سے انکار کرتا ہے، جس سے سابقہ اسٹیمز اور تجزیاتی شواہد محفوظ رہتے ہیں۔ ہر رن کے لیے 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 جانچ کرتا ہے، جس میں pitch، string، اور fret کے باہمی تعلقات شامل ہیں۔ یہ تکنیکی عدم مطابقتوں کی نشاندہی کر سکتا ہے، لیکن یہ ثابت نہیں کرتا کہ ہر نوٹ، beat، articulation، یا مشترکہ سازاتی حصہ موسیقانہ طور پر درست ہے۔

MIDI، PDF، اور MSCZ ایکسپورٹ کریں

تمام فارمیٹس ایک ہی native 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 قابلِ تدوین native MuseScore پروجیکٹ فراہم کرتا ہے۔

ورکنگ ڈائریکٹریز میں manifest.json، الگ کیے گئے WAV اسٹیمز، تجزیاتی نوٹس، MIDI امیدوار، MusicXML، آڈٹ رپورٹس، اور رینڈر کیے گئے PDF صفحات بھی ہو سکتے ہیں۔ یہ فائلیں شواہد اور کوالٹی اشورنس کے لیے ہوتی ہیں، جب تک صارف انہیں ڈیلیوری ایبلز کے طور پر طلب نہ کرے۔

بہتر نتائج کے لیے اعلیٰ درجے کی تجاویز

درست ارینجمنٹ بریف لکھیں

گانے کو نقل کرنے کے لیے صرف عمومی درخواست پر انحصار نہ کریں۔ بتائیں کہ نتیجہ کون پیش کرے گا اور وہ کیا بجا سکتے ہیں۔ مثال کے طور پر ابتدائی سطح کے چارٹ اور اعلیٰ درجے کے چارٹ میں فرق واضح کریں، غیر معیاری ٹیوننگ بتائیں، اور ان riffs یا transitions کی نشاندہی کریں جنہیں قابلِ شناخت رہنا ضروری ہے۔

الگ کیے گئے اسٹیمز کو شواہد سمجھیں

guitar یا piano کے نام سے لیبل کیے گئے چھ-source آؤٹ پٹس امیدوار ہوتے ہیں، الگ کیے گئے سازوں کی ضمانت شدہ نمائندگی نہیں۔ گٹار اسٹیم کو خودکار طور پر ایک مکمل گٹار پارٹ نہ سمجھیں، اور یہ اس بات کا ثبوت نہیں کہ دو آزاد گٹار پارٹس موجود ہیں۔ امیدواروں کو اصل مکس، دہرائے گئے حصوں، ہارمونک سیاق، ردھم، اور ساز کی مخصوص حدود کے مقابل جانچیں۔

ٹائم لائن کی مطابقت برقرار رکھیں

ورک فلو اسٹیمز کو مشترکہ ٹائم لائن پر رکھتا ہے اور ان کے sample rates، channel layouts، اور frame counts کی جانچ کرتا ہے۔ انفرادی اسٹیمز کو دستی طور پر trim یا shift کرنے سے گریز کریں، الا یہ کہ آپ source recording کے ساتھ ان کی alignment بھی برقرار رکھیں۔

ورژن شدہ ورکنگ ڈائریکٹریز استعمال کریں

چونکہ separation اور export مددگار موجودہ ڈائریکٹریز کو اوور رائٹ کرنے سے انکار کرتے ہیں، اس لیے separation-v1، separation-v2، export-v1، اور export-v2 جیسے نام استعمال کریں۔ اس سے پروفائل سیٹنگز کا موازنہ کرنا اور سابقہ کوششوں کے شواہد محفوظ رکھنا بھی آسان ہوتا ہے۔

خودکار جانچ کے بعد اسکور کا موسیقانہ جائزہ لیں

کامیاب آڈٹ منتخب ساختی اور notation خصوصیات کی تصدیق کرتا ہے، موسیقانہ کمال کی نہیں۔ MIDI سنیں، PDF کا معائنہ کریں، MSCZ فائل MuseScore میں کھولیں، اور تصدیق کریں کہ ensemble کے لیے entrances، transitions، repeats، گٹار fingerings، keyboard textures، bass motion، اور drum fills عملی ہیں۔

ایک مستند اسکور ماخذ برقرار رکھیں

حتمی اصلاحات native MSCZ اسکور میں کریں، پھر اسی فائل سے MIDI اور PDF دوبارہ تیار کریں۔ ایکسپورٹ کیے گئے فارمیٹس میں الگ الگ ترمیم کرنے سے تینوں ڈیلیوری ایبلز میں اختلاف پیدا ہو سکتا ہے۔

ٹیسٹ سوٹ چلائیں

ریپوزٹری کے root سے شامل کردہ ٹیسٹس چلائیں:

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

ٹیسٹس separation کے edge cases، محدود model-download retries، timeline validation، TAB pitch اور string checks، ساختی score checks، اور export safeguards کا احاطہ کرتے ہیں۔ ان کا پاس ہونا اس بات کی تصدیق کرتا ہے کہ مددگار ورک فلو توقع کے مطابق کام کرتا ہے؛ یہ transcription accuracy یا arrangement quality کی پیمائش نہیں کرتا۔

حدود اور ذمہ دارانہ استعمال

• یہ منصوبہ غلطی سے پاک نقل نویسی یا مکمل آڈیو وفاداری کا دعویٰ نہیں کرتا۔
• خودکار جانچ موسیقی سننے اور نوٹیشن کے جائزے کا متبادل نہیں بن سکتی۔
• یہ ورک فلو تقریر کو متن میں تبدیل کرنے، گیت کے بولوں کا ترجمہ کرنے یا اسکور ڈاؤن لوڈ کرنے کی سہولت فراہم نہیں کرتا۔
• ماڈل کے وزن ریپوزٹری میں شامل نہیں ہیں اور ضرورت پڑنے پر ڈاؤن لوڈ کیے جا سکتے ہیں۔
• ریپوزٹری میں فی الحال منصوبے کی سطح کی کوئی لائسنس فائل موجود نہیں، اس لیے یہ فرض نہ کریں کہ اس کے کوڈ یا اثاثے دوبارہ تقسیم کیے جا سکتے ہیں۔
• فریقِ ثالث کے ٹولز، ماڈلز، ڈیٹاسیٹس اور ریکارڈنگز اپنے الگ لائسنس اور استعمال کی شرائط کے تابع رہتے ہیں۔

صرف ان ریکارڈنگز اور حوالہ جاتی مواد پر کارروائی کریں جنہیں استعمال کرنے کا آپ کو حق حاصل ہے۔ نجی ریکارڈنگز، اسناد، ماڈل کیشز، تیار کردہ Python کیشز یا بڑی عارضی فائلوں کو ریپوزٹری میں شامل نہ کریں۔

نتیجہ

Audio to Band Score ایک ملی جلی ریکارڈنگ سے قابلِ تدوین، ریہرسل پر مرکوز پانچ حصوں والی ترتیب تک پہنچنے کا منظم طریقہ فراہم کرتا ہے۔ اس کی اصل قدر مکمل طور پر خودکار نقل نویسی میں نہیں، بلکہ ماخذ کی علیحدگی کے شواہد، واضح موسیقی کے فیصلوں، بجانے کی سہولت پر مرکوز ترتیب، ساختی جانچ اور یکساں MuseScore برآمدات کے امتزاج میں ہے۔ قابلِ اعتماد نتائج کے لیے ایجنٹ کو واضح ہدایات دیں، تجزیے کے شواہد محفوظ رکھیں، آڈٹ اور ٹیسٹ چلائیں، اور آخر میں انسانی موسیقی کا جائزہ مکمل کریں۔