StyingDev / Styings-Quran-Bot

A Discord Bot Written in Discord.py for reading and listening to quran through Discord.

Stying's Quran Bot 📖🕌

Stying's Quran Bot is a Discord bot designed to provide users with access to Quranic verses and audio recitations directly within their Discord servers. With QuranBot, users can easily read verses from different chapters (Surahs) of the Quran and listen to audio recitations in various voices. Invite the Bot!

Features

• Read Quranic Verses: Browse and read verses from different chapters of the Quran.
• Listen to Audio Recitations: Listen to audio recitations of Quranic chapters (Surahs) in various voices.

Getting Started

Prerequisites

• Python 3.8 or higher
• Discord Bot Token (Obtain from Discord Developer Portal)

Installation

1. Clone the repository:

git clone https://github.com/StyingDev/Styings-Quran-Bot.git

2. Navigate to the project directory:

cd Styings-Quran-Bot

3. Install the required Python packages:

pip install -r requirements.txt

4. Create a '.env' file in the project directory and add your Discord Bot Token:

DISCORD_TOKEN=your_discord_bot_token_here

Running the Bot

Run the following command to start the bot:

python main.py

Usage

Bot Commands

• /read: Select and read verses from different chapters of the Quran.
• /recite: Select and listen to audio recitations of Quranic chapters (Surahs).
• /leave: Select and bot will promt the bot the leave the Voice chat.
• /pause: Select and pause the playing audio.
• /resume select and resume the playing audio.
• /loop Select and loop the playing audio.
• /stoploop Select and stop looping the playing audio.

Selecting Chapters

When prompted to select a chapter, choose from the provided options to read or listen to the selected chapter.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.