v14.0.0 Stable Release

Bring Quranic recitation to your Discord Server

An elegant, resource-optimized Discord bot that streams crystal-clear Quranic recitations. Select from 238+ reciters, configure persistent servers, and control playback dynamically.

238+
Global Reciters
99.9%
Uptime SLA
<50%
CPU overhead
Discord App Mockup - Interactive
โœจ Islamic Guild
Text Channels+
#general-chat
#quran-bot
Voice Channels+
๐Ÿ”Šquran
botAPP
mgo
#quran-bot
m
mgoToday at 3:17 AM
๐ŸŽฎmgo used/play
Quran Avatar
QuranAPPToday at 3:17 AM

๐Ÿ“– Playing Quran - Surah 23

Al-Mu'minun (ุงู„ู…ุคู…ู†ูˆู†)
๐ŸŽ™๏ธ Reciter: ู…ุญู…ุฏ ุตุฏูŠู‚ ุงู„ู…ู†ุดุงูˆูŠ (ุงู„ู…ุตุญู ุงู„ู…ุฌูˆุฏ)
20:47
50:32
StatusPlaying
Volume๐Ÿ”Š โ–ˆโ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 5%
Voice Channel๐Ÿ”Š quran
Requested By@mgo
Auto-plays next Surah when finished โ€ข Quran Bot
Message #quran-bot
โž•๐ŸŽGIF

Designed for Speed and Elegance

Quran Bot streams recitations with server-grade resource efficiency and premium interactive panels.

๐ŸŽ™๏ธ 238+ Global Reciters

Access recitations from hundreds of reciters. The bot dynamically queries style variants (Murattal, Mojawwad, Mo'lim) based on your selection.

๐Ÿ“… Friday Al-Kahf Broadcast

Schedules automated broadcasts on Friday mornings. Auto-creates voice channels, server-mutes listeners, and cleans up when finished.

โšก Direct OggOpus Transcoding

Utilizes optimized, single-threaded native FFmpeg processes to stream pre-encoded OggOpus files, reducing CPU and bandwidth overhead by up to 50%.

๐Ÿ” diacritic-Insensitive Search

Intelligent autocomplete matching that strips diacritics, supports Arabic keyboard configurations, and resolves the 25-option Discord limit.

๐ŸŽจ 2-Row Active Control Panel

A stunning, interactive player panel featuring instant Play, Pause, volume scaling, Skip, Seek (-10s / +10s), and real-time math-based progress tracking.

๐Ÿงผ Automated Cleanups

Implements connection security gates and automatic cleanups to disconnect, delete channels, and unmute users if voice rooms become empty.

Interactive Reciter Query

Select a reciter below to preview how the bot dynamically formats narration styles (Moshaf modes) inside Discord select menus:

Discord Select Menu Preview
Select a Narration Style:
๐ŸŽค Murattal (ู…ุฑุชู„)Select
๐ŸŽค Mojawwad (ู…ุฌูˆุฏ)
๐ŸŽค Al-Minshawi (ู…ู†ุดุงูˆูŠ)

Command Reference

Fully interactive slash commands database. Search or click commands below to see arguments, description, and usage examples.

Joins your voice channel and plays the selected Surah using the specified reciter (optional, supports Autocomplete).

Supports autocomplete search for both Surahs and Reciters. You can search Surahs by number (1-114), English name (e.g., 'Al-Fatihah', 'Al-Kahf'), or normalized Arabic text, and optionally search/specify a Reciter directly.

/play surah: 18 (Al-Kahf) reciter: Maher Al-Muaiqly

Search and configure your preferred reciter globally or per-server.

Enables searching from 238+ reciters. Dynamically queries available narration styles (Moshaf types like Murattal, Mojawwad, Mo'lim) and presents them in selection dropdowns.

/reciter name: Maher Al-Muaiqly

Manually starts the Surah Al-Kahf Friday broadcast in your channel.

Instantly joins the voice channel, creates a temporary channel named 'Surah Al-Kahf ๐Ÿ“–', server-mutes listeners, and broadcasts the recitation.

/kahf

Toggles the automatic Friday morning Al-Kahf broadcast (Admin-only).

Schedules a timezone-optimized (UTC+3) automatic broadcast every Friday. Sends a 10-minute warning in text channels before starting the stream.

/kahf-broadcast active: on

Pauses the currently streaming recitation.

Preserves playback position. Controls are restricted to users in the same voice channel to prevent disruption.

/pause

Resumes playback of a paused recitation.

Continues streaming seamlessly from the paused timestamp.

/resume

Adjusts playback volume dynamically in real-time.

Takes a value from 1 to 100. Updates the active player control panel embed to reflect the new volume level.

/volume level: 80

Displays system health and stream statistics.

Shows system CPU usage, active streams, database latency, and connection status.

/status

Stops playback, makes the bot leave the voice channel, and cleans resources.

Gracefully kills the FFmpeg process, deletes temporary voice channels, unmutes users, and removes button interaction states from the control panel.

/stop

Quick Setup Guide

Get the Quran Bot running in your Discord server in 3 simple steps.

1

Invite the Bot

Click the button below to authorize the Quran Bot into your Discord Server. You must have **Manage Server** permissions on that guild, and make sure to accept all permissions requested in the link.

Authorize Bot Link
2

Configure Channel Permissions

You must accept all the permissions requested in the invite link. Verify that the following role permissions are allowed in the channels where the bot will join:

โœ“ View Channels
โœ“ Manage Channels
โœ“ Manage Roles
โœ“ View Audit Log
โœ“ Send Messages
โœ“ Manage Messages
โœ“ Read Message History
โœ“ Mention Everyone
โœ“ Send Voice Messages
โœ“ Use Slash Commands
โœ“ Connect
โœ“ Speak
โœ“ Mute Members
โœ“ Use Voice Activity
โœ“ Use External Sounds
โœ“ Set Voice Channel Status
3

Start Playing Quran

Join a voice channel and type the slash command below in your server chat to select a Surah and start streaming recitation instantly:

/play surah: 18 (Al-Kahf)