A web-based browser for Windows network shares with file search and previews.

SMB Enumerator is a lightweight self-hosted application for accessing files stored on Windows network shares. It provides a browser-based file explorer with search, previews, and downloads, making it easier to work with shared files without opening the native file explorer.

Connect to a UNC path such as \\server\share, browse folders, search indexed content, and preview supported files directly in the app.

• Folder tree navigation with expandable directories
• Direct support for UNC paths (for example \\server\share)
• Breadcrumb path navigation
• Optional auto-connect to a predefined share

• In-memory indexing for fast searches
• Optional disk cache for faster reconnects
• Search by file name or full path
• Filter by files or folders
• Exact match option

Supports common file types directly in the browser:

• Images: PNG, JPG, GIF, WebP, BMP, SVG, ICO, TIFF, AVIF
• PDF: Multi-page viewer using PDF.js
• DOCX: Rendered HTML view using mammoth.js
• Text / Code: TXT, JSON, PY, JS, CSV, XML, MD, YAML and others

Additional actions:

• Open file in a new tab
• Download files directly

• Dark theme
• Responsive two-panel layout
• File type icons
• Smooth folder expansion and navigation

• Python 3.8 or newer
• Network access to the target SMB share
• Permission to access the target path

git clone https://github.com/xtofuub/SMBitan.git
cd smb-enumerator
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux
source .venv/bin/activate
pip install -r requirements.txt

python app.py

Then open:

http://localhost:5000

1. Enter a UNC path such as \10円.0.0.5\Share
2. Enable UNC mode if required
3. Select Connect
4. Browse folders or use search
5. Select a file to preview or download

• Name — Search by file name only
• Path — Search full path
• Files — Show files only
• Folders — Show folders only
• Exact — Whole-word matching

smb-enumerator/
├── app.py
├── requirements.txt
├── README.md
└── static/
 ├── index.html
 ├── style.css
 └── app.js

Use this tool only on systems and shares you are authorized to access. Ensure permissions are in place before connecting to network resources.

Built with Flask, PDF.js, and mammoth.js