https://github.com/gridhead/pignus-agent-for-internet-protection
A Python GUI application for scanning URLs and domains for safety
https://github.com/gridhead/pignus-agent-for-internet-protection
domain-safety url-scanning vulnerability-detection
Last synced: about 1 year ago
JSON representation
A Python GUI application for scanning URLs and domains for safety
- Host: GitHub
- URL: https://github.com/gridhead/pignus-agent-for-internet-protection
- Owner: gridhead
- License: gpl-3.0
- Created: 2019-10-28T10:52:31.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-10-23T03:01:45.000Z (over 1 year ago)
- Last Synced: 2025-04-22T20:12:40.702Z (about 1 year ago)
- Topics: domain-safety, url-scanning, vulnerability-detection
- Language: Python
- Homepage:
- Size: 1.31 MB
- Stars: 3
- Watchers: 2
- Forks: 4
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# pignus-agent-for-internet-protection
Version 0.05
A Python GUI application for scanning URLs and domains for safety
## Usage
1. Install and upgrade **virtualenv** if not already done by executing ```pip3 install virtualenv --user```
2. Clone the repository on your local drive and make it your current working directory.
3. Create a virtual environment by executing ```virtualenv venv```
4. Activate the virtual environment by executing ```source venv/bin/activate```
5. Install all dependencies for the project by executing ```pip3 install -r requirements.txt```
6. Run the project by executing ```python3 pigipgui.py```
7. Sign up at VirusTotal website to get your own public API key.
8. Create a new file called `virustotal.key` and store your key there.
9. Queue URL scanning, get URL report or get domain report of your target.
10. When done tinkering, deactivate the virtual environment by executing ```deactivate```
11. Give stars to the repository if it was helpful
## To-do
- [X] Build GUI and prototype UX for loopholes
- [X] Add function on single URLs for URL scanning
- [X] Add function on single URLs for URL reports
- [X] Add function on single URLs for domain reports
- [X] Add timer function to note the duration for scanning
- [X] Implement table iteration for list-of-tuples
- [X] Add clear button for all line edit boxes
- [ ] Add fixes for unresolved API request errors
- [ ] Cleanup and optimise code base
- [ ] Make miscellaneous bug fixes
## Changelog
### v0.01
1. Initial build
2. Built a robust GUI and checked loopholes
3. Added functionality to queue URL scan
4. Added way of dealing with APIKEY externally
### v0.02
1. Resolved API request errors from queue URL scan
2. Added timer function for queue URL scan
3. Handled exception where URLs could not be found
4. Handled exception where API key was not provided
5. Handled exception where API was overused
### v0.03
1. Added warning messages
2. Added functionality to get URL report
3. Switched fontface to improve legibility
4. Added clear button for all line edit boxes
5. Added message for timing and scan success
### v0.04
1. Resolved API request errors for get URL report
2. Added functionality to get domain report
3. Implemented table iterations for list-of-tuples
4. Fix for URLs which are blocked by the ISPs
5. Fix for timeout errors
### v0.05 (Current)
1. Cleaned up code from debug messages
2. Added a new set of fonts for rastering
3. Restructured `requirements.txt` for distribution
4. Added generic fix for unindexed errors
5. Fix for IndexError on table structuring
### v0.06 (Oncoming)
_To be decided_
## Screenshots
* Queue URL scanning (Basic layout, v0.05 onwards)
* Queue URL scanning (Results from `t0xic0der.netlify.com`, v0.05 onwards)
* Get URL report (Basic layout, v0.05 onwards)
* Get URL report (Results from `t0xic0der.netlify.com`, v0.05 onwards)
* Get domain report (Basic layout, v0.05 onwards)
* Get domain report (Results from `t0xic0der.netlify.com`, v0.05 onwards)
## Bugs
1. Some domains cannot be scanned due to ISP blockage or denial from the API provider.
2. Populating tables with data might take some time on single-core PCs.
3. Random API errors might occur some time - Try another URL first.
## Contribute
Fork, add, build and make a PR. You know the drill.