WarenGonzaga/covid19-tracker-cli
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. curl -L covid19.trackercli.com
repo name | WarenGonzaga/covid19-tracker-cli |
repo link | https://github.com/WarenGonzaga/covid19-tracker-cli |
homepage | https://trackercli.com |
language | JavaScript |
size (curr.) | 502 kB |
stars (curr.) | 160 |
created | 2020-03-19 |
license | MIT License |
COVID-19 Tracker CLI
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. Visit Wiki
Domain Names
# stable build
covid19.trackercli.com
covid19.warengonzaga.com
covid19cli.now.sh
# dev build
dev.covid19.trackercli.com
covid19clidev.now.sh
# 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: https://warengonza.ga/TtYvZ34
Sponsored By
Featured By
Wanna feature this project? Let me know!
How it Works
It uses an API and collect the relevant information for your reference.
Data Source: https://www.worldometers.info/coronavirus
Features
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. (
/country
).
- e.g. (
- By country with History Chart
- e.g. (
/history/<country>/
or append with<cases or deaths>
)
- e.g. (
- Windows CMD support.
- e.g. (
/cmd
or/cmd/country
).
- e.g. (
- Plain or Basic version.
- e.g. (
/plain
or/plain/country
) or (/basic
,/basic/country
).
- e.g. (
- Random health saying on footer.
- Local command line version.
- e.g. (
covid <country>
)
- 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
curl -L covid19.trackercli.com
WGET
wget -i https://covid19.trackercli.com && cat index.html
HTTPie
# visit httpie.org
http http://covid19.trackercli.com
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 covid19.trackercli.com/philippines
Country ISO 3166-1 Code
# /ph or /phl is ISO 3166 code of the Philippines
curl -L covid19.trackercli.com/ph
Country with History Chart
# shows result with history chart
curl -L covid19.trackercli.com/history/ph
# shows by default a history chart
curl -L covid19.trackercli.com/history/ph/cases
# shows result with history chart
curl -L covid19.trackercli.com/history/ph/deaths
Advance Usage
Check Update Automagically
# check update every 10 seconds (where -n 10 is the interval)
watch -n 10 "curl -L covid19.trackercli.com"
# for more advance setup (where -s is to suppress curl's progress bar)
watch -c -n 600 "curl -s -L covid19.trackercli.com/<country>"
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 <your alias>="curl https://covid19.trackercli.com"
alias endcov="curl https://covid19.trackercli.com"
# if you want to track a specific country
# alias <your alias>< coutry alias>="curl https://covid19.trackercli.com/< name, ISO2, ISO3 here>"
alias endcovPH="curl https://covid19.trackercli.com/philippines"
Local Command Line Tracker
# clone the repo
git clone https://github.com/warengonzaga/covid19-tracker-cli.git
# copy paste the command
cd covid19-tracker-cli && npm install && npm link
# run the local command line tracker. ex. covid <country/iso 3166 code>
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
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.
Screenshots
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…
Development
Wanna improve the project? Follow our guidelines!
# clone the repo
git clone https://github.com/warengonzaga/covid19-tracker-cli.git
# 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 https://covid19.trackercli.com
curl localhost:7070
# if you want to curl https://covid19.trackercli.com/ph 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
Contributing
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 dev
branch. Thank you!
Issues
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!)
Community
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!
Help Me 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 me a coffee!
License
COVID-19 Tracker CLI is licensed under MIT - https://opensource.org/licenses/MIT
Code of Conduct
Sources
-
API from NovelCOVID API which based on WorldMeter
-
Data from CSSE at Johns Hopkins University
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.
Resources
Author
COVID-19 Tracker CLI is Developed and Maintained by Waren Gonzaga and Ian Vizarra
- Facebook: https://facebook.com/warengonzagaofficial
- Twitter: https://twitter.com/warengonzaga
- Website: https://warengonzaga.com
- Email: dev(at)warengonzaga[.]com
</> with <3 by Waren Gonzaga