z7pz / discord-quran-bot

A Discord bot that can play Qur'an recitations in voice chat.

Quran bot

A simple bot that can play recitations of surahs, ayahs and mushaf pages from the Qur'an in voice chat, along with a live audio stream from Makkah. It currently supports 120+ reciters.

📌 Features

• Plays ayah, surah and page (/play)
• Supports 120+ reciters
• Accepts arabic reciter names (thanks to arabic2franko)
• Islamic prayertimes (/prayertimes)
• Reading the quran (/mushaf)
• Live quran radio (/live)
• Check out /help command to see the full list!

🪄 Easy Deploy

• Heroku
• Replit (Soon)

⚙️ Setup (Advanced)

1. Download the zip file and extract it
2. Go inside quran-bot folder
3. Create a file named .env or rename .env.example
4. Put the following to .env file:

DISCORD_TOKEN=your-discord-token-here

4. Open the terminal and do the following:

$ npm install
$ npm start

5. That's it! open an issue if you need help!

🔌 Sources

• mp3quran.net for the surah recitations, ayah recitations and Qur'an radio.
• everyayah.com for the page recitations.
• haramain.info for the live Makkah audio.

📝 License

Refer to the LICENSE file.