A comprehensive file and folder analysis tool that helps you understand disk usage, identify large files, and optimize storage space. Available in both desktop (Tkinter) and web (Streamlit) versions.
- Folder Size Analysis: Scan and analyze folder contents recursively
- File Type Categorization: Automatically categorize files by type (Documents, Images, Videos, Audio, Archives, Code)
- Size Filtering: Filter files by size range (GB/MB/KB)
- Date Filtering: Filter files by creation/modification date
- Search Functionality: Search files by name or extension
- Drag & Drop Support: Easily drop folders for analysis
- Excel Export: Detailed reports with multiple worksheets
- PDF Export: Professional reports with charts and statistics
- HTML Export: Interactive web reports with visualizations
- Interactive Charts: Pie charts, bar graphs, and trend analysis
- File Type Distribution: Visual breakdown of file categories
- Size Distribution: Histograms and size analysis charts
- Optimization Suggestions: Compression recommendations with space savings
- Compression Analysis: Calculate potential space savings
- File Optimization Suggestions: Recommendations for different file types
- Storage Optimization Report: Detailed optimization strategies
pandas>=1.5.0
openpyxl>=3.0.0
fpdf>=1.7.2
matplotlib>=3.5.0
seaborn>=0.11.0
numpy>=1.21.0
tkinterdnd2>=0.3.0
pyinstaller>=5.0.0
streamlit>=1.28.0
plotly>=5.15.0
Download the latest release from GitHub:
- Go to Releases
- Download
FileSizeAnalyzer-v1.0.0-Windows.zip - Extract and run
FileSizeAnalyzer.exe - No installation required - portable application
-
Clone the repository:
git clone <repository-url> cd noob-folder-analyzer
-
Start with Docker:
# Smart Docker (Recommended - Auto-detects available drives) start_docker_smart.bat .\start_docker_smart.ps1 # Manual Docker start_docker.bat .\start_docker.ps1 docker-compose up --build
-
Open in browser:
http://localhost:8501
-
Clone the repository:
git clone <repository-url> cd noob-folder-analyzer
-
Install dependencies:
pip install -r requirements.txt
Simply run FileSizeAnalyzer.exe - no installation required!
Run the desktop version with a graphical user interface:
python main.pyFeatures:
- Modern dark theme UI
- Drag & drop folder selection
- Real-time filtering and search
- Export to Excel, PDF, and HTML
- Interactive charts and visualizations
Run the web version for browser-based access:
streamlit run streamlit_app.pyFeatures:
- Web-based interface accessible from any browser
- Interactive Plotly charts
- File upload and folder selection
- Export functionality
- Responsive design
Docker container'da Windows sürücülerinize erişmek için:
- C: sürücüsü:
/host/c/Users/YourName/Documents - D: sürücüsü:
/host/d/YourFolder - E: sürücüsü:
/host/e/YourFolder
Windows Path: C:\Users\YourName\Documents
Docker Path: /host/c/Users/YourName/Documents
- Docker Desktop'ın çalıştığından emin olun
- Windows sürücülerinizin erişilebilir olduğunu kontrol edin
- Detaylı bilgi için
DOCKER_README.mddosyasını inceleyin
- Desktop: Click "Select Folder" or drag & drop a folder
- Web: Use the folder input or upload files
- Docker: Use Docker path format (e.g.,
/host/c/Users/YourName/Documents)
- File Type Filter: Select specific file categories
- Size Filter: Set minimum and maximum file sizes
- Date Filter: Filter by file creation/modification dates
- Search Filter: Search for specific file names or extensions
- View file statistics and breakdowns
- Explore interactive charts and visualizations
- Review optimization suggestions
- Excel: Detailed spreadsheet with multiple worksheets
- PDF: Professional report with charts and analysis
- HTML: Interactive web report
The tool automatically categorizes files into the following types:
- Documents: PDF, DOC, DOCX, TXT, RTF, ODT
- Images: JPG, JPEG, PNG, GIF, BMP, TIFF, SVG
- Videos: MP4, AVI, MKV, MOV, WMV, FLV, WEBM
- Audio: MP3, WAV, FLAC, AAC, OGG, WMA
- Archives: ZIP, RAR, 7Z, TAR, GZ, BZ2
- Code: PY, JS, HTML, CSS, JAVA, CPP, C, PHP
The tool provides optimization suggestions for different file types:
- Images: JPEG quality reduction, WebP conversion, PNG optimization
- Videos: H.264/H.265 compression, AV1 codec, WebM conversion
- Documents: PDF compression, ZIP/7-Zip archiving
- Audio: MP3/AAC compression, OGG Vorbis conversion
- Archives: 7-Zip LZMA2, ZIP deflate, RAR5 compression
- Code: Minification, Gzip/Brotli compression
- Estimates potential space savings for each optimization method
- Provides percentage-based compression ratios
- Calculates total potential savings across all files
- Summary Sheet: Overview of folder analysis
- File Details: Complete file listing with metadata
- Category Analysis: Breakdown by file type
- Size Distribution: Size range analysis
- Optimization Report: Compression suggestions and savings
- Professional Layout: Clean, formatted report
- Charts and Graphs: Visual representations of data
- Optimization Recommendations: Detailed suggestions
- File Statistics: Comprehensive file information
- Interactive Charts: Plotly-based visualizations
- Responsive Design: Works on desktop and mobile
- Exportable Data: Download data in various formats
- Modern UI: Clean, professional appearance
The Streamlit version includes Docker support for cross-platform compatibility:
# Build Docker image
docker build -t file-size-analyzer .
# Run container
docker run -p 8501:8501 file-size-analyzer- Multi-category Selection: Select multiple file types
- Size Presets: Quick size range selection (Small, Medium, Large)
- Date Presets: Recent files (Today, Week, Month, Year)
- Custom Ranges: Set custom size and date ranges
- File Name Search: Search by exact or partial file names
- Extension Search: Filter by specific file extensions
- Case Insensitive: Search works regardless of case
- Real-time Results: Instant search results as you type
- Efficient Scanning: Optimized folder traversal
- Memory Management: Handles large folders efficiently
- Progress Tracking: Real-time progress updates
- Error Handling: Graceful handling of permission errors
-
Permission Errors
- Ensure you have read access to the selected folder
- Run as administrator if needed (Windows)
-
Missing Dependencies
- Install all requirements:
pip install -r requirements.txt - Update pip:
python -m pip install --upgrade pip
- Install all requirements:
-
Large Folder Analysis
- For very large folders, analysis may take time
- Use filters to reduce analysis scope
- Consider running during off-peak hours
-
Export Issues
- Ensure sufficient disk space for exports
- Close any open Excel files before exporting
- Check file permissions in export directory
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
For issues, questions, or feature requests:
- Create an issue on GitHub
- Check the troubleshooting section
- Review the documentation
Made with ❤️ for efficient file management and storage optimization