Hugefile Finder

A fast, beautiful Windows desktop application to scan your hard drives for large files (1GB+) and manage them.

Features

• Fast Scanning - Background thread scanning using os.scandir for maximum speed
• Multi-Drive Support - Select which drives to scan (auto-detected)
• Customizable Threshold - Set minimum file size from 1GB to 100GB
• Real-Time Results - Files appear in the table as they're found
• Sortable Columns - Click any column header to sort
• Delete Files - Permanent delete or move to Recycle Bin
• Open Directory - Quick access to file locations
• Export to CSV - Save scan results for later analysis
• Modern UI - Clean, professional black & gold themed interface

Installation

Option 1: Standalone EXE (Recommended)

1. Download the latest release from Releases
2. Run HugefileFinder.exe - no installation required

Option 2: From Source

1. Clone or download this repository
2. Install dependencies:

pip install -r requirements.txt

3. Run the application:

python main.py

Usage

1. Launch the app
2. Select drives you want to scan (C: is selected by default)
3. Set minimum file size using the slider or spinbox (default: 1 GB)
4. Click "Start Scan" - results appear in real-time
5. Filter results using the search box or extension dropdown
6. Delete files by selecting them and clicking "Delete Selected"
7. Open directories by selecting files and clicking "Open Folder"
8. Export results to CSV for further analysis

Project Structure

Hugefile Finder/
├── main.py              # Main application window and UI
├── scanner.py           # Background drive scanner (QThread)
├── table_model.py       # Sortable/filterable table model
├── delete_utils.py      # Delete worker (permanent + recycle bin)
├── delete_dialog.py     # Delete progress dialog
├── icon.svg             # Application icon
├── icon-*.png           # Button icons
├── requirements.txt     # Python dependencies
└── README.md            # This file

How It Works

Scanning

• Uses os.walk() with os.scandir for fast directory traversal
• Runs in a background QThread to keep the UI responsive
• Emits signals as files are found for real-time UI updates
• Supports stopping the scan at any time

Table Model

• Custom QAbstractTableModel for efficient large dataset handling
• Supports sorting, filtering, and extension-based grouping
• Updates incrementally as files are discovered

Deletion

• Permanent Delete: Instantly removes files using os.remove()
• Recycle Bin: Moves files to Recycle Bin using send2trash library
• Confirmation dialog before deletion
• Progress tracking with error reporting

Technical Details

Dependencies

• PyQt6 - Modern Qt6-based GUI framework
• send2trash - Cross-platform recycle bin support

Architecture

MainWindow (UI Controller)
    ├── DriveScanner (QThread) ──> scans drives, emits FileFound signals
    ├── HugefileTableModel ──> stores and filters file data
    ├── DeleteWorker (QThread) ──> handles file deletion
    └── DeleteProgressDialog ──> shows deletion progress

Troubleshooting

App doesn't start

• Ensure Python 3.8+ is installed: python --version
• Reinstall dependencies: pip install -r requirements.txt

No drives detected

• Run the app as Administrator to access all drives
• Check that drives are accessible (not network drives)

Scan is slow

• Select fewer drives
• Increase the minimum file size threshold
• Some drives may have many small files to check

Permission errors during scan

• Some system folders require admin access
• These are skipped automatically

Permission errors during delete

• Some files may be in use or require elevated permissions
• Try running as Administrator

License

MIT License

Copyright (c) 2025 GadatheGod

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Acknowledgments

• Built with PyQt6
• Delete support via send2trash
• Inspired by the need to find those pesky gigabyte-sized files hiding in folders