VoidCrawler

Directory Reconnaissance System — Version 2.1.0 · K0NxT3D
DIRECTORY · RECON

VoidCrawler is a lightweight, single-file developer CMS designed for easy file structure management, private repo navigation, and drag‑and‑drop interaction.

VoidCrawler is built to run on any modern web server, including Apache, Nginx, or IIS, with PHP 7.4+. It leverages the browser’s FileReader API and drag-and-drop capabilities to provide instant directory tree rendering and file previews, all processed locally on your machine. This ensures complete privacy for sensitive repositories or personal projects.

2.1.0 - Overview

VoidCrawler 2.1.0 is a dark-themed directory intelligence scanner with a secured login system. It recursively scans directories, separates root-level folders from files, and filters out sensitive or unnecessary files and extensions.

New in 2.1.0

  • Secured login system requiring MySQL and PHP for authentication.
  • Additional PHP files for security: auth.php, config.php, login.php, logout.php.
  • Expanded hidden files list: index.html, index.php, 404.html, icon.png, logo.png, 404.png, ogimage.png, favicon.png, favicon.ico.
  • Expanded hidden extensions: ini, php, json, db, sh, py, go, log, js, css.
  • Root-level content split into Directories and Direct Downloads.
  • LOG OUT button added to header for authenticated sessions.
  • Enhanced styling for folders, files, and top-level blocks.

Installation

  1. Upload index.php and the supporting files (auth.php, config.php, login.php, logout.php) to a web-accessible folder.
  2. Ensure your environment meets the requirements:
    • Web server (Apache, Nginx, IIS)
    • PHP 7.4+ with fileinfo extension enabled
    • MySQL database for login system
    • Modern browser for drag-and-drop and collapsible folders
  3. Visit login.php to authenticate before accessing index.php.

Quick Usage

By default, the script scans the folder it is in:

$root = './';
$pathLen = strlen($root);
myScanDir($root, 0, strlen($root));

Root-Level Directory Display

  • Directories: collapsible folder tree on the left.
  • Direct Downloads: files at root level with download links.

How It Works

VoidCrawler scans recursively and filters both files and folders according to the hidden files and hidden extensions lists. Root-level files and folders are separated visually. Nested directories are displayed in collapsible lists.

Security Notes

  • Access is restricted by login; only authenticated users can view content.
  • Hidden files and extensions prevent exposure of sensitive backend or system files.
  • Do not expose login or index.php publicly without proper server protections.

Changelog

  • 2.1.0 — Secured login, expanded hidden files/extensions, UI enhancements, LOG OUT button, root-level split for directories and files.
  • 2.0.1 — Original public directory scanner, dark-themed UI, recursive scanning.

2.0.1 - Overview

This application functions as a basic developer Content Management System for browsing, reading, and managing project files. It is intentionally simple: a single PHP file (plus an optional favicon) that provides a clean interface for sorting your directory structure, loading files, and interacting with them effortlessly.

Single‑File Setup

Only one file is required:

  • voidcrawler.php – the full application
  • (optional) favicon.ico for branding

No backend, no dependencies, no installation. Drop the file anywhere and open it in your browser.

Drag & Drop Simplicity

Drag a folder or file directly into the working directory. The browser reads it in real time:

  • Instant directory tree rendering
  • Immediate content preview
  • No uploading — all processing stays on your machine

How It Works

The system uses the FileReader and webkitdirectory drag‑and‑drop capabilities built into modern browsers. All operations are local:

  • No server interaction
  • No data leaves the machine
  • Fast parsing of nested file structures

Use Cases

  • Private offline file browser
  • Developer repo preview tool
  • CMS‑style project manager
  • Lightweight documentation explorer
  • Portable code review interface

Prerequisites

Before using VoidCrawler, ensure your environment meets the following requirements:

  • Web Server: Apache, Nginx, IIS
  • PHP: Recommended 7.4+ with fileinfo enabled
  • Browser: Chrome, Firefox, Edge, Safari with FileReader API support
⚠️ Note: VoidCrawler will not function correctly without a web server and PHP. Opening the PHP file directly may result in errors or a blank page.

Notes

  • The design is clean, dark‑themed, and functional for repo‑style viewing.
  • Expandable, editable, and built for developer customization.

License

MIT License — use, modify, and distribute. Attribution appreciated when used publicly.

Copyright (c) 2025 K0NxT3D
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "VoidCrawler"), to deal
in the VoidCrawler without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the VoidCrawler, and to permit persons to whom the VoidCrawler is furnished
to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the VoidCrawler.
VoidCrawler - 2.1.0 - K0NxT3D