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

# Astra Astra ایک ڈیسک ٹاپ میوزک پلیئر ہے جو ان لوگوں کے لیے بنایا گیا ہے جو اپنی مقامی میوزک لائبریری رکھتے ہیں۔ یہ FLAC، MP3، WAV، OGG، AAC، M4A، OPUS، WMA، AIFF، ALAC، APE، اور WavPack جیسے فارمیٹس کو مقامی طور پر چلاتا ہے، اور دیگر فارمیٹس کے لیے FFmpeg فال بیک استعمال کرتا ہے۔ پری بفرنگ کے ساتھ گیپ لیس پلے بیک البمز کو بغیر کسی رکاوٹ کے چلانے کو یقینی بناتا ہے۔ ## اہم خصوصیات - **بٹ پرفیکٹ آؤٹ پٹ**: OS مکسر کو نظرانداز کرتے ہوئے براہ راست ہارڈویئر تک رسائی، Windows پر WASAPI Exclusive، macOS پر CoreAudio HAL، اور Linux پر ALSA hw کے ذریعے۔ - **اسپیشل آڈیو**: مقامی IAMF/Eclipsa Audio پلے بیک، جو اسے سپورٹ کرنے والا پہلا عام مقصد والا ڈیسک ٹاپ میوزک لائبریری پلیئر ہے۔ Atmos-مطابقت رکھنے والے ہارڈویئر کی ضرورت کے بغیر Dolby Atmos ملٹی چینل ڈی کوڈنگ شامل ہے۔ اس میں فی چینل معائنہ، ریمپنگ، آؤٹ پٹ تاخیر کیلیبریشن، اور لائیو بائنورل رینڈرنگ کے ساتھ 3D اسپیکر پلیسمنٹ کے لیے ورچوئل اسپیکر روم شامل ہے۔ - **Parallax**: مقامی نیٹ ورک پر مختلف مشینوں کے درمیان ہم آہنگ ملٹی روم پلے بیک۔ ایک ہوسٹ پلے بیک کو کنٹرول کرتا ہے؛ دوسرے PIN پیئرنگ اور فی اسپیکر تاخیر ٹیوننگ کے ساتھ اسپیکر کے طور پر شامل ہوتے ہیں۔ آپٹ ان اور تجرباتی۔ - **ویژولائزر**: سات ریئل ٹائم ویژولائزر جو مقامی C++ ماڈیول سے چلتے ہیں، جن میں آسکلوسکوپ، اسپیکٹرم اینالائزر، اور ویکٹرسکوپ شامل ہیں۔ ڈریگ اینڈ ریزائز لے آؤٹ اور پری سیٹس کے ساتھ حسب ضرورت اسکوپ ریک۔ - **ایکویلائزر**: 20 تک مکمل طور پر پیرامیٹرک بینڈز، اسپیکٹرم اوورلے کے ساتھ لائیو فریکوئنسی رسپانس گراف، بلٹ ان پری سیٹس، اور AutoEQ ہیڈ فون کیلیبریشن پروفائل امپورٹ۔ - **لائبریری مینجمنٹ**: میٹا ڈیٹا نکالنا، البم آرٹ ورک، آرٹسٹ/البم/ٹریک کے ذریعے تلاش کے ساتھ براؤزنگ، ID3v2.4 اور Vorbis Comments سپورٹ، ملٹی آرٹسٹ ٹیگ پارسنگ، حسب ضرورت آرٹسٹ امیجز، .lrc فائل اسکیننگ، فیورٹس، حالیہ چلائے گئے ٹریکنگ، اور بلٹ ان میٹا ڈیٹا ایڈیٹر۔ - **Astra Resolve**: لائبریری کے سیاق و سباق کا استعمال کرتے ہوئے سنگل آرٹسٹ کریڈٹس کو تعاون سے ممتاز کرتا ہے، فائلوں کو دوبارہ لکھے بغیر یا بیرونی میٹا ڈیٹا سے پوچھ گچھ کیے بغیر آرٹسٹ لنکس کو درست رکھتا ہے۔ - **آڈیو سیٹنگز**: آؤٹ پٹ ڈیوائس سلیکشن، ReplayGain لاؤڈنس نارملائزیشن، فی چینل ریمپنگ، اور وائرلیس/بلوٹوتھ اسپیکرز کے لیے تاخیر کیلیبریشن۔ - **انٹرفیس**: ویو فارم سیک بار، ایمبیئنٹ اسپیکٹرم بیک ڈراپ کے ساتھ فل اسکرین موڈ، منی پلیئر، آٹو اسکرول کے ساتھ ہم آہنگ بول (ایمبیڈڈ بول، .lrc فائلوں، یا LRCLIB سے)، اور پاپ آؤٹ بول پینل۔ - **اسکروبنگ**: Last.fm، AudioScrobbler، اور ListenBrainz کے لیے بلٹ ان سپورٹ، نیز حسب ضرورت اسکروبلر پروفائلز اور متعدد سروسز پر ملٹی اسکروب۔ - **انٹیگریشنز**: اختیاری Discord Rich Presence اور سیلف ہوسٹڈ میڈیا سرور سپورٹ (Jellyfin، Subsonic-مطابقت رکھنے والے سرورز جیسے Navidrome، Airsonic، Gonic، Funkwhale)۔ - **Astra API**: اختیاری کمپینین API جس میں بیرونی ٹولز کے لیے بیئرر تصدیق ہے تاکہ پلے بیک کو دیکھ/کنٹرول کر سکیں، تلاش کر سکیں، کیو اور فیورٹس کا انتظام کر سکیں۔ /v1 اور /v2 کنٹریکٹس کو سپورٹ کرتا ہے۔ - **تجرباتی خصوصیات**: PWA فون کنٹرولر، لائبریری انٹیگریٹی اسکینر، گراف ویژولائزیشن، ایمبیئنٹ سٹیریو ٹو ملٹی چینل اپ مکس، 5×5 گرڈ ایکٹیویٹی انڈیکیٹر، اور کنٹرولر سپورٹ (Xbox/PlayStation)۔ ## ڈاؤن لوڈ اور انسٹالیشن Windows، macOS، اور Linux کے لیے پری بلٹ بائنریز Releases صفحہ پر دستیاب ہیں۔ AUR (`astra-music-bin`) اور Windows `winget install Boof2015.Astra` کے ذریعے بھی دستیاب ہے۔ کمیونٹی کے زیر انتظام پیکجز میں AUR سورس اور Fedora/RPM کے لیے TerraPKG شامل ہیں۔ ## سورس سے تعمیر Node.js 18+، npm، اور C++ کمپائلر ٹول چین درکار ہے۔ ریپو کلون کریں، `npm install` چلائیں (جو مقامی ویژولائزر ماڈیول مرتب کرتا ہے)، پھر پیکیجنگ کے لیے `npm run dev`، `npm run build`، یا `npm run dist` استعمال کریں۔ ## دستاویزات اور سپورٹ تفصیلی تکنیکی دستاویزات Wiki میں ہیں۔ پروجیکٹ GPL v3.0 لائسنس یافتہ ہے اور Ko-fi کے ذریعے ترقی کی حمایت کرتا ہے۔