https://github.com/hazemmeqdad/quranbot
islamic bot can send pray times and play holy quran on voice channel and more things
https://github.com/hazemmeqdad/quranbot
bot discord discord-bot islamic islamic-prayer-times python python3
Last synced: over 1 year ago
JSON representation
islamic bot can send pray times and play holy quran on voice channel and more things
- Host: GitHub
- URL: https://github.com/hazemmeqdad/quranbot
- Owner: HazemMeqdad
- License: mit
- Created: 2021-03-01T11:10:48.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-11-19T14:27:16.000Z (over 2 years ago)
- Last Synced: 2025-02-27T05:51:27.768Z (over 1 year ago)
- Topics: bot, discord, discord-bot, islamic, islamic-prayer-times, python, python3
- Language: Python
- Homepage: https://github.com/HazemMeqdad/quranbot/wiki
- Size: 75.5 MB
- Stars: 9
- Watchers: 0
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
QuranBot - بوت القرآن الكريم
بوت القرآن الكريم للتذكير بالله عز و جل
## About
The bot is a bot that helps your server to remember for allah. its send azkar for every 30 minutes or some other times.
## Features
- Send Azkar for every 30 minutes or some other times.
- Play quran with radio or any other audio source.
- Got prayer times for every city.
- Got all quran holy pages with custom fast cdn.
## How bot works
bot work on python and use a [discord.py](https://github.com/Rapptz/discord.py) library to connect to the discord gateway & rest discord api, it use a [mongodb](https://www.mongodb.com/) database to store all data, and we use a [lavalink](https://github.com/freyacodes/Lavalink) library to play quran audio.
## Setup steps
### Clone the repository. (required)
```bash
git clone https://github.com/HazemMeqdad/quranbot.git # required git
```
if you hava a problem or not donwload git tool then you can download it from [here](https://git-scm.com/downloads), or you can download repository from [here](https://github.com/HazemMeqdad/quranbot/archive/refs/heads/master.zip)
* This steps to install in linux vps
### Install docker latest version. (required)
```bash
curl -fsSL https://get.docker.com -o get-docker.sh
DRY_RUN=1 sudo sh ./get-docker.sh
```
### Install docker-compose latest version. (required)
```bash
sudo apt-get update
sudo apt-get install docker-compose-plugin
sudo yum update
sudo yum install docker-compose-plugin
```
### Configure the bot. (required)
create the `.env` file and use the config template from example file `example.env` and edit it. example:
```env
TOKEN="OTg3NTM5NjEw..."
MONGO_URL="mongodb://localhost:27017"
OWNER_IDS="670993199011201025"
# If you went to create slash command on once guild
# DEBUG_GUILD="843710915861545000"
# Just password required
LAVALINK_NODE_PASSWORD="youshallnotpass" # lavalink password
```
### Create a docker container
Open the folder of your clone
```bash
docker-compose up -d
```
### Other commands
```bash
docker-compose stop # to stop the bot
```
## How to use
You can find all commands in on use the help command
# Some screenshots of commands
