Advanced Quran & Islamic Companion
Built for Stability
Stream high-quality Quran recitations, manage Islamic radio, automate daily azkar, track prayer times, and maintain persistent voice states. Engineered with automatic recovery, memory optimization, and role-based controls.
24/7 Recitation Stream
Watch on YouTubeLive Quran recitation stream sourced from YouTube All rights belong to the original creator
Complete Feature Set
Every tool your server needs for a seamless spiritual experience
Quran Recitations
Access 114 surahs from verified reciters with accurate duration tracking. Supports page-based navigation, reciter switching, and instant playback.
- 50+ verified reciters
- Surah & ayah navigation
- Duration preview & tracking
Islamic Radio Streams
Toggle between Quran mode and live Islamic radio. Built-in health checker automatically verifies stream availability and switches to fallback sources.
- 30+ verified radio stations
- Auto health monitoring
- Seamless mode switching
Automated Azkar System
Scheduled reminders every 30 minutes with audio/image support. Retry mechanisms, expiration tracking, and custom channel routing.
- Audio & visual azkar
- Custom channel targeting
- Expiry & retry handling
Prayer Times Integration
Accurate prayer times for 35+ countries and major cities. Supports 12h/24h formats, hijri calendar, and timezone awareness.
- 135+ cities worldwide
- Hijri & Gregorian dates
- Regional calculation methods
Interactive Control Panel
Persistent embed dashboard with role-based access. Toggle between admin-only and public modes. Navigation, playback, and radio controls in one place.
- Role-based permissions
- Persistent state saving
- Instant UI updates
Voice Stability & Recovery
Automatic reconnection on crashes, external disconnect handling, player state validation, and graceful fallback to working reciters.
- Auto-reconnect pipeline
- External disconnect handling
- Reciter fallback system
Persistent State Management
Firebase-backed state persistence ensures playback mode, reciter, surah index, and settings survive restarts and outages.
- Firebase Realtime DB
- Auto-sync on interaction
- Clean state restoration
Developer Admin Panel
Secure server-side verified panel for monitoring, messaging, server management, and complaint handling with audit logging.
- SPE_USER_ID verification
- Server & voice monitoring
- Direct user messaging
Open Source & Modular
Clean architecture, alias-based imports, environment switching, and comprehensive logging. Built for customization and scaling.
- Production-ready codebase
- Dev/Prod env switching
- Structured logging system
Available Commands
Slash commands with precise permission handling and cooldown management
Quran & Voice Commands
/إعداد
Setup Quran category with voice, text, and azkar channels (Admin)
Permissions: Administrator/دخول
Join the configured voice channel and start playback
Permissions: Administrator/دخول_قناة
Join a specific voice channel by selection
Permissions: Administrator/خروج
Disconnect from voice and clear playback state
Permissions: AdministratorControl & Interface
/تحكم
Open interactive control panel with playback, reciter, and navigation controls
Permissions: Configurable (Admin/Everyone)/دليل
Display usage guide and command reference
Permissions: Everyone/مصادر
View official data sources and API references
Permissions: EveryoneUtilities & Monitoring
/مواقيت_الصلاة
Interactive prayer times selection by country and city
Permissions: Everyone/سرعة
Display bot latency, uptime, server count, and system metrics
Permissions: EveryoneFeatured Reciters
Browse verified Quran reciters with multiple riwayah options
Islamic Radio Stations
Stream live Islamic content from verified radio sources
Quran Surahs
All 114 surahs with page references and revelation type
Riwayah & Moshaf Types
Different recitation styles and Quran editions available
Reliability & Infrastructure
Engineered for 24/7 operation with automatic recovery and resource management
Radio Health Checker
Continuous stream validation every 30 minutes. Detects dead links, switches to active fallbacks, and maintains playback continuity.
Memory Optimization
Automatic cache cleanup, interaction TTL management, and aggressive GC triggers when heap usage exceeds thresholds.
Rate Limiting & Cooldowns
User and server-level cooldowns prevent abuse. Global cooldowns and interaction deduplication ensure stability.
Local & Cloud Backups
Compressed JSON backups sent to Discord channels. Firebase sync ensures zero data loss during restarts.
Redis State Management
Distributed Redis caching and shared runtime state management for faster response times, synchronization, and scalable multi-process infrastructure.
Lavalink v4 Audio Nodes
Dedicated Lavalink v4 nodes with automatic failover, voice recovery, load balancing, and resilient audio streaming infrastructure.
Hybrid Sharding System
Advanced hybrid sharding architecture with distributed cluster management, centralized state synchronization, and scalable multi-instance Discord gateway handling.
Frequently Asked Questions
Common questions about setup, features, and support
Yes, QuranBot is completely free and open-source. You can add it to your server without any subscription fees. The source code is available on GitHub for self-hosting.
After inviting the bot with Administrator permissions, simply use the
/إعداد command in any text channel. The bot will automatically create a dedicated category with
voice, text, and azkar channels. You can then use /دخول to start playing or
/تحكم to open the control panel.
Yes. The bot supports a "Everyone" mode that allows non-admins to navigate between surahs, select reciters, and toggle radio mode with a built-in cooldown to prevent abuse. Admins can toggle this mode using the control panel.
QuranBot is built with automatic recovery. It monitors voice connections and attempts to reconnect on external disconnects. State persistence ensures that playback mode, reciter, and current position are saved, allowing seamless restoration after crashes or restarts.
Audio streams are sourced directly from mp3quran.net and other verified providers via API. Radio stations are also sourced from official Islamic radio URLs. The bot includes a health checker to ensure streams are active before playing.
Quick Setup Guide
Deploy QuranBot in minutes. The bot handles channel creation, permission overwrites, and state initialization automatically.
Invite & Authorize
Click the invite button. Ensure the bot has Administrator permissions during setup for channel creation.
Run /إعداد
Execute in any text channel. The bot creates the Quran category, voice, text, and azkar channels with secure overwrites.
Open Control Panel
Use /تحكم to access the interactive dashboard. Toggle between admin-only and public control modes.
Join & Play
Click the join button or use /دخول. Playback starts automatically with a random reciter and surah.
Requires Administrator for initial setup. Bot auto-optimizes voice bitrate to 64kbps for stability.
Ready to Enhance Your Community?
Use QuranBot for reliable Quran streaming, automated remembrance, and professional voice management. Fully open-source.