📦 Installation

Go

go install github.com/MyCode83/godirb@latest

Homebrew

brew install MyCode83/godirb/godirb

Winget

winget install MyCode83.godirb

Binary

Download the latest release for your platform from the Releases page and add it to your PATH.

---

🚀 Quick Start

Basic scan

godirb -u https://example.com

Recursive

godirb -u https://example.com -r

Recursive with a depth limit

godirb -u https://example.com -r --depth 2

Custom wordlist

godirb -u https://example.com -w paths.txt

JSON output

godirb -u https://example.com --json -o results.json

---

✨ Why godirb?

godirb is designed for the common case: you want to enumerate directories and files quickly, without configuring a large fuzzing framework.

Highlights

• ⚡ Fast native Go binary
• 📦 Single executable
• 📚 Embedded wordlists
• 🔄 Recursive scanning
• 📂 Directory and file discovery
• 🎯 Wildcard filtering / response calibration
• 🌐 Port fuzzing (http://host:FUZZ)
• 📄 JSON & CSV output
• 🧩 Simple CLI

---

📊 godirb vs DirSearch

DirSearch is a mature and feature-rich web path scanner.

godirb intentionally focuses on the most common workflow: install, run and get useful results with minimal setup.

Feature	godirb	DirSearch
Find files and folders	✅	✅
Recursive scan	✅	✅
Custom wordlists	✅	✅
Written in Go	✅	❌
Single binary	✅	❌
Embedded default wordlists	✅	❌
Works without runtime wordlist files	✅	❌
Port fuzzing (http://host:FUZZ)	✅	❌

---

📦 Features

Scanning

• Directory and file brute-forcing
• Recursive mode (-r, --recursive)
• Recursive depth limit (--depth, default: 2)
• Extensions (-x, --ext)
• Custom wordlists (-w, --wordlist)
• FUZZ placeholder mode

Embedded Wordlists

• small
• medium (default)
• big
• ports
• payloads
• xss
• lfi

Output

• Standard text
• Quiet mode
• JSON
• CSV
• File output

Control

• Threads (-t, --threads)
• Ignore status codes (-i, --ignore)
• Default ignored codes: 404,400,405,408
• Wildcard filtering / response calibration

---

💻 Examples

Basic scan

godirb -u https://example.com

Recursive

godirb -u https://example.com -r

Recursive with one nested level

godirb -u https://example.com -r --depth 1

Custom wordlist

godirb -u https://example.com -w paths.txt

Extensions

godirb -u https://example.com -x php,txt,bak

FUZZ parameter

godirb -u "https://example.com/search?q=FUZZ" -w payloads

Port fuzzing

godirb -u https://example.com:FUZZ

Export JSON

godirb -u https://example.com --json -o results.json

Export CSV

godirb -u https://example.com --csv -o results.csv

---

📋 Example Output

DIR       200      1234 B  https://example.com/admin
FILE      200       842 B  https://example.com/login.php
DIR       403       795 B  https://example.com/uploads

---

📖 Embedded wordlists

Name	Purpose
small	common.txt from SecLists
medium	Default raft-medium-directories
big	Larger enumeration DirBuster big
ports	Port fuzzing
payloads	Generic payloads
xss	XSS payloads
lfi	LFI payloads

---

⚠️ Disclaimer

Use godirb only for authorized security testing, labs and CTFs.

You are responsible for obtaining permission before scanning any target.

---

📄 License

Licensed under the MIT License. See LICENSE for details.