FolderUtils

FolderUtils is a privacy-first desktop utility for checking which folders consume the most disk space.

It was created for people who want a folder size analyzer they can inspect, build, and run locally without having to trust opaque third-party installers.

• GitHub repository: https://github.com/onsenturk/FolderUtils
• Public docs site source: docs/
• License: see LICENSE

Why this exists

Many disk usage tools are distributed only as third-party binaries or installers. FolderUtils takes a simpler approach:

• local-only scanning
• no cloud dependency
• no telemetry
• open source code you can review yourself
• simple desktop UI with standard-library runtime dependencies only

Features

• Desktop UI built with the Python standard library (tkinter)
• Recursive folder size scanning
• Bounded multithreaded directory scanning for faster analysis on large trees
• Largest folders shown first within each level
• Summary metrics for total size, folders, files, skipped entries, and scan errors
• No external runtime dependencies for the app itself

Run from source

1. Install Python 3.11 or newer.
2. From the repository root, run:
   • python -m folderutils
3. Pick a folder and click Scan.

Build a Windows executable

FolderUtils now includes a reproducible Windows packaging setup.

1. Activate your virtual environment.
2. Run:
   • powershell -NoProfile -ExecutionPolicy Bypass -File scripts/build_windows.ps1
3. The packaged app will be created in:
   • dist/FolderUtils/FolderUtils.exe
4. A zip archive for sharing will also be created in dist/.

Public-facing documents

• Product overview and Netlify-ready static docs: docs/
• Distribution guide: DISTRIBUTION.md
• Privacy policy: PRIVACY.md
• End User License Agreement: EULA.md
• License: LICENSE

Tests

Run:

• python -m unittest discover -s tests

Project structure

• folderutils/application — input validation and orchestration
• folderutils/domain — core models and scanner contract
• folderutils/infrastructure — local file system scanner and logging setup
• folderutils/ui — desktop interface
• docs — public documentation site for static hosting on Netlify
• scripts — local build automation
• tests — unit tests
• infra — placeholder Azure IaC file documenting that no cloud resources are needed