Folder Structure Logger | Drag-and-Drop Batch Tool

What is FolderLogger?

FolderLogger is a powerful yet lightweight Windows utility engineered to map complex directory hierarchies safely and effortlessly. Combining a seamless Batch drag-and-drop launcher with an embedded PowerShell engine, it gives you complete control over folder scan depth, file inclusion, size reporting, and hidden items.

It generates clean, beautifully indented tree views with distinct root separators and accurate size calculations (KB, MB, GB), exporting full audit logs straight to your Desktop with automatic, collision-free .txt file versioning.

Key Capabilities

Drag-and-Drop Launcher: Simply drop any target folder onto the script icon to immediately launch the interactive setup menu.
Custom Depth Control: Choose your recursion depth—scan 1 level (root only), 2 levels (subfolders), or 0 for infinite scanning.
Conditional File & Size Scanner: Option to toggle individual file listings. If disabled, the size prompt is automatically bypassed for streamlined input.
Automatic Human-Readable Sizes: Accurately formats total byte counts into KB, MB, or GB formatting in real time.
Smart Layout Formatting: Features clean text indentation, automatic root folder divider lines (---------------------------------------), and adaptive spacing when files are listed.
Robust Character & Extension Safety: Trims trailing slashes and handles complex paths, spaces, and dots cleanly to ensure output files always maintain a valid .txt extension.

How to Use

Download & Extract: Download FolderLogger.zip and extract FolderLogger.bat anywhere on your computer.
Drag and Drop your target folder directly onto the FolderLogger.bat file icon.
Configure Settings: Select your scan depth, file listing options, size formatting, and hidden item visibility in the prompt.
Let the script process your directory—once completed, a clean report will be saved directly to your Desktop!

Output Structure Preview

Below is an example of the structured text report generated on your Desktop when scanning a folder with files and size options enabled:

Folder Log for: Projects
Generated on: 8/1/2026 12:22:49 AM
Target Path: C:\Users\Admin\Projects
---------------------------------------
Client Archive
    2025 Financials
      - Q4_Report.pdf (1.24 MB)
      - Summary.xlsx (450.00 KB)

    2026 Proposals
      - Proposal_v1.docx (85.50 KB)

---------------------------------------

Active Deliverables
    Assets
      - Logo.png (512.20 KB)

    Source Files
      - main.cpp (12.40 KB)

---------------------------------------

SUMMARY
Total Folders: 4
Total Files: 5
Total Size: 2.27 MB
---------------------------------------

Script Architecture Breakdown

Inside the script's internal logic and safety procedures:

[01]

Trailing Slash & Quote Sanitizer

Strips trailing backslashes from %targetDir% to prevent Batch quote-escaping bugs from corrupting parameters passed to PowerShell.

[02]

Adaptive Input Jumper

Uses a bulletproof GOTO routine to skip the File Size prompt whenever File Listing is set to No.

[03]

Embedded PowerShell Engine

Executes an inline, in-memory PowerShell block via -ExecutionPolicy Bypass for high-performance recursive scanning.

[04]

Desktop Path & Extension Resolver

Uses native .NET framework calls ([Environment]::GetFolderPath) to resolve Desktop paths and safely append .txt extensions.

[05]

Dynamic Tree & Divider Formatter

Renders clean spaces for subfolder structures while automatically appending divider bars between root-level directories.

[06]

Summary Analytics Calculation

Aggregates total counts for folders, files, and total byte totals during execution, generating a precise end-of-report summary.