How ravipandit991/digital-footprint-investigator works
Digital Footprint Investigator is a browser-based OSINT application with a Flask backend. An investigator submits a target or file through the web interface; the backend dispatches a selected reconnaissance or intelligence tool, stores results in a case, extracts entities and suggests follow-up investigations. Case results can then be exported as a PDF report. The README documents all 22 tools and professional capabilities; sampled backend excerpts support the orchestration, case storage, correlation, configuration and reporting links, but not the internal calls of every tool.
Main entry points: app.py Flask API · email_investigation.py Email investigation · domain_investigation.py Domain investigation · username_lookup.py Username lookup
Components 31
Investigation interface
- Web interface
index.html - UI interactions
script.js
Backend workflow
- Flask API
backend/app.py - Entity correlation
backend/correlation.py - API key config
backend/config.py - Authentication manager
backend/tools/authentication.py
Active reconnaissance
- Port scanning
backend/tools/port_scan.py - DNS enumeration
backend/tools/dns_enum.py - Subdomain enumeration
backend/tools/subdomain_enum.py - WHOIS lookup
backend/tools/whois_lookup.py - Directory bruteforce
backend/tools/dir_brute.py - Web crawler
backend/tools/web_crawler.py - SSL/TLS scanner
backend/tools/ssl_scan.py - Banner grabbing
backend/tools/banner_grab.py
Passive intelligence
- Username lookup
backend/tools/username_lookup.py - Email investigation
backend/tools/email_investigation.py - Domain investigation
backend/tools/domain_investigation.py - IP investigation
backend/tools/ip_investigation.py - Phone investigation
backend/tools/phone_investigation.py - Metadata extraction
backend/tools/metadata_extraction.py - Website analysis
backend/tools/website_analysis.py - Social media search
backend/tools/social_media.py - Data breach check
backend/tools/breach_check.py - Reverse image search
backend/tools/reverse_image.py - Google dorking
backend/tools/google_dorking.py - Public records
backend/tools/public_records.py - Dark web monitor
backend/tools/dark_web.py
Cases and reporting
- Case database
backend/db.py - PDF reports
backend/report_generator.py
Other components
- Investigator
- External intelligence services
Connections 38
- Investigator → Web interface: uses
README.md - Web interface → UI interactions: interacts through
README.md - UI interactions → Flask API: submits investigations
README.md - Flask API → Port scanning: dispatches tool
backend/app.py - Flask API → DNS enumeration: dispatches tool
backend/app.py - Flask API → Subdomain enumeration: dispatches tool
backend/app.py - Flask API → WHOIS lookup: dispatches tool
backend/app.py - Flask API → Directory bruteforce: dispatches tool
backend/app.py - Flask API → Web crawler: dispatches tool
backend/app.py - Flask API → SSL/TLS scanner: dispatches tool
backend/app.py - Flask API → Banner grabbing: dispatches tool
backend/app.py - Flask API → Username lookup: dispatches tool
backend/app.py - Flask API → Email investigation: dispatches tool
backend/app.py - Flask API → Domain investigation: dispatches tool
backend/app.py - Flask API → IP investigation: dispatches tool
backend/app.py - Flask API → Phone investigation: dispatches tool
README.md - Flask API → Metadata extraction: dispatches tool
backend/app.py - Flask API → Website analysis: dispatches tool
backend/app.py - Flask API → Social media search: dispatches tool
README.md - Flask API → Data breach check: dispatches tool
README.md - Flask API → Reverse image search: dispatches tool
README.md - Flask API → Google dorking: dispatches tool
README.md - Flask API → Public records: dispatches tool
README.md - Flask API → Dark web monitor: dispatches tool
README.md - Flask API → Authentication manager: routes key management
backend/app.py - Flask API → Case database: stores case results
backend/app.py - Flask API → Entity correlation: extracts entities
backend/app.py - Entity correlation → Case database: reads case entities
backend/app.py - Flask API → PDF reports: builds report
backend/app.py - Flask API → API key config: manages keys
- Email investigation → API key config: reads API keys
backend/tools/email_investigation.py - Domain investigation → WHOIS lookup: uses lookup
README.md - Domain investigation → DNS enumeration: uses enumeration
README.md - Social media search → Username lookup: includes lookup
README.md - Authentication manager → API key config: loads and saves keys
backend/tools/authentication.py - Email investigation → External intelligence services: queries optional APIs
backend/tools/email_investigation.py - Username lookup → External intelligence services: checks platforms
backend/tools/username_lookup.py - Investigator → External intelligence services: configures credentials
README.md