README.md in quran-audio-0.3.3 vs README.md in quran-audio-0.4.0
- old
+ new
@@ -1,42 +1,74 @@
+<p align="center">
+الْحَمْدُ لِلَّهِ رَبِّ الْعَالَمِي
+</p>
+
## About
quran-audio is a command-line utility that
can download recitations of The Noble Quran from
-[everyayah.com](https://everyayah.com).
-The recitations are provided as MP3 files
-(with one MP3 file per ayah).
+[al-quran-audio.reflectslight.io](https://al-quran-audio.reflectslight.io).
+The recitations are provided in the MP3 format with
+one MP3 file per ayah and a *minimum* bitrate of
+128kbps.
-## ~/.local/share/quran-audio/
+## share/
-Downloads are stored relative to ~/.local/share/quran-audio. <br>
-An example path:
-`/home/user/.local/share/quran-audio/mp3/alafasy/1/1.mp3`
+The command-line utility attempts to download MP3 files
+relative to the `~/.local/share/quran-audio/` directory.
+A single, full recitation of The Noble Quran typically
+ranges from 2.5GB to 2.8GB in size. Each recitation is
+organized per this directory structure:
* **~/.local/share/quran-audio/mp3/alafasy/** <br>
Contains recitations by Mishari bin Rashed Alafasy
* **~/.local/share/quran-audio/mp3/alajmi/** <br>
Contains recitations by Ahmad bin Ali Al-Ajmi
* **~/.local/share/quran-audio/mp3/yassin/** <br>
Contains recitations by Sahl Yassin
+* **~/.local/share/quran-audio/mp3/rifai/** <br>
+ Contains recitations by Hani ar-Rifai
+## Examples
+
+The following examples demonstrate how to use the quran-audio
+command-line utility to download particular recitations, and
+list available recitations as well:
+
+ ##
+ # Download recitations
+ user@localhost$ quran-audio pull -r alafasy
+ user@localhost$ quran-audio pull -r rifai
+
+ ##
+ # List available recitations
+ user@localhost$ quran-audio ls
+
## Install
-quran-audio is available via rubygems.org:
+quran-audio is available via rubygems.org
- user@localhost$ gem install quran-audio
- user@localhost$ quran-audio --help
- user@localhost$ quran-audio ls --help
- user@localhost$ quran-audio pull --help
+ gem install quran-audio
-## Thanks
+## Credit
-Alhamdulillah
+**Recitations**
-* Thanks to the [everyayah.com](https://everyayah.com) website
-* Thanks to the reciters
+* Mishari bin Rashed Alafasy
+* Ahmad bin Ali Al-Ajmi
+* Sahl Yassin
+* Hani ar-Rifai
+**Sources**
+
+* The [everyayah.com](https://everyayah.com) website
+
+## See also
+
+* [al-quran.reflectslight.io](https://al-quran.reflectslight.io)
+* [al-quran-audio.reflectslight.io](https://al-quran-audio.reflectslight.io)
+
## License
The "source code" is released under the [GPL](./LICENSE) license
<br>
-The reciters hold the copyright for the audio files
+Copyright for the recitations belongs to the reciters