.---------.
_ |:: [-=-] |
| | |_________|
|~|
|_| ,;;;;,
I\ ,__ ,;;;, __, ///\\\\
I |{ / . . \ } / " \\||
I | ) ( _ ) ( \_= _///
I |{___'-. .-'___}\___ )_\
I ||~/,'~~~~~,\~~|'---(( \
I \ // \\ | \ \ \
I \/ // | | /-/
I (/ (/ | |/||\
I | | | |
I | | |____/
I :-----_o_-----: || |
I | /~~|===|~~\ | (( |
jgs I || |===| || ||_/
/^\ "~ '^^^' "" ((__|
▄▖ ▘ ▄▖▄▖▄▖▖ ▖▄▖
▌ ▛▌▛▘▛▌▛▌▀▌▌▌▌▛▘▌▌▚ ▐ ▛▖▌▐
▙▖▙▌▌ ▙▌▌▌█▌▚▘▌▌ ▙▌▄▌▟▖▌▝▌▐
A comprehensive terminal-based OSINT tool for real-time monitoring and analysis of global COVID-19 data. Built for intelligence professionals and researchers who need live situational awareness and comparative analytics.
⚠️ For Licensed Investigators: This tool is designed for use by licensed private investigators and authorized researchers conducting legitimate intelligence gathering operations.
- Features
- Installation
- Quick Start
- Usage
- Data Persistence
- Storage Requirements
- OSINT Applications
- Security & OPSEC
- API Information
- Contributing
- License
- Disclaimer
- Auto-refreshing real-time global statistics
- Tracks confirmed cases, deaths, recoveries, and active cases
- Shows change indicators and percentage variations
- Configurable refresh rate (default: 30 seconds)
- Color-coded metrics for quick visual assessment
- Calculates and displays mortality and recovery rates
- Side-by-side comparison of multiple countries
- Automatic Top 10 most affected countries analysis
- Custom country selection via ISO codes
- Visual bar charts for confirmed cases
- Comparative mortality and recovery rate analysis
- Support for all WHO-recognized regions
- Granular search by country, region/province, and city
- Detailed breakdown of cases, deaths, and recoveries
- Date-stamped reports for timeline analysis
- Geographic intelligence gathering capabilities
- Tracks data changes over time during active sessions
- Visual sparkline charts for trend identification
- Shows cumulative changes in all metrics
- Exports to JSON for further analysis
- Useful for pattern recognition and predictive modeling
- Detailed sub-national intelligence
- Top affected provinces/states ranking
- Comparative analysis within countries
- Visual representation of regional impact
- JSON format for interoperability
- Timestamped exports for record-keeping
- Structured data for integration with other tools
- Evidence preservation for investigative work
- Automatic data persistence across sessions
- Historical data saved to
coronavirosint_data.json - Auto-saves every 5 refreshes during live monitoring
- Auto-saves on program exit (normal or Ctrl+C)
- Resume monitoring from where you left off
- Unlimited historical data accumulation
- Python 3.6+
- Internet connection
- Terminal with color support
pip install requests# Clone or download CoronavirOSINT.py
chmod +x CoronavirOSINT.py
python3 CoronavirOSINT.py1. Live Global Dashboard (Auto-Refresh)
2. Country/Region Comparison
3. Search Specific Location
4. Historical Trend Analysis
5. Top Affected Regions
6. Province/State Breakdown
7. Export Data (JSON)
8. Exit
Press 1 to enter live monitoring mode. The dashboard will refresh automatically every 30 seconds showing:
- Total confirmed cases globally
- Total deaths
- Total recoveries
- Active cases
- Change indicators from previous refresh
- Mortality and recovery percentages
Press Ctrl+C to return to the main menu.
Press 2 to compare countries. You can:
- Press Enter to see Top 10 affected countries automatically
- Enter specific ISO codes (e.g.,
USA,CHN,ITA,ESP,GBR) for custom comparison
Press 3 for targeted searches:
- Enter country ISO code (required)
- Optionally specify region/province
- Optionally specify city
Example searches:
USA→ All US dataUSA+California→ California dataUSA+California+Los Angeles→ LA County data
Press 6 to analyze sub-national data:
- Enter country ISO code
- View all available provinces/states
- See ranked breakdown of cases by province
- Visual comparison chart
Press 7 to export collected historical data:
- Exports to JSON format
- Timestamped filename:
covid19_export_YYYYMMDD_HHMMSS.json - Includes all data points collected during all sessions
- ISO 8601 timestamps for each data point
Your data is automatically saved!
- Stored in:
coronavirosint_data.json - Auto-saves every 5 refreshes during live monitoring
- Auto-saves when you exit (option 8 or Ctrl+C)
- Automatically loads when you restart the tool
- Continues accumulating data across sessions
How it works:
- Run live dashboard (option 1) and collect data
- Exit the tool (Ctrl+C or option 8)
- Come back hours or days later
- Run the tool again - your historical data is still there!
- View trends (option 4) to see data spanning multiple sessions
Data accumulation example:
Session 1: Collect 10 data points → Exit
Session 2: Collect 20 more points → Total: 30 points
Session 3: Collect 15 more points → Total: 45 points
CoronavirOSINT automatically saves your historical data across sessions, allowing you to build long-term datasets for trend analysis and investigation workflows.
- Automatic loading: Data loads when you start the tool
- Auto-save during monitoring: Saves every 5 refreshes in live dashboard
- Auto-save on exit: Saves when you close the tool (option 8 or Ctrl+C)
- Persistent file:
coronavirosint_data.jsonin the same directory
# Day 1 - Morning
python3 CoronavirOSINT.py
# Shows: "Starting with fresh data"
# Collect data for 1 hour → Exit
# Day 1 - Evening
python3 CoronavirOSINT.py
# Shows: "[✓] Loaded 120 historical data points"
# Continue collecting → Exit
# Day 2 - Analysis
python3 CoronavirOSINT.py
# Select option 4 (Historical Trends)
# View trends spanning multiple days!# Backup your data
cp coronavirosint_data.json backup_$(date +%Y%m%d).json
# View data file
cat coronavirosint_data.json
# Start fresh (delete history)
rm coronavirosint_data.json
# Encrypt for sensitive investigations
gpg --symmetric --cipher-algo AES256 coronavirosint_data.jsonOne of the most efficient aspects of CoronavirOSINT is its minimal storage footprint.
| Duration | Storage Size |
|---|---|
| 1 hour | 16.5 KB |
| 1 day | 397 KB |
| 2 days | 793 KB |
| 1 week | 2.7 MB |
| 1 month | 11.6 MB |
| 1 year | 141 MB |
| 6 years | 1 GB |
- 2 days of data = Less than 1 smartphone photo
- 1 week of data = 1-2 photos
- 1 month of data = 3-4 photos
- 1 year of data = 30 photos
Text-based JSON data is incredibly compact:
- No images or media files
- Only essential numerical data
- Efficient timestamp format
- ~141 bytes per data point
| Use Case | Duration | Storage |
|---|---|---|
| Quick briefing | 30 minutes | 8 KB |
| Daily monitoring | 2 hours | 33 KB |
| Week-long investigation | 8 hrs/day × 7 days | 925 KB |
| Long-term monitoring | 4 hrs/day × 90 days | 5.8 MB |
Bottom Line: Storage is never a concern. You could run this tool continuously for years and barely use 1 GB.
This tool uses the COVID-19 Statistics API via RapidAPI:
- Base URL:
https://covid-19-statistics.p.rapidapi.com - Authentication: RapidAPI key (included in script)
- Rate limits: Managed by RapidAPI tier
/regions- List all available regions/countries/provinces- Get provinces for a specific country/reports/total- Global aggregate statistics/reports- Detailed reports with filters
Common ISO codes for quick reference:
USA- United StatesCHN- ChinaITA- ItalyESP- SpainGBR- United KingdomFRA- FranceDEU- GermanyIND- IndiaBRA- BrazilRUS- RussiaJPN- JapanKOR- South KoreaCAN- CanadaAUS- Australia
╔════════════════════════════════════════════════════════════════════╗
║ LIVE GLOBAL COVID-19 DASHBOARD ║
╚════════════════════════════════════════════════════════════════════╝
Last Updated: 2024-01-14 15:30:45
Global Statistics:
┌─────────────────────────────────┐
│ Total Confirmed Cases │
├─────────────────────────────────┤
│ 123,456,789 │
│ ↑ 12,345 (1.05%) │
└─────────────────────────────────┘
Country Confirmed Deaths Recovered Active
────────────────────────────────────────────────────────────────────────────
United States 40,123,456 1,234,567 38,123,456 1,765,433
China 95,234 4,636 90,123 475
Italy 4,567,890 128,456 4,300,123 139,311
Confirmed Cases Comparison
United States ████████████████████████████████████████████ 40,123,456
China ██ 95,234
Italy ████████████ 4,567,890
Spain ████████████ 4,456,789
- Situational awareness for crisis response teams
- Comparative analysis for policy effectiveness research
- Timeline reconstruction for outbreak investigations
- Geographic pattern analysis for epidemiological studies
- Background intelligence for fraud investigations involving COVID-19
- Verification of claims regarding pandemic impact
- Due diligence for business intelligence on affected regions
- Evidence collection for insurance and legal cases
- Terminal-based interface for secure OPSEC
- No web browser fingerprinting
- Local data storage only
- ProxyChains compatible for anonymity
This tool is designed for use by licensed private investigators and authorized researchers. Users should:
- Comply with all applicable laws and regulations
- Use data responsibly and ethically
- Respect data source terms of service
- Maintain proper chain of custody for evidence
All data is sourced from publicly available COVID-19 statistics via legitimate API services. No private or confidential information is accessed.
- Do not use for spreading misinformation
- Verify critical data from multiple sources
- Cite sources when using data in reports
- Respect API rate limits and terms
Error: Unable to fetch data
- Check internet connection
- Verify API key is valid
- Check RapidAPI service status
- Try again after a few moments
Error: Too many requests
- Wait before making additional requests
- Consider upgrading RapidAPI tier
- Use longer refresh intervals in live dashboard
Characters not displaying correctly
- Ensure terminal supports UTF-8
- Use a modern terminal emulator
- Check color support is enabled
View current data file:
cat coronavirosint_data.jsonCheck data file size:
ls -lh coronavirosint_data.jsonStart fresh (delete historical data):
rm coronavirosint_data.json
# Tool will start with fresh data on next runBackup your data:
cp coronavirosint_data.json coronavirosint_data_backup_$(date +%Y%m%d).jsonEncrypted backup:
gpg --symmetric --cipher-algo AES256 coronavirosint_data.jsonModify line in live_global_dashboard():
def live_global_dashboard(self, refresh_rate: int = 30):Change 30 to desired seconds between updates.
proxychains python3 CoronavirOSINT.pyRun live dashboard and leave it running to collect historical data:
nohup python3 CoronavirOSINT.py &Then select option 1 for live dashboard.
Export data can be analyzed with:
cat covid19_data_*.json | jq '.global_data[] | select(.confirmed > 1000000)'The modular design allows easy extension:
- Add new API endpoints in
CovidAPIclass - Create new visualization methods
- Implement additional data analysis functions
- Add export formats (CSV, XML, etc.)
Modify create_bar_chart() or create_sparkline() methods for different visual representations.
v1.0 - Initial Release
- Live global dashboard
- Country comparison
- Location search
- Historical trends
- Province breakdown
- JSON export
- Full color terminal UI
- ASCII Art: Modified from public domain sources
- COVID-19 Data: COVID-19 Statistics API (RapidAPI)
- Developer: OSINTCabal
MIT License - See LICENSE file for details
This tool is for informational and investigative purposes only. Data accuracy depends on upstream sources. Always verify critical information from official health organizations (WHO, CDC, etc.). The developer is not responsible for decisions made based on this data.
Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
- 🐛 Report bugs
- 💡 Suggest features
- 📝 Improve documentation
- 🔧 Submit pull requests
- ⭐ Star the project
git clone https://github.com/YOUR-USERNAME/CoronavirOSINT.git
cd CoronavirOSINT
./setup.sh- 📖 Documentation: README.md, SECURITY.md
- 🐛 Bug Reports: GitHub Issues
- 💬 Discussions: GitHub Discussions
- 🔒 Security Issues: See SECURITY.md for vulnerability reporting
Built for the OSINT community and licensed investigators who need reliable, real-time intelligence gathering tools for pandemic monitoring and analysis.
Special Thanks:
- RapidAPI for COVID-19 Statistics API
- The global OSINT community
- All contributors and users
If you find this tool useful, please star the repository! ⭐
- GitHub: @YOUR-USERNAME
- Project: CoronavirOSINT
Stay informed. Stay safe. Stay vigilant.
CoronavirOSINT - COVID-19 Intelligence at Your Fingertips