DevSweep Desktop

Intelligent Storage Manager for Developer Machines

Features • Screenshots • Installation • Usage • Contributing • License

---

Overview

DevSweep Desktop is a powerful, cross-platform GUI application built with PySide6 that helps developers reclaim valuable disk space by intelligently detecting and cleaning up development artifacts. It provides a safe, user-friendly way to manage storage consumed by virtual environments, node_modules, build outputs, caches, and Docker resources.

Features

• Smart Scanning - Automatically detects developer artifacts across your system
• Python Environments - Find and clean .venv, venv, virtualenv, conda environments
• Node.js Projects - Detect node_modules directories consuming gigabytes of space
• Build Artifacts - Identify dist, build, target, __pycache__, .next, .nuxt folders
• Cache Cleanup - Locate .cache, .pip, .npm, .yarn cache directories
• Docker Management - View and manage Docker images, containers, and volumes
• Safe Deletion - Move items to DevSweep trash with restore capability
• Permanent Delete - Option to permanently delete items when confident
• Folder Browser - Analyze any folder to find large directories
• Theme Support - Light and dark themes with professional color scheme
• Fast Performance - Optimized scanning with background threading

Screenshots

Dev Artifacts

Browse Folder

Docker Cleanup

Trash Management

Multi Theme Support

Installation

Prerequisites

• Python 3.10 or higher
• pip (Python package manager)
• Docker (optional, for Docker management features)

Setup

1. Clone the repository

   git clone https://github.com/madnansultandotme/DevSweep.git
   cd DevSweep

2. Create virtual environment

   python -m venv venv

3. Activate virtual environment

   Windows:

   venv\Scripts\activate

   macOS/Linux:

   source venv/bin/activate

4. Install dependencies

   pip install -r requirements.txt

5. Run the application

   python main.py

Quick Start (Windows)

run.bat

Usage

Scanning for Artifacts

1. Click "Scan System" to scan common developer directories (Home, Projects, Documents)
2. Click "Scan Folder" to scan a specific directory
3. Click "Scan Storage" to scan entire drives

Cleaning Items

1. Review the scan results in the Dev Artifacts tab
2. Check items you want to clean (use "Select Safe Items" for recommended selections)
3. Click "Clean Selected"
4. Choose between:
   • Move to Trash - Items can be restored later
   • Delete Permanently - Items are removed forever

Browse Folders

1. Go to the Browse Folders tab
2. Select a folder to analyze
3. Set scan depth (1-3 levels)
4. Click Analyze to see folder sizes

Docker Management

1. Go to the Docker tab
2. View images, containers, and volumes
3. Remove unused items or run Prune System to clean all unused Docker resources

Trash Management

1. Go to the Trash tab
2. View items in DevSweep trash
3. Restore items or permanently delete them
4. Click Empty Trash to remove all items

Project Structure

DevSweep/
├── main.py                 # Application entry point
├── requirements.txt        # Python dependencies
├── run.bat                 # Windows quick launcher
├── images/
│   └── logo.png           # Application logo
├── screenshots/           # Application screenshots
├── docs/                  # Documentation
└── src/
    ├── __init__.py
    ├── database.py        # SQLite storage for scan results
    ├── scanner.py         # File system scanner
    ├── folder_analyzer.py # Folder size analyzer
    ├── cleaner.py         # Cleanup engine with trash support
    ├── docker_manager.py  # Docker CLI integration
    └── ui/
        ├── __init__.py
        ├── styles.py      # Theme system (light/dark)
        ├── icons.py       # Icon provider
        ├── widgets.py     # Custom Qt widgets
        ├── main_window.py # Main application window
        ├── scan_tab.py    # Scan results tab
        ├── browse_tab.py  # Folder browser tab
        ├── docker_tab.py  # Docker management tab
        └── trash_tab.py   # Trash management tab

Configuration

Trash Location

DevSweep trash is stored at:

• Windows: C:\Users\<username>\.devsweep_trash
• macOS/Linux: ~/.devsweep_trash

Database Location

Scan history is stored at:

• Windows: C:\Users\<username>\.devsweep\devsweep.db
• macOS/Linux: ~/.devsweep/devsweep.db

Tech Stack

• Python 3.10+ - Core language
• PySide6 - Qt6 bindings for GUI
• SQLite - Local database storage
• humanize - Human-readable file sizes

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Maintainer & Contact

• Email: info.adnansultan@gmail.com
• GitHub: madnansultandotme
• LinkedIn: dev-madnansultan

---

DevSweep

Helps developers reclaim valuable disk space.

Check it out on Product Hunt →

Made with ❤️ for developers who value clean workspaces