A modern Windows 11 disk space analyzer built with Electron, React, and TypeScript. Find out where all your free space has gone and reclaim it with confidence.
- Real-time Progress Updates: Watch as folders are discovered during scanning
- Non-blocking UI: Continue working while scans run in the background
- Multi-drive Support: Scan any drive on your system
- Bar Charts: See your largest folders at a glance
- File Type Breakdown: Understand what types of files are consuming space
- Interactive UI: Sort, filter, and search through results
- Confirmation Dialogs: Double-check before deleting
- Recycle Bin Option: Recover files if you change your mind
- Safety Checks: Protection against deleting system folders
- File Type Filtering: Focus on images, videos, documents, and more
- Search Functionality: Find specific folders instantly
- Responsive Design: Works on various screen sizes
- Dark Theme: Easy on the eyes for long scanning sessions
# Install dependencies
npm install
# Start development server
npm run dev
# Start Electron app
npm run electron:dev# Build the application
npm run build
# Create Windows installer
npm run electron:build- Launch FreeSpaceHunter
- Select a drive from the dropdown
- Click "Start Scan" to begin
- Watch as folders are discovered in real-time
- Click on folders to expand and see subfolders
- Use filters and search to find specific content
- Review folder sizes in the list
- Check visualizations for overview
- Click the trash icon to delete a folder
- Choose to move to Recycle Bin or delete permanently
- Confirm your choice in the dialog
| Shortcut | Action |
|---|---|
Ctrl+F |
Focus search |
Ctrl+R |
Refresh scan |
Escape |
Close dialogs |
FreeSpaceHunter/
├── src/
│ ├── main/ # Electron main process
│ │ ├── index.ts # App entry point
│ │ ├── ipc-handler.ts # IPC communication
│ │ └── scanner-service.ts # File system scanning
│ ├── renderer/ # React UI
│ │ ├── components/ # UI components
│ │ ├── hooks/ # Custom React hooks
│ │ └── styles/ # CSS styles
│ └── preload/ # Electron preload script
├── public/ # Static assets
└── plans/ # Planning documents
- Electron: Desktop application framework
- React 18: UI library
- TypeScript: Type safety
- Vite: Build tool
- D3.js: Data visualization
- Lucide React: Icons
- Electron Builder: Package distribution
The following system directories are protected from deletion:
C:\WindowsC:\Program FilesC:\Program Files (x86)C:\ProgramData- System volume information
- Recycle Bin
- Confirmation required for all deletions
- Large folders (>1GB) show additional warnings
- Move to Recycle Bin option for recovery
- Detailed folder information before deletion
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
MIT License - feel free to use and modify for personal or commercial purposes.
For issues and feature requests, please use the GitHub issue tracker.
Built with ❤️ for Windows 11 users who want to understand and manage their disk space.