Qurancord is a discord bot to search for and obtain surahs and/or verses of Quran from the internet. Built using Spring Framework and JDA
This project is built on top of JVM Technology which will require Java 21 and using Gradle as dependency management. Quran's sources are obtained from https://alquran.cloud/api.
These are the dependencies used:
This bot is mostly uses the Discord Slash Command. The following is a list of the commands:
| Command | Options | Description |
|---|---|---|
/surah find |
number: int |
Find surah information based on specified number |
/surah search |
keyword: str |
Search surah information based on specified name keyword |
/surah random |
- | Get randomized surah information |
/ayah find |
surah: int number: int image?: bool |
Find an ayah from specified options |
/ayah search |
keyword: str image?: bool |
Search ayah translations based on specified keyword |
/ayah random |
surah?: int image?: bool |
Get randomized ayah information |
Requirement:
- JDK 21 or later
Procedure:
- Clone this repo:
git clone https://github.com/stackpan/qurancord.git cd /path/to/qurancord - Copy the app config template which are located on
app/src/main/resources/application.properties.examplecp app/src/main/resources/application.properties.example app/src/main/resources/application.properties
- Apply your token into
discord.bot-tokenkey inside app config:discord.bot-token=YOUR_COPIED_TOKEN - Run it:
./gradlew bootRun