quranicaudio-dl is a command-line program to download audio/MP3 files of various Quran recitations from QuranicAudio.
-
Clone this repo.
git clone https://github.com/fathyar/quranicaudio-dl.git
-
Go to the cloned repo directory.
cd quranicaudio-dl/
-
Symlink
quranicaudio-dl
to one of your$PATH
environment variable directories e.g.~/.local/bin/
.ln -s "$(pwd)"/quranicaudio-dl ~/.local/bin/
-h, --help Show this help and exit
--version Print program version and exit
-r, --recitation <name> Specify the recitation name
As for the recitation name, it is obtained from the audio file URL (unfortunately, for the time being) manually. Here is a guide on how to obtain the recitation name.
-
On your browser, go to QuranicAudio website.
-
Navigate to one of the recitation pages e.g. this page.
-
On the recitation page, hover on one of the surahs. You will see a download link in the form of a "Download" button shown. Right click on it and copy the link address.
-
Paste the link somewhere e.g. a terminal window. Now let's see the link/URL that we've got.
https://download.quranicaudio.com/quran/mishaari_raashid_al_3afaasee/001.mp3
As seen in the URL above, the string
mishaari_raashid_al_3afaasee
is what we're looking for which is then passed on as an argument to the-r
or--recitation
option.Another URL example from another page:
https://download.quranicaudio.com/quran/bandar_baleela/complete/001.mp3
In the URL above,
bandar_baleela/complete
would be the string we look for.In a nutshell, we look for the string between the URL string
https://download.quranicaudio.com/quran/
and the surah number/nnn.mp3
.https://download.quranicaudio.com/quran/<recitation-name>/nnn.mp3 https://download.quranicaudio.com/quran/<recitation-name/path>/nnn.mp3
Basic usage:
quranicaudio-dl -r <recitation-name>
# or
quranicaudio-dl --recitation <recitation-name>
Example:
quranicaudio-dl -r mishaari_raashid_al_3afaasee
The above example will download audio (mp3) files of all surahs (114 files) from the recitation of mishaari_raashid_al_3afaasee
and store the files in current directory where the command is executed.
If you want to store the files in a specific directory, you can create the directory first and then cd
to it before running the command. For example:
# create a new directory
mkdir 'Mishari Rashid al-Afasy'
# go to the directory
cd 'Mishari Rashid al-Afasy'/
# run the command
quranicaudio-dl -r mishaari_raashid_al_3afaasee
See CHANGELOG.md file.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.
Copyright © 2021–2022 Fathy AR