প্রকল্প সম্পর্কে

Freyr হল স্ট্রিমিং সার্ভিস থেকে মিউজিক ট্র্যাক ডাউনলোড করার একটি কমান্ড-লাইন টুল। Spotify, Apple Music বা Deezer থেকে কোনো URL বা সংক্ষিপ্ত URI দেওয়া হলে, এটি ট্র্যাক মেটাডেটা (শিরোনাম, শিল্পী, অ্যালবাম, ট্র্যাক/ডিস্ক নম্বর, প্রকাশের তারিখ, ISRC, লেবেল, কপিরাইট, কভার আর্ট এবং আরও অনেক কিছু) বের করে, তারপর YouTube Music-এর মতো অডিও উৎসে কোয়েরি করে মিলে যাওয়া অডিও খুঁজে বের করে, কাঁচা ফাইল ডাউনলোড করে, কনফিগারযোগ্য বিটরেটে (৯৬–৩২০kbps, ডিফল্ট ৩২০k) Apple AAC (.m4a) ফরম্যাটে এনকোড করে, মেটাডেটা ও অ্যালবাম আর্ট এমবেড করে এবং আউটপুট ARTIST/ALBUM/TRACK ডিরেক্টরি কাঠামোতে সাজায়। সমর্থিত কোয়েরি ধরনের মধ্যে রয়েছে ট্র্যাক, অ্যালবাম, শিল্পী এবং প্লেলিস্ট। একাধিক কোয়েরি আর্গুমেন্ট হিসেবে বা ইনপুট ফাইলের (-i/--input) মাধ্যমে দিয়ে ব্যাচ ডাউনলোড সম্ভব, যেখানে প্রতিটি লাইন একটি কোয়েরি এবং # চিহ্ন কমেন্ট নির্দেশ করে। urify সাবকমান্ড সার্ভিস URL এবং freyr-সামঞ্জস্যপূর্ণ সংক্ষিপ্ত URI-এর মধ্যে রূপান্তর করে। উল্লেখযোগ্য অপশনের মধ্যে রয়েছে বিটরেট নির্বাচন, সমবর্তী চাংক ডাউনলোড (-n/--chunks), রিট্রাই সংখ্যা, কাস্টম আউটপুট ডিরেক্টরি, বিদ্যমান ট্র্যাকের জন্য অন্যান্য ডিরেক্টরি পরীক্ষা (-D), কভার আর্টের নামকরণ ও আকার বা নিষ্ক্রিয়করণ, উৎস পছন্দের ক্রম (youtube, yt_music, বাদ দিতে ! সহ), মেটাডেটা ফিল্টার, প্রতিটি ধাপের জন্য সমবর্তিতা টিউনিং (queries, tracks, trackStage, downloader, encoder, embedder), গ্যাপলেস প্লেব্যাক ফ্ল্যাগ, ফোর্স ওভাররাইট, প্লেলিস্ট জেনারেশন (m3u8) যার সাথে ডিরেক্টরি, অ্যাপেন্ডিং, এস্কেপিং এবং নেমস্পেস প্রিফিক্সিং অপশন রয়েছে, স্টোরফ্রন্ট কান্ট্রি কোড, ট্রি অর্গানাইজেশন নিষ্ক্রিয়করণ, ক্যাশ ডিরেক্টরি নিয়ন্ত্রণ, মেমরি ক্যাশ সাইজ, নেটওয়ার্ক টাইমআউট, অথেনটিকেশন ও ব্রাউজার লঞ্চ টগল, প্রগ্রেস বার স্টাইল এবং স্পষ্ট AtomicParsley বাইনারি পাথ। ইনস্টলেশন npm (npm install -g freyr) বা Yarn, সোর্স থেকে, অথবা অফিসিয়াল Docker ইমেজের (freyrcli/freyrjs) মাধ্যমে পাওয়া যায়, যার সাথে ডকুমেন্টেড docker run কমান্ড এবং alias উদাহরণ রয়েছে। প্রয়োজনীয়তার মধ্যে রয়েছে Python >= 3.2, Node.js >= 16 এবং AtomicParsley >= 20230114। README-তে উল্লেখ করা হয়েছে যে ব্যবহারকারীর অঞ্চলে YouTube Music উপলব্ধ থাকতে হবে কারণ কাঁচা অডিও সেখান থেকে সংগ্রহ করা হয়। প্রজেক্টটি লাইসেন্সকৃত এবং এতে CI চেক, CodeFactor গ্রেডিং, npm ও Docker ডাউনলোড ব্যাজ এবং ডোনেশন লিংক অন্তর্ভুক্ত রয়েছে।