Skip to content

Mostafa-wael/Quran-cli

Repository files navigation

Quran-CLI

A simple command line interface for listening to Quran.

GitHub contributors GitHub issues GitHub forks GitHub stars GitHub license

Demo

q-cli.mp4

Used 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]