Hysen LabsTilawaPlayer
Terminal Quran player for streaming and downloading recitations.
TilawaPlayer streams and downloads Quran recitations in the terminal
TilawaPlayer is a lightweight terminal Quran player written in Python. It streams and downloads recitations from the MP3Quran network and supports thirty named reciters across Windows, Linux and macOS.
Listening and downloading
The player lets users listen to Quran recitations directly from the terminal and either stream them over the internet or download them for offline playback. It supports a list of thirty well known reciters, including Abdul Basit Abdus Samad, Mahmoud Khalil Al Husary, Mishary Rashid Alafasy, Maher Al Muaiqly, Saad Al Ghamdi and Saud Al Shuraim among others. The project is described as lightweight and suitable for devices with limited resources.
Requirements and setup
TilawaPlayer needs Python 3.10 or later, the miniaudio audio library, an internet connection and a terminal that supports ANSI escape sequences. Installation is done by cloning the repository, moving into the project directory and running pip install for the requirements, or simply installing miniaudio. The program is started from the src directory with python main.py, or python3 main.py where the system uses that name.
Status and acknowledgments
The README states the project is still in beta, so users may meet errors, unstable features or unexpected behavior, and bug reports are welcomed. Recitations are streamed and downloaded from the MP3Quran network at mp3quran.net, and the author thanks a cat named Mimi in the acknowledgments. The project is licensed under the GNU General Public License version 3.
Editorial conclusion
TilawaPlayer runs on the three major desktop platforms and is released under the GPL version 3 license. Reciter audio is sourced from the MP3Quran network.
Community notes