Folder Footprint scans a directory and creates a portable HTML report with total size, top-level folder sizes, and the largest files. It is read-only: it skips symlinks and common generated folders, and never deletes or changes source files.
- 📁 Summarizes sizes of top-level folders and files.
- 📦 Lists the largest files in the scanned tree.
- 📊 Generates a clean, responsive HTML report with relative-size bars.
- 🛡️ Skips symlinks and common generated directories.
- 🔒 Performs no cleanup or destructive actions.
python main.py ~/Downloads --output downloads-report.htmlOpen the generated HTML file in your browser.
python main.py ./your-folder --output folder-footprint.html- Python 3.10+ standard library
- pathlib, os.scandir, and HTML escaping
folder-footprint/
├── main.py
├── requirements.txt
└── assets/
└── illustration.svg- Add an optional JSON report format.
- Add configurable directory exclusions.
- Add a treemap visualization for nested folders.
Issues and pull requests are welcome. Include your operating system, a small directory example, and the command used when reporting a bug.
Released under the MIT License. See LICENSE.