Welcome to the Quran Word Analyzer! This is a fun and educational project designed to help you explore the Quran by searching for specific words in its verses. It’s important to note that this tool is not a serious religious resource but rather a fun way to interact with the text programmatically. Always refer to official sources like Diyanet İşleri Başkanlığı for accurate and authoritative Quranic studies.
This project is a web application that allows users to search for specific words in the Quran and see how many times they appear and in which verses. It uses the Quran.com API to fetch Quranic verses and provides a simple interface for searching and analyzing the text.
- Search for words in the Quran in Arabic or Turkish.
- See the total number of occurrences of the word.
- View the verses where the word appears.
- Paginated results for easy navigation.
- Normalized Arabic text for better search accuracy.
- Python 3.x installed on your machine.
- Flask and other dependencies installed (see below).
-
Clone this repository:
git clone https://github.com/YiitWT/quranAnalyzer.git cd quran-word-analyzer -
Install the required Python packages:
pip install -r requirements.txt
-
Run the Flask server:
python app.py
-
Open your browser and navigate to:
http://localhost:5000
- Select Language: Choose whether you want to search in Arabic or Turkish.
- Enter a Word: Type the word you want to search for in the input field.
- Toggle Word Matching: Use the checkbox to decide whether the word should be treated as a separate word (e.g., "Allah" vs. "Allah'ın").
- Set Page Size: Choose how many results you want to see per page.
- Click "Kelimeyi Analiz Et": The tool will display the results, including:
- The total number of verses where the word appears.
- The total number of occurrences of the word.
- A list of verses with the word highlighted.
- Built with Flask (Python).
- Uses the Quran.com API to fetch Quranic verses.
- Normalizes Arabic text for better search results.
- Caches the Quran dataset in a CSV file (
quran_dataset.csv) for faster access.
- Simple and responsive HTML/CSS interface.
- Uses Bootstrap for styling.
- Dynamic pagination for navigating through search results.
- This tool is not a substitute for serious Quranic study. It is intended for educational and fun purposes only.
- The data used in this project was fetched from Quran.com and Diyanet İşleri Başkanlığı as of 14.01.2025.
- Always refer to official and authoritative sources for accurate Quranic interpretation and understanding.
This project is licensed under the MIT License. Feel free to use, modify, and distribute it as you see fit. If you find it useful, consider giving it a ⭐ on GitHub!
- Thanks to Quran.com for providing the API.
- Thanks to Diyanet İşleri Başkanlığı for their translations and resources.
Enjoy exploring the Quran with this fun tool! If you have any questions or suggestions, feel free to open an issue or contribute to the project. 😊