Makka-live
A decentralized Discord bot
for the Muslim Ummah.
Introduction
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.
How does the bot work?
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.
What should I do first?
- Add the bot: Click the "Add Bot to Discord" link above to invite Makka to your server.
-
Choose an option: Start the bot remotely using
Option 1, or download the
MakkaLauncher.exefrom Option 2. - Local Setup: If choosing Option 2, execute the downloaded file on your host machine to connect it to this control center.
Can I run the bot on multiple devices?
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.
What is the Islamic Content Filter?
To ensure the server focus remains on Islamic content, the bot includes a Halal Filter:
- The
!playcommand checks titles for keywords like Quran, Nasheed, Islamic, Lecture. - Songs and music content are automatically blocked.
How do I use the Quran commands?
The bot is integrated with the Quran Foundation API. You can use:
!play liveto play live quran recitation.!quran <surah> <start> [end]to play specific verses.!translate <surah> <ayah>to view interactive translations.- Use
!helpin Discord to see the full list of available commands.
Windows Setup
1. Download the MakkaLauncher.exe file.
2. Double-click the downloaded file to run it.
3. If Windows SmartScreen blocks it, click "More info" and then "Run anyway".
4. Wait for the control center to show the bot as "Online".
Android Setup (Termux)
1. Install Termux from F-Droid (Do not use Google Play).
2. Download the MakkaLauncher-Android binary using the button below to your phone.
3. Move the file into your Termux home directory.
4. Open Termux, make the file executable, and run it:
chmod +x MakkaLauncher-Android
./MakkaLauncher-Android