Directory Intelligence System // PHP 2.2.1 Upgrade

VoidCrawler

File intelligence, recursive exploration, and controlled directory reconnaissance.

Version 2.2.1 Runtime PHP 7.4+ Deployment Apache / Nginx / IIS License MIT

Project Summary

VCU // Directory Reconnaissance

VoidCrawler is a DaRK-themed tactical directory-intelligence system built for precision, speed, and operator control. Version 2.2.1 is the current DarkMatter PHP upgrade: a deployable server-side scanner that recursively maps a selected directory, separates root folders from direct-download files, hides configured system and application clutter, and renders the result through a rebuilt command-interface presentation. Earlier releases and the separate Go-based standalone branch remain documented below as supporting project history, while PHP 2.2.1 remains the primary release presented here.

Discover

Recursively map folders and files with natural ordering, clear hierarchy, and root-first visibility for faster triage.

Filter

Reduce web-application noise and conceal configured file types so operational content remains visible without exposing unnecessary internals.

Retrieve

Surface direct-download targets and navigable file links without turning the interface into a heavyweight file manager.

Current Release2.2.1

Current RuntimePHP 7.4+

Upgrade LinePHP 2.2.1

DistributionServer-Side PHP

Operational Model

Scan // Sort // Render

VoidCrawler enumerates a selected base path, separates directories from files, applies exclusion rules, sorts results naturally, and renders a focused exploration interface. It is reconnaissance software rather than a general-purpose file manager: the system strips away noise and emphasizes structure, navigation, and retrieval.

Recursive Mapping

Explore nested directory structures while preserving a readable hierarchy and collapsible branches.

Root-Level Separation

Keep directories and direct-download files in distinct panels so the first operational view is immediately readable.

Filtered Visibility

Exclude configured filenames and extensions such as application scripts, databases, logs, configuration files, and branding assets.

DarkMatter Interface

Present the filesystem through the rebuilt red-and-steel command interface while retaining responsive behavior on smaller screens.

Direct Access

Open or retrieve exposed files from the rendered interface with minimal friction.

Web-Server Deployment

Run under Apache, Nginx, or IIS anywhere PHP has permission to read the intended repository tree.

Quick Start

PHP 2.2.1 Deployment

Place the VoidCrawler PHP file and its stylesheet in the directory you want to expose, confirm that the web-server account has read access, and open the route in a browser. The current PHP scanner uses its own directory as the root node unless the source is deliberately configured for another path.

# Example Apache deployment
sudo mkdir -p /var/www/html/voidcrawler
sudo cp voidcrawler.php /var/www/html/voidcrawler/index.php
sudo cp voidcrawler.css /var/www/html/voidcrawler/voidcrawler.css
sudo chmod -R 755 /var/www/html/voidcrawler

# Open locally
http://localhost/voidcrawler/

# PHP requirement
PHP 7.4+ with filesystem access to the selected directory

Operational warning: VoidCrawler reveals directory names and downloadable files that survive its exclusion rules. Restrict the scan root, verify the hidden-file and hidden-extension arrays before deployment, and protect public routes with authentication, IP controls, a VPN, or a secured reverse proxy.

PHP 2.2.1 Core

Current DarkMatter Upgrade

The 2.2.1 PHP release preserves the original VoidCrawler idea while tightening the presentation and exposure model. The recursive scanner reads the filesystem, classifies each entry as a directory or file, applies exact-name and extension exclusions, sorts the final collection naturally, and renders nested branches only when the operator opens them.

Recursive Scanner

The directory walker descends through readable folders and builds a clean relative hierarchy instead of exposing raw server paths in the visible labels.

Exact-Name Exclusions

System files, index pages, common branding images, WordPress internals, asset folders, and other configured names are removed before output.

Extension Exclusions

INI, PHP, JSON, database, shell, Python, Go, log, JavaScript, and CSS files can be withheld from the public directory view.

Natural Sorting

Entries are ordered naturally so numbered releases and human-readable names remain useful during repository triage.

Collapsible Branches

Nested directories stay folded until requested, keeping large repositories navigable without flooding the page.

Direct Downloads

Files located at the root are placed in a dedicated retrieval panel rather than being mixed into the directory tree.

Alternate Go Branch

Secondary Standalone Implementation

A separate Go-based implementation explored a self-contained cross-platform executable, arbitrary local scan paths, live search, progress indicators, collapsible trees, and theme options. It is retained here for completeness as an alternate implementation branch. The product documented and presented throughout this page is the DarkMatter Software PHP 2.2.1 release.

# Historical / alternate Go workflow
./vcu
./vcu /home/username/Documents

# Windows
.\vcu.exe "C:\Users\Username\Documents"

Project History

Versioned Development Record

2.2.1

Current DarkMatter PHP upgrade. Rebuilt command interface, recursive directory mapping, natural sorting, expanded filename and extension filtering, collapsible navigation, and a root-level split between Directories and Direct Downloads.

2.2.0

Separate Go-based standalone branch introduced a binary capable of scanning and serving a selected local directory. It remains an alternate implementation in the project record and does not replace the PHP 2.2.1 release documented here.

2.1.0

Secured PHP release with MySQL-backed login, expanded hidden files and extensions, authenticated-session controls, and a refined Directories / Direct Downloads layout.

2.0.1

Developer-CMS experiment with browser drag-and-drop, FileReader support, and local repository preview workflows.

2.0.0

Major themed rewrite and expanded files array. Marked the transition away from the original personal-use script.

1.0

Original single-file PHP directory crawler. Functional, compact, and the genesis of the VoidCrawler project.

Security & Deployment

Controlled Exposure Required

Protect Public Routes

Directory names and filenames can disclose infrastructure details. Never publish an unrestricted instance against sensitive storage.

Constrain Scan Scope

Use an intentional base path. Avoid broad filesystem roots and prefer dedicated directories containing only material intended for inspection.

Use Access Controls

Pair deployments with reverse-proxy authentication, network allowlists, VPN access, or an equivalent trust boundary.

Downloads

Release Channel

VoidCrawler PHP 2.2.1

DarkMatter directory reconnaissance, filtered navigation, and direct-download interface for PHP-enabled web servers.

Access Temporarily Disabled

License & Attribution

MIT License

Copyright © 2025–2026 K0NxT3D. Permission is granted, free of charge, to use, copy, modify, merge, publish, distribute, sublicense, and sell copies of VoidCrawler, provided that the copyright and permission notices remain included in substantial portions of the software.