How duty1g/subcat works
SubCat is a subdomain discovery and triage tool: users run passive enumeration, DNS brute force, or monitoring, then optionally probe hosts, capture screenshots, export results, or serve a web report. The CLI coordinates these modes; passive providers use shared HTTP and configuration support, while screenshots and report browsing form a distinct workflow. The README documents the broad mode flow; edges based on unsampled implementation are omitted or marked unverified.
Main entry points: subcat.py CLI coordinator · screenshot.py Screenshot capture · passive.py Passive scan · modules Source modules
Components 20
CLI workflow
- CLI coordinator
subcat/subcat.py
Discovery
- Passive scan
subcat/passive.py - Source modules
subcat/modules - DNS brute force
subcat/bruteforce.py - Continuous monitor
subcat/monitor.py
Shared services
- API configuration
subcat/config.py - Response cache
subcat/cache.py - HTTP navigator
subcat/navigator.py - Terminal display
subcat/display.py - Result export
subcat/output.py
Host triage
- Host detection
subcat/detector.py - Screenshot capture
subcat/screenshot.py
Reports
- Scan files
subcat/screenshot.py - Report server
subcat/report.py - Report interface
subcat/ui/App.tsx - Screenshot gallery
subcat/ui/components/Gallery.tsx - Screenshot card
subcat/ui/components/ShotCard.tsx - Gallery filters
subcat/ui/components/Toolbar.tsx - Technology icons
subcat/ui/components/TechIcon.tsx
Other components
- Operator
Connections 21
- Operator → CLI coordinator: runs mode
- CLI coordinator → Passive scan: dispatches scan
subcat/subcat.py - CLI coordinator → DNS brute force: dispatches scan
subcat/subcat.py - CLI coordinator → Continuous monitor: dispatches scan
subcat/subcat.py - CLI coordinator → Report server: serves report
subcat/subcat.py - Passive scan → Source modules: queries sources
- Source modules → HTTP navigator: sends requests
subcat/modules/alienvault.py - Source modules → API configuration: reads keys
subcat/modules/binaryedge.py - Passive scan → Response cache: uses cache
subcat/passive.py - CLI coordinator → Host detection: runs detection
subcat/subcat.py - CLI coordinator → Screenshot capture: captures hosts
subcat/subcat.py - Screenshot capture → HTTP navigator: browses hosts
subcat/screenshot.py - Screenshot capture → Host detection: fingerprints pages
subcat/screenshot.py - Screenshot capture → Scan files: writes scan data
subcat/screenshot.py - Report server → Scan files: reads scan data
subcat/report.py - CLI coordinator → Result export: exports results
subcat/subcat.py - CLI coordinator → Terminal display: updates progress
subcat/subcat.py - Report interface → Screenshot gallery: renders gallery
subcat/ui/App.tsx - Screenshot gallery → Screenshot card: renders shots
subcat/ui/components/Gallery.tsx - Screenshot gallery → Gallery filters: renders filters
subcat/ui/components/Gallery.tsx - Screenshot card → Technology icons: shows technologies
subcat/ui/components/ShotCard.tsx