🛡️ CyberGuardian

Real-Time Android Security & Privacy Monitoring Application

MSc Cybersecurity Capstone Project — Advanced real-time threat detection, privacy monitoring, and network security for Android devices.

📱 Download APK · 📄 View Issues · 🐛 Report Bug · 💡 Request Feature

---

✨ Key Features

Feature	Description
🔍 Real-Time Threat Detection	Monitors device for malware, suspicious apps, and anomalies
🔐 Privacy Monitor	Tracks camera, microphone, location, and contact access in real-time
🌐 Network Security Scanner	Detects open ports, insecure connections, and suspicious traffic
📊 Security Dashboard	Unified risk scoring with actionable security insights
🚨 Instant Alerts	Push notifications for critical security events
📋 Audit Logs	Full timestamped security event history
🧠 Risk Scoring	Multi-vector threat analysis with severity ratings

---

📸 Screenshots

Dashboard	Privacy Monitor	App Guard	Network Firewall
Smishing Detection	Vishing Detection	URL Scanner	File Scanner
Security Audit Log	Security History	AI Security Assistant	Help & Reporting

---

🏗️ Architecture

CyberGuardian/
├── app/
│   └── src/main/
│       ├── java/com/cyberguardian/
│       │   ├── ui/              # Jetpack Compose screens & ViewModels
│       │   ├── data/            # Repositories & local data sources
│       │   ├── domain/          # Use cases & business logic
│       │   ├── services/        # Background monitoring services
│       │   └── utils/           # Security utilities & helpers
│       └── res/                 # Resources, layouts & assets
├── docs/                        # Documentation, screenshots & banner
└── README.md

Architecture Pattern: MVVM + Clean Architecture
Key Libraries: Jetpack Compose · Room · Hilt · Coroutines · WorkManager

---

🚀 Getting Started

Prerequisites

• Android Studio Hedgehog (2023.1.1) or later
• Android SDK API 24+
• Kotlin 1.9+
• A physical or virtual Android device

Installation

1. Clone the repository:

   git clone https://github.com/abirami-025/CyberGuardian.git

2. Open in Android Studio: Go to File ➔ Open and select the cloned CyberGuardian folder.

3. Configure API Keys (Third-Party Integrations): To enable all security scanning vectors, you need to configure your API keys in the local.properties file:

   [!TIP] Android Studio usually generates the local.properties file automatically. If it does not exist in your root directory, simply create a new blank text file and name it exactly local.properties.

   Open local.properties and add the following keys:

   # Inforge API Integration (Threat Intelligence)
   # Get key from: https://inforge.io
   INFORGE_BASE_URL="https://api.inforge.com/v1/"
   INFORGE_API_KEY="your_inforge_api_key_here"
   
   # VirusTotal API Integration (File & URL Scanning)
   # Get key from: https://www.virustotal.com/gui/my-apikey
   VIRUSTOTAL_API_KEY="your_virustotal_api_key_here"

   (Note: The local.properties file is automatically ignored by Git via .gitignore to prevent any credentials from being exposed publicly.)

4. Sync and Run: Let Gradle sync finish, and click the Run button to deploy to your device or emulator!

---

🔬 Technical Highlights

• Real-time monitoring via Android AccessibilityService and UsageStatsManager
• Network analysis using NetworkCallback and traffic inspection APIs
• Privacy tracking through AppOpsManager for granular permission auditing
• Risk scoring algorithm combining multiple independent threat vectors
• Battery-efficient background processing via WorkManager scheduled tasks
• Secure local storage using encrypted Room database

---

🛠️ Tech Stack

---

📄 Academic Context

Developed as part of an MSc in Cybersecurity dissertation, demonstrating:

• ✅ Practical application of Android security APIs
• ✅ Real-time threat intelligence implementation
• ✅ Privacy-first mobile application design principles
• ✅ MVVM Clean Architecture with Kotlin best practices
• ✅ Ethical security monitoring with user transparency

---

📜 License

Distributed under the MIT License. See LICENSE for more information.

---

Made with ❤️ by Abirami M
⭐ Star this repo if you found it useful!