Quran-CLI

A simple command line interface for listening to Quran.

Demo

q-cli.mp4

Used API

• We are using the mp3quran api.

Dependencies

• Install mpv as it is required for playing the audio.
  • Debian based distributions sudo add-apt-repository ppa:mc3man/mpv-tests sudo apt update && sudo apt install mpv
  • [Update] For Ubuntu 22.04 sudo apt install mpv
  • Windows Follow This link

How to use

• To use without installing the package: npx @quran-cli/q-cli [options]
• Or install it globally: sudo npm install @quran-cli/q-cli -g and use it as q-cli [options]
• To show the version: q-cli -v
• To show help: q-cli -h

Quran-CLI

  Listen to the Quran from your terminal 
  While listening press P to toggle between pause and resume                    
  Press q to exit  

Options

  -n, --showRadios              Shows all available radio channels                                            
  -d, --radio number            Play specific radio                                                           
  -c, --reciterSurah number[]   lay specific surah by a specific reciter.                                     
                                If no surah specified, it will shows the available suras for the specified    
                                reciter.                                                                      
  -r, --showReciters            Shows all available reciters                                                  
  -s, --showSuras               Show all suras in the Quran                                                   
  -v, --version                 Shows the current version                                                     
  -h, --help                    Prints this usage guide                                                       

^_^

  Recall us in your doa'!  

• Show all available radio channels: q-cli -n
• Play specific radio: q-cli -d <radio index>
• Show all available reciters: q-cli -r
• Play specific surah by a specific reciter: q-cli -c <reciter index> <surah index>
• Show all available suras by a specific reciter : q-cli -c <reciter index>
• Show all suras in the Quran: q-cli -s

Suggestions

• Try: q-cli -d 0

How to build locally

• Install typescript using: npm install -g typescript if you do not have typescript globally
• Install dependencies: npm install
• Build the source files: npm run build
• Run the index: node bin/index.js [options]