https://github.com/th-shivam/phishguard
PHISHGUARD: Real-Time Phishing Detection Extension π‘οΈ PHISHGUARD is a cutting-edge browser extension designed to protect users from phishing attacks and malicious websites in real-time. With its sleek cyberpunk-inspired UI and advanced threat detection capabilities, PHISHGUARD ensures safe and secure browsing.
https://github.com/th-shivam/phishguard
anotnet cybersecurity ethical ethical-hacking free-project hacking phishing phishing-detection safe-browsing safe-browsing-tool safe-settings security-tools
Last synced: 10 months ago
JSON representation
PHISHGUARD: Real-Time Phishing Detection Extension π‘οΈ PHISHGUARD is a cutting-edge browser extension designed to protect users from phishing attacks and malicious websites in real-time. With its sleek cyberpunk-inspired UI and advanced threat detection capabilities, PHISHGUARD ensures safe and secure browsing.
- Host: GitHub
- URL: https://github.com/th-shivam/phishguard
- Owner: Th-Shivam
- Created: 2025-02-07T17:13:13.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-10T03:51:58.000Z (over 1 year ago)
- Last Synced: 2025-06-11T20:38:39.687Z (about 1 year ago)
- Topics: anotnet, cybersecurity, ethical, ethical-hacking, free-project, hacking, phishing, phishing-detection, safe-browsing, safe-browsing-tool, safe-settings, security-tools
- Language: JavaScript
- Homepage:
- Size: 292 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# π‘οΈ PHISHGUARD: Real-Time Phishing Detection Extension
PHISHGUARD is a cutting-edge browser extension designed to protect users from phishing attacks and malicious websites in real-time. With its sleek cyberpunk-inspired design and advanced threat detection capabilities, PHISHGUARD empowers users to browse the web safely and confidently.
---
## π Features
β
**Real-Time URL Scanning** β Automatically scans URLs using the VirusTotal API to detect malicious or suspicious sites.
β
**Dynamic Blocking** β Blocks access to flagged websites and redirects users to a secure warning page.
β
**User-Friendly Popup** β A modern popup interface allows users to toggle protection, view status, and refresh updates.
β
**Crowdsourced Reporting** β Users can report phishing sites, contributing to a community-driven database of threats.
β
**Color-Coded Warnings** β Provides clear, visually appealing warnings (π΄ red for malicious, π‘ yellow for suspicious, π’ green for safe).
β
**Lightweight & Optimized** β Minimal resource usage ensures smooth performance without slowing down your browsing experience.
---
## π Installation
### 1οΈβ£ From Chrome Web Store
- Visit the PHISHGUARD page on the Chrome Web Store.
- Click **"Add to Chrome"** and follow the prompts to install the extension.
### 2οΈβ£ From Source Code
```bash
git clone https://github.com/th-shivam/phishguard.git
```
- Open Chrome and navigate to `chrome://extensions/`.
- Enable **Developer Mode** (toggle in the top-right corner).
- Click **Load Unpacked** and select the cloned repository folder.
- PHISHGUARD will now appear in your extensions list!
---
## π οΈ How It Works
1. **URL Monitoring** β The background script monitors all navigation events in the browser.
2. **Threat Analysis** β Each URL is sent to the VirusTotal API for real-time scanning.
3. **Blocking Malicious Sites** β If a URL is flagged as malicious or suspicious, it is blocked, and the user is redirected to a secure warning page.
4. **User Interaction** β The popup provides real-time status updates and allows users to toggle protection or refresh the state.
---
## π¨ Design Highlights
π **Cyberpunk Theme** β A futuristic design with glowing neon accents and smooth animations.
β‘ **Interactive Animations** β Buttons pulse, indicators glow, and transitions are seamless.
π± **Responsive Layout** β Looks great on all screen sizes, ensuring a consistent user experience.
---
## π Impact
π **Social** β Protects users from phishing scams, identity theft, and financial fraud.
π° **Economic** β Reduces costs associated with cybercrime and enhances business security.
β»οΈ **Environmental** β Optimized for energy efficiency, minimizing resource usage.
---
## π§ Development Setup
### Prerequisites
- **Node.js** (optional, for local testing)
- **Chrome Browser** (or other supported browsers like Firefox)
- **VirusTotal API Key** (for URL scanning)
### Steps
1. Obtain a free API key from **VirusTotal**.
2. Replace `YOUR_VIRUSTOTAL_API_KEY` in `background.js` with your actual API key.
3. Run the extension locally by following the **Installation** steps above.
---
## π€ Contributing
We welcome contributions from the community! Hereβs how you can help:
π **Report Bugs** β Open an issue on GitHub if you encounter any problems.
π‘ **Suggest Features** β Share your ideas for new features or improvements.
π§ **Submit PRs** β Fork the repository, make your changes, and submit a pull request.
Please adhere to our **Code of Conduct** when contributing.
---
## π License
This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.
---
## π Acknowledgments
π **VirusTotal** β For providing the powerful API used for URL scanning.
π **Chrome Extensions Team** β For their excellent documentation and support for Manifest V3.
π οΈ **Open Source Community** β For inspiration and resources that helped shape this project.
---
## π’ Feedback & Support
π **Email:** [anotnet.shivam@gmail.com](mailto:anotnet.shivam@gmail.com)
π¦ **Twitter:** [@PhishGuardApp](https://twitter.com/dreamyshivam)
π **GitHub Issues:** Open an issue in this repository.
---
## π Stay Safe Online
With **PHISHGUARD**, youβre taking a proactive step toward protecting yourself and others from online threats. Together, we can create a safer internet for everyone. π»β¨
---
## πΈ Screenshots
### π₯οΈ Popup Interface

### π« Blocked Page

---
## π£ Follow Us
β **Star this repository** to show your support!
π **Share with friends** who care about online safety.
π’ **Spread the word** about PHISHGUARD on social media.
Thank you for choosing **PHISHGUARD**! Together, we can fight phishing and make the web a safer place. ππ‘οΈ