Skip to main content

Introduction

odirscan is an open directory scanner that crawls web-based directory listings, collects file metadata via HTTP HEAD requests, and presents the results in a filterable web dashboard.

Key Features​

  • Recursive crawling -- Discovers files across nested directory listings using colly, with configurable MIME-type and subdirectory filters.
  • Mullvad proxy rotation -- Routes requests through SOCKS5 relays on the Mullvad VPN network using round-robin switching.
  • Web UI -- Serves scan results in a single-page application powered by Tabulator.js with per-column filtering and live statistics.
  • Two-phase scanning -- A Scan pass discovers file URLs from directory listings, then a Tag pass performs HEAD requests to populate content type, size, and modification timestamps.

How It Works​

  1. You provide a list of open directory URLs.
  2. The scanner crawls each URL, validates it as a directory listing, and recursively follows subdirectories.
  3. Discovered file URLs are collected and then tagged with HTTP metadata (content type, content length, last modified).
  4. Results are served on a local web interface for browsing and filtering.

Next Steps​