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

Scribbletune ایک اوپن سورس JavaScript لائبریری اور کمانڈ لائن ٹول ہے جو پروگرامی طور پر موسیقی ترتیب دینے کے لیے استعمال ہوتا ہے۔ گرافیکل پیانو رول کے بجائے، یہ تال اور سر کی وضاحت کے لیے ایک مختصر سٹرنگ نوٹیشن استعمال کرتا ہے، جس سے کوڈ یا ٹرمینل سے براہ راست موسیقی کے خیالات پیدا کرنا ممکن ہوتا ہے۔ بنیادی تصور: پیٹرنز سٹرنگ کے طور پر لکھے جاتے ہیں جہاں `x` کا مطلب نوٹ آن ہے، `-` ایک وقفہ، `_` پچھلے نوٹ کو برقرار رکھتا ہے، `R` فراہم کردہ پول سے بے ترتیب نوٹ منتخب کرتا ہے، اور مربع بریکٹ ایک بیٹ کو تقسیم کرتے ہیں (مثال کے طور پر `[xx]` ایک بیٹ میں دو نوٹ رکھتا ہے)۔ یہ پیٹرنز نوٹ کی فہرستوں، اسکیلز، راگوں یا آرپیجیوز کے ساتھ مل کر کلپس تیار کرتے ہیں۔ لائبریری معاون افعال جیسے `scale`، `chord`، `scales`، `chords`، `arp`، `progression` اور `getChordsByProgression` فراہم کرتی ہے، جو علیحدہ harmonics پیکیج پر مبنی ہیں۔ ایک `clip()` فنکشن پیٹرنز اور نوٹس کو Node.js میں نوٹ آبجیکٹ میں تبدیل کرتا ہے، اور ایک `midi()` فنکشن نتیجہ کو معیاری MIDI فائل میں لکھتا ہے جسے Ableton Live، GarageBand یا Logic جیسے DAWs میں کھولا جا سکتا ہے۔ ایک براؤزر انٹری پوائنٹ (`scribbletune/browser`) Tone.js پر مبنی ہے۔ یہ متعدد آلات یا نمونوں کے انتظام کے لیے `Session` اور `Channel` تجریدات شامل کرتا ہے، کلپس کو آزادانہ طور پر شروع اور تبدیل کرتا ہے، اور چینلز میں کلپس کی ایک قطار شروع کرتا ہے۔ چینلز بلٹ ان Tone.js سنتھس کو نام سے، پہلے سے بنے ہوئے Tone.js آلات، ایک آڈیو نمونہ URL، ملٹی سیمپل آلات، اور اثرات کی زنجیریں استعمال کر سکتے ہیں۔ پیکیج ایک CLI بھی فراہم کرتا ہے۔ عالمی یا مقامی انسٹال کے بعد، کمانڈز جیسے `--riff`، `--chord` اور `--arp` ایک روٹ نوٹ، موڈ، تال پیٹرن، ذیلی تقسیم اور اختیارات جیسے آؤٹ پٹ فائل نام، sizzle، amplitude، accent، style اور BPM قبول کرتے ہیں۔ راگ اور آرپیجیو کمانڈز ترقیوں کو ڈگری ہندسوں، رومن ہندسوں، واضح راگ ناموں، یا کلیدی لفظ `random` کے طور پر قبول کرتے ہیں۔ پیٹرن معاونین میں تکرار کے مختصر طریقے شامل ہیں جیسے `x.repeat(4)` اور `2(x-x[xx])`۔ ترقی npm اسکرپٹس کا استعمال کرتی ہے انسٹال، ٹیسٹ، بلڈ (tsup)، لنٹ (biome) اور واچ موڈ کے لیے۔ یہ پروجیکٹ MIT لائسنس یافتہ ہے اور اس کی ایک ساتھی ویب سائٹ scribbletune.com پر موجود ہے۔