README.md

� CyTrack: Cyber Threat Dashboard

Track, visualize, and stay ahead of global cyber threats — all in one place!

---

✨ What Can CyTrack Do?

• �️ See the World: Explore a live, interactive map of cyber threats by country.
• 📈 Spot Trends: View charts showing attack patterns over the years.
• 📰 Stay Updated: Get the latest cyber news and threat intelligence, filtered for you.
• 🛠️ Easy to Use: Simple setup, modular code, and a clean, modern UI.

🗂️ Project at a Glance

manage.py         # Django starter
requirements.txt  # Python packages
.env              # Your secrets (not tracked)
cyber/            # Project settings
dashboard/        # Main app: views, templates, static, filters
media/            # Uploaded/generated files

⚡ Quickstart (3 Steps!)

1. Get the code & set up Python:

   git clone https://github.com/PamJoshi/CyTrack.git
   cd CyTrack
   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt

2. Set up your secrets & database:
   • Copy .env.example to .env and add your OTX API key.
   • Edit cyber/settings.py for your PostgreSQL database:

     DATABASES = {
         'default': {
             'ENGINE': 'django.db.backends.postgresql',
             'NAME': 'cyberdb',
             'USER': 'youruser',
             'PASSWORD': 'yourpassword',
             'HOST': 'localhost',
             'PORT': '5432',
         }
     }

3. Run it!

   python manage.py migrate
   python manage.py runserver
   # Visit http://localhost:8000/

🧩 Tech Stack

• Django
• PostgreSQL
• requests
• python-dotenv
• folium
• fontawesome

📁 Key Files

• dashboard/views.py — News, heatmap, and dashboard logic
• dashboard/templates/dashboard/dashboard.html — Main UI
• dashboard/static/ — CSS, images, plots
• dashboard/templatetags/dashboard_filters.py — Custom template filters
• cyber/settings.py — All the settings

🛠️ Make It Yours

• Database: Change DATABASES in cyber/settings.py for your setup
• Secrets: Store API keys in .env (never commit this!)
• Visuals: Add or update plots in static/plots/
• Templates: Edit HTML in dashboard/templates/dashboard/

🤝 Contribute

New ideas? Found a bug? Pull requests and issues are welcome!

📄 License

MIT License

📬 Contact

Questions or feedback? Open an issue or reach out on GitHub!