Need help with covid19-tracker-cli?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

243 Stars 40 Forks GNU General Public License v3.0 203 Commits 4 Opened issues


A curl-based command line tracker for Novel Coronavirus or COVID-19 pandemic. It Supports terminal for linux and macos, command prompt for windows, and termux for android with real-time updates.

Services available


Need anything else?

Contributors list

COVID-19 Tracker CLI Mentioned in Awesome Coronavirus

Developed by Waren Gonzaga Github Release Github Star Github Fork License Powered By

Github Banner

COVID-19 Tracker CLI is an open-source NodeJS application for command line interface to track COVID-19 cases around the world. An optimized NodeJS application and a simple tracker with real-time updates from reliable data source. It Supports terminal for linux and macos, command prompt for windows, and termux for android. Visit Wiki

Public Domain Names

# stable build

dev build

uh-oh we reserve domains bro, now report us again! Try harder!

Do you want a custom and private URL for your personal use? Join here:

Sponsored By

Github Banner

Featured By

Wanna feature this project? Let me know!

COVID-19 Tracker CLI

How it Works

It uses an API and collect the relevant information for your reference.

Data Source:


This simple application offers you the following features...

  • Real-Time udpates.
  • Optimized application.
  • Fast response time (~< 100ms).
  • Simple layout and easy to understand.
  • By country query.
    • e.g. (
  • By country with History Chart
    • e.g. (
      or append with
  • Windows CMD support.
    • e.g. (
  • Plain or Basic version.
    • e.g. (
      ) or (
  • Random health saying on footer.
  • Local command line version.
    • e.g. (

More features coming soon...

Basic Usage

Global Tracking

To track COVID-19 cases on CLI globally, all you need to do is to use CURL or WGET command.


curl -L


wget -qO-


# visit


Country Tracking

To track COVID-19 cases on CLI by country, all you need to do is to append the URL with the country name or country ISO 3166-1 code.

Country Name

# example usage
curl -L

Country ISO 3166-1 Code

# /ph or /phl is ISO 3166 code of the Philippines
curl -L


Global Tracking with History Chart

# shows global result with history chart
curl -L
# shows by default a global history chart
curl -L


Country Tracking with History Chart

# shows result with history chart
curl -L
# shows by default a history chart
curl -L
# shows result with history chart
curl -L


Country Tracking with History Chart (Dashboard)

# shows result with history chart
curl -L


Advance Usage

Check Update Automagically

# check update every 10 seconds (where -n 10 is the interval)
watch -n 10 "curl -L"

for more advance setup (where -s is to suppress curl's progress bar)

watch -c -n 600 "curl -s -L"

Create a Shortcut Command

# set a desired alias for the command (replace endcov with your desired alias)
# this will give you a global update
# alias ="curl"

alias endcov="curl"

if you want to track a specific country

alias < coutry alias>="curl< name, ISO2, ISO3 here>"

alias endcovPH="curl"

Local Command Line Tracker

# clone the repo
git clone
# copy paste the command
cd covid19-tracker-cli && npm install && npm link
# run the local command line tracker. ex. covid 
covid ph

if you want to see the result in plain view without ansi encoding

covid ph --plain

run help for more info

covid help

Local Command Line Tracker in Container

# Create build file 
$ vim covid19-tracker-cli.containerfile
RUN apk update
RUN apk add git
RUN apk add npm
RUN git clone
RUN cd covid19-tracker-cli && npm install && npm link

Build container

$ podman build -t covid19-tracker-cli --file=covid19-tracker-cli.containerfile

Run container

$ podman run -it --rm=true localhost/covid19-tracker-cli covid PH

Official Blog

Many people asking me how to properly use my tracker. Here's the blog on How to Track Coronavirus on Command Line. If you have comments or suggestions please leave it on the comment section of the blog.


Here's the screeshot of the tracker on CLI...


White Label / Personalize / Custom / Development

White Label / Personalize / Custom Build

We are still working on this part...


Wanna improve the project? Follow our guidelines!

# clone the repo
git clone
# go to the project folder
cd covid19-tracker-cli
# run npm
npm install
# start the program by default it runs on port 7070
npm run start

curl to your local this is equivalent to

curl localhost:7070

if you want to curl then append /ph to the local host

curl localhost:7070/ph

# run this if you want to develop the program without restarting the server manually,

everytime you save the file it will restart the server automagically

npm run dev

Regional Trackers


Contributions are welcome, create a pull request to this repo and I will review your code. Please consider to submit your pull request to the

branch. Thank you!


If you're facing a problem in using COVID-19 Tracker CLI please let me know by creating an issue in this github repository. I'm happy to help you! Don't forget to provide some screenshot or error logs of it!

To Do

  • Add Static Version
  • NPM package
  • By State (US)
  • By Region, City (PH)
  • Add HTTP Headers (currently F)
  • More Code Refactor! (I guess I know what I'm doing now... for sure)
  • More... (have suggestions? let me know!)


Get the latest updates about the development!


Wanna see other projects I made? Join today!


Donate or Support

If you love this project please consider to support the development and help me to support the API provider of this command line tracker by means of coffee. Be a sponsor or backer of this project. Just a cup of coffee!

Donate Support

Help Us To Help Others

Some cups of my coffees goes to the foundation via #OneAgainstCovid19 by PayMaya


Supporters and Backers

Wanna see your name here? Just buy us a coffee!


COVID-19 Tracker CLI is licensed under GNU General Public License v3 -

FOSSA Status

Code of Conduct

Read the Code of Conduct


Related Projects

Other Projects

  • WiFi Passview is an open-source batch script-based program that can recover your WiFi Password easily in seconds.

  • WRN Cleaner is an all in one batch script based native PC maintenance and cleaner for Windows.



COVID-19 Tracker CLI is Developed and Maintained by Waren Gonzaga, Ian Vizarra, and Ken Gibas Abella

:computer: with :heart: by Waren Gonzaga with YHWH | Tracker CLI Developers

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.