Makka-live

Makka Live Bot is a high-fidelity Discord audio engine built for seamless, decentralized streaming; for the Muslim Ummah.

• Resilient "Master-Standby" Relay: Say goodbye to downtime. Our decentralized hosting ensures that if a "Master" instance goes offline, a "Standby" instance immediately takes over to keep the bot functional across all servers.
• Quranic Integration: Powered by the Quran Foudnation API, the bot provides high-quality Quran recitations, daily verses (Ayat), detailed Tafsir, and multi-language translations directly to your voice channels and chats.
• Values-Driven & Halal-First: We are committed to a "Muslim-friendly" experience. We are actively developing content filters to ensure all audio remains halal and beneficial, creating a safe space for the community.

InshaAllah, this project will grow to serve the entire Ummah with clean, high-quality audio technology and easy access to the Word of Allah.

Makka Live Bot can be run in two ways:

• Option 1 (Remote): Start the bot directly on the backend servers using this dashboard. (Not recommended since the backend is hosted on Vercel, which does not run continuously. Need to host it on a VPS or similar.)
• Option 2 (Local): Run the bot on your local machine using MakkaLauncher. This control center will then communicate with it remotely.

1. Add the bot: Click the "Add Bot to Discord" link above to invite Makka to your server.
2. Choose an option: Start the bot remotely using Option 1, or download the MakkaLauncher.exe from Option 2.
3. Local Setup: If choosing Option 2, execute the downloaded file on your host machine to connect it to this control center.

Yes! Makka Live Bot features an Automatic Failover system. If you run the MakkaLauncher.exe on multiple computers:

• The first one to start becomes the Master and handles all commands.
• Others enter Standby Mode automatically.
• If the Master instance is closed or loses connection, a Standby instance will automatically take over as the new Master within 35 seconds.
• The new Master will even automatically rejoin the voice channels and resume its last known state.

To ensure the server focus remains on Islamic content, the bot includes a Halal Filter:

• The !play command checks titles for keywords like Quran, Nasheed, Islamic, Lecture.
• Songs and music content are automatically blocked.

The bot is integrated with the Quran Foundation API. You can use:

• !play live to play live quran recitation.
• !quran <surah> <start> [end] to play specific verses.
• !translate <surah> <ayah> to view interactive translations.
• Use !help in Discord to see the full list of available commands.