Content discovery inside Burp Suite. Recursive directory brute forcing, virtual host discovery and subdomain enumeration, sent through Burp's own HTTP stack, with your session, your scope and your proxy settings. Results sit next to your traffic instead of in a separate terminal.
Works in Burp Suite Community and Professional. Inspired by gobuster and feroxbuster.
POC.webm
| Mode | What it does |
|---|---|
| Dir | Recursive path brute forcing with extensions and adjustable depth. Calibrates every directory first, so soft 404s, catch-all routes and blanket 401/403 pages don't flood the results. |
| Vhost | Varies the Host header against one IP to find virtual hosts. A junk-host baseline filters out wildcard responses. |
| DNS | Actively brute forces subdomains, using either the system DNS resolver (lists A/AAAA records, filters wildcard DNS) or Burp's network stack (finds hosts that answer over HTTP(S) through your upstream proxy). |
Every mode also gives you:
- Live results: a sortable table with colour-coded status codes and the full request and response for every HTTP hit.
- Burp integration: right-click hits to send them to Repeater or Intruder, or add them to the site map. Right-click any request elsewhere in Burp to Send to Buster.
- Filters: hide statuses (
404, 500-599) or sizes, or match a regex. Copy and CSV export follow the filtered view. - Authenticated scans: cookies and auth headers are added to every request.
- Polite scanning: an optional request rate limit and automatic backoff on
429. - Large wordlists: files are streamed rather than loaded into memory, so multi-million-line lists like SecLists work.
- Download
Buster.jarfrom the latest release, or build it. - In Burp go to Extensions → Installed → Add, choose type Java and select the jar.
- Open the Buster tab, pick a mode, enter a target and a wordlist, and press Start.
- Enter the target URL, for example
https://target.com/app/. - Paste paths or Load File, and optionally set extensions (
php, bak, txt). - Pick the depth and thread count, then press Start.
Hits stream in. Directories (a 301 to /name/, or a confirmed /name/) are scanned recursively up to the chosen depth, including dot-directories like .git/.
- Enter the target IP or host and the base domain (
target.com). - Paste or load a subdomain wordlist, then press Start.
Each word is sent as word.target.com in the Host header to the same address. Only responses that differ from the junk-host baseline are reported.
- Enter the base domain and a subdomain wordlist.
- Choose Resolve via, then press Start:
- System DNS resolver: real DNS lookups from your machine. Lists each name's A/AAAA records and filters out names that only resolve because of a wildcard record.
- Burp (HTTP probe): each name is requested as
https://name/(thenhttp://name/) through Burp, so your upstream proxy or SOCKS settings decide how it's resolved. Use this when the target is only reachable through a proxy for a specific network. It lists names that answer, with status and size, not IPs. If unknown names also get an answer (for example a proxy's error page), matching answers are filtered out.
Right-click a request in Proxy, Target, Repeater or Logger and choose Send to Buster. This pre-fills Dir (from that directory), Vhost (that host) or DNS (its domain). Nothing is sent until you press Start.
| Option | Where | Default | Notes |
|---|---|---|---|
| Threads | all modes | 30 / 10 / 30 | Concurrent requests or lookups. |
| Resolve via | DNS | System DNS resolver | System DNS resolver or Burp (HTTP probe), see DNS. |
| Extensions | Dir | empty | File suffixes tried for every word: with php, bak, the word admin sends admin, admin.php and admin.bak. Empty = only the bare words. |
| Depth | Dir | 1 | How many directory levels to recurse. 0 = scan only the target directory, 1 = also scan inside each directory found there, and so on. |
| Req/s | Dir, Vhost | 0 (no limit) | A hard cap on requests per second across all threads. |
| Headers / Auth | Dir, Vhost | empty | One Name: value per line. A bare a=b line becomes a cookie. |
| Extensions on recursion | Dir | off | Recursion happens either way (controlled by Depth). This only decides whether the extensions are also tried inside discovered directories. Off = extensions at the top level only, bare words deeper down (much faster). |
| Collapse duplicates | Dir | on | Hides repeated status+size responses within a directory. Directories are never hidden. |
| Add hits to site map | results bar | off | Pushes every new hit into Target → Site map. |
When a target answers 429 (or 503 with Retry-After), Buster retries with growing backoff and slows every thread down, then speeds back up as normal responses return. Rate-limit responses are never shown as hits.
- DNS with the system resolver doesn't go through Burp, so upstream proxy and SOCKS settings don't apply. Switch Resolve via to Burp when they should.
- Vhost over HTTPS sends the TLS SNI of the target, not the vhost name, so servers that route purely on SNI won't reveal their vhosts this way.
- Stop and unload are clean: in-flight scans are cancelled and every thread exits.
Requires Java 17+ and Maven.
git clone https://github.com/ismailsanan/Buster
cd Buster
mvn clean verify # builds and runs the test suiteThe jar is written to target/Buster.jar.
devis the integration (staging) branch;mainholds released code.- Open pull requests against
dev. CI runsmvn verifyon every push and pull request. - Releases are cut by tagging
vX.Y.Zonmain; see CHANGELOG.md. - The design, requirements and architecture are described in docs/DESIGN.md.
- Live progress (requests/sec, ETA) with pause and resume
- Settings that persist across Burp restarts
- Word and line count matching
- Built-in wordlist presets
- Seeding Dir mode from paths already in proxy history
Buster reimplements the core ideas of gobuster and feroxbuster as a native Burp extension. All credit for the original tools goes to their authors.