https://github.com/phx/covid

Monitor COVID-19 stats for your state and the US from the terminal or a web page.
https://github.com/phx/covid

Last synced: about 1 year ago
JSON representation

Monitor COVID-19 stats for your state and the US from the terminal or a web page.

• Host: GitHub
• URL: https://github.com/phx/covid
• Owner: phx
• License: mit
• Created: 2020-03-28T16:48:02.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2020-04-11T16:18:13.000Z (about 6 years ago)
• Last Synced: 2025-01-29T10:33:58.831Z (over 1 year ago)
• Language: Shell
• Size: 10.7 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![Platform: Linux/MacOS](https://img.shields.io/badge/platform-Linux/MacOS-blue)

![Follow @rubynorails on Twitter](https://img.shields.io/twitter/follow/rubynorails?label=follow&style=social)

# covid.sh

There are much more robust COVID-19 trackers out there, but I whipped up this simple one for myself so that I could pull up-to-date stats from a known reliable resource,

[https://covidtracking.com/api/](https://covidtracking.com/api/).  For stats by country, you are probably going to want to use something more like

[coronavirus-tracker-cli](https://github.com/sagarkarira/coronavirus-tracker-cli), which you can simply use by executing `curl -L corona-stats.online`.

I figured I would share in case anyone was interested for their own use, but I mainly just created this for me and my family.

**Dependencies:**

- `bash`

- `curl`

- `jq`

- `column`

## Example Ouput

```

STATE:     AL

POSITIVE:  644

DEATHS:    3

Fri Mar 27 23:00:00 CDT 2020

COUNTRY:       US

POSITIVE:      102143

HOSPITALIZED:  14069

DEATHS:        1603

Sat Mar 28 11:47:54 CDT 2020

```

## Usage

`./covid.sh [output file]`

You can change the state number in the script to reflect the number of your state from the [covidtracking.com API](https://covidtracking.com/api/).

The script runs in an infinite loop, pulling API data every 5 minutes.  It can be killed with Ctrl-C.

If you specify an output file, it will write the results to that file in HTML format.  I did this so I could host it at an Nginx document root on my local network.

There is a meta tag in the HTML that will refresh the page every 5 minutes.  You don't have to host the file -- you can just as easily open it in Chrome, and it will work the same way.

## Running in the background as a daemon

If you only want to monitor the web page without having a terminal window dedicated to process itself, you can just run it in the background:

`./covid.sh -d /path/to/file.html`

And then just open `file.html` in your browser, and monitor from there.

You can kill the process with `./covid.sh --kill`.