Quranic Audio Downloader

Quranic Audio Downloader is a Python script designed to download audio files from the Quranic Audio website. It provides various functionalities for downloading recitations, taraweeh recitations from Haramain, non-Hafs recitations, and recitations with translation.

NOTE

I have hardcoded the download path in the constant.py python file. If you want to change the download path, please refer to the constant.py file, and change the path there.

Installation

From installation script

bash install.sh

From git

1. Clone the repository:

   git clone --depth=1 https://github.com/BeedPro/Quran-Audio-Downloader

2. Create a virtual environment and activate it by:

   python -m venv .venv
   source .venv/bin/activate

3. Install the required dependencies within a virtual environment:

   pip install -r requirements.txt

Usage

To use the Quranic Audio Downloader, run the program.py script:

./run

Follow the prompts to select the desired section and proceed with the download.

Features

• Download recitations from various Qaris.
• Download recitations from Haramain Taraweeh.
• Download non-Hafs recitations.
• Download recitations with translation.

Dependencies

• requests: For making HTTP requests.
• tqdm: For displaying progress bars.
• typing: For type hints.
• math: For mathematical operations.
• os: For interacting with the operating system.

Testing

To run the tests, run the following command:

./run_tests

Contributing

Contributions are welcome! If you encounter any issues or have suggestions for improvements, feel free to open an issue or submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.