omartood/somali-quran-audio

A comprehensive Node.js SDK for accessing Somali Quran resources including recitation audio, Somali translations, and tafsir audio playlists with intelligent caching. # 🕌 Somali Quran Audio SDK A comprehensive Node.js SDK for accessing Somali Quran resources including recitation audio, Somali translations, and tafsir audio playlists with intelligent caching. ## 🌟 **Live Demo - See It Working!** _Beautiful Arabic text rendering with Somali translations_ _Audio playback with multiple reciters_ _Somali tafsir audio playlists_ ### 🚀 **Try It Right Now!** ```bash # Install and test immediately npm install somali-quran-audio # Get Somali translation for Al-Fatiha npx somali-quran-audio ayah 1 1 # List audio files for Mishary Al-Afasy npx somali-quran-audio chapters 7 ``` **Live Example Output:** ```json { "result": { "sura": "1", "aya": "1", "arabic_text": "بِسۡمِ ٱللَّهِ ٱلرَّحۡمَٰنِ ٱلرَّحِيمِ", "translation": "1. Waxaan Ku billaabi Magaca Alle, Naxariistaha (Naxariis guud ahaaneed), Naxariista badan." } } ``` ## 🎯 **Real-Time Examples** ### 📖 Get Ayat al-Kursi in Somali ```bash npx somali-quran-audio ayah 2 255 ``` ```json { "result": { "sura": "2", "aya": "255", "arabic_text": "ٱللَّهُ لَآ إِلَٰهَ إِلَّا هُوَ ٱلۡحَيُّ ٱلۡقَيُّومُۚ...", "translation": "255. Allaah! Ma jiro Ilaah (xaq lagu caabudo) aan Isaga ahayn, waa Weligi Noolaha, Daryeelaha iyo Maamulaha waxa uunka jira..." } } ``` ### 🎵 Get Audio for First Page of Quran ```bash npx somali-quran-audio page 1 7 ``` ```json { "audio_files": [ { "verse_key": "1:1", "url": "Alafasy/mp3/001001.mp3" }, { "verse_key": "1:2", "url": "Alafasy/mp3/001002.mp3" } ] } ``` ### 🎧 Get Somali Tafsir Playlist ```bash npx somali-quran-audio tafsir Cuz01SomaliAudioQuranTranslation_201601 ``` ```json [ "archive.org", "archive.org" ] ``` ## 💻 **Code Examples That Work** ### Simple Node.js Script ```javascript // test-somali-quran.js const { somaliAyah, listChapterAudio } = …