# LazyScan - A lazy way to find what's eating your disk space
[](https://badge.fury.io/py/lazyscan)
[](https://opensource.org/licenses/MIT)
## ⚠️ CRITICAL WARNING - USE AT YOUR OWN RISK ⚠️
### 🚨 THIS TOOL PERMANENTLY DELETES FILES 🚨
**LEGAL DISCLAIMER:**
- This tool will **PERMANENTLY DELETE** files from your system
- Deletions **CANNOT BE UNDONE**
- You accept **FULL RESPONSIBILITY** for any data loss
- The authors accept **NO LIABILITY** for any damages
- By using this software, you agree to **NOT SUE** or hold liable the authors
- **ALWAYS BACKUP YOUR DATA** before using this tool
**BY INSTALLING AND USING THIS SOFTWARE, YOU AGREE TO THE FULL [LEGAL DISCLAIMER](https://github.com/TheLazyIndianTechie/lazyscan/blob/main/DISCLAIMER.md)**
---
## Overview
LazyScan is a powerful disk space analyzer and cache cleaner for developers who want to reclaim disk space with minimal effort. Created by TheLazyIndianTechie.
## Features
- 🚀 **Fast Scanning** - Multi-threaded file system analysis
- 🎮 **Interactive Mode** - Select directories the lazy way
- 🧹 **macOS Cache Cleaning** - Clean system caches safely
- 🎯 **Unity Project Support** - Detect and clean Unity project caches
- 🌐 **Chrome Cache Cleaning** - Smart Chrome browser cache management
- 🎨 **Beautiful Output** - Cyberpunk-themed terminal interface
- 💾 **Multiple App Support** - Clean caches for Slack, Discord, VS Code, and more
## Installation
```bash
pip install lazyscan
```
## Quick Start
```bash
# Scan current directory
lazyscan
# Scan with interactive directory selection
lazyscan -i
# Clean macOS caches (BE CAREFUL!)
lazyscan --macos
# Clean Chrome browser cache
lazyscan --chrome
# Scan Unity projects via Unity Hub
lazyscan --unity
```
## Supported Cache Types
- **macOS System Caches**
- **Chrome Browser** (with profile support)
- **Unity Projects** (via Unity Hub integration)
- **Developer Tools**: VS Code, Xcode
- **Communication Apps**: Slack, Discord, Zoom, Teams
- **Browsers**: Safari, Firefox, Chrome
- **Package Managers**: Homebrew, npm
## Command Options
```
usage: lazyscan [-h] [-n TOP] [-w WIDTH] [-i] [--no-logo] [--macos] [--chrome]
[--unity] [--clean] [path]
Arguments:
path Directory to scan (default: current directory)
Options:
-n, --top Number of files to display (default: 20)
-w, --width Bar width in characters (default: 40)
-i, --interactive Interactive directory selection
--no-logo Hide the LazyScan logo
--macos Clean macOS cache directories
--chrome Clean Chrome browser cache
--unity Scan Unity projects via Unity Hub
--clean Auto-clean without prompting (use with caution!)
```
## Safety Features
- Categorizes data into "safe to delete" and "preserve"
- Interactive confirmation before any deletion
- Preserves user data, bookmarks, passwords
- Clear indication of what will be deleted
## System Requirements
- Python 3.6 or higher
- Works best on ANSI-compatible terminals
- macOS-specific features require macOS
- Unity features require Unity Hub
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License.
## Author
Created with 💜 by [TheLazyIndianTechie](https://github.com/TheLazyIndianTechie)
---
**⚠️ FINAL WARNING**: This tool deletes files permanently. Always backup your data first. Use at your own risk. The authors are not responsible for any data loss.
Raw data
{
"_id": null,
"home_page": "https://github.com/TheLazyIndianTechie/lazyscan",
"name": "lazyscan",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "disk space scanner cleaner cache macos terminal cli",
"author": "TheLazyIndianTechie",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/7a/21/7bcbbbd6cfc8850ff2578a8379b4dcacfa17184c10f93a2c96b7a68fbb93/lazyscan-0.4.2.tar.gz",
"platform": null,
"description": "# LazyScan - A lazy way to find what's eating your disk space\n\n[](https://badge.fury.io/py/lazyscan)\n[](https://opensource.org/licenses/MIT)\n\n## \u26a0\ufe0f CRITICAL WARNING - USE AT YOUR OWN RISK \u26a0\ufe0f\n\n### \ud83d\udea8 THIS TOOL PERMANENTLY DELETES FILES \ud83d\udea8\n\n**LEGAL DISCLAIMER:**\n- This tool will **PERMANENTLY DELETE** files from your system\n- Deletions **CANNOT BE UNDONE**\n- You accept **FULL RESPONSIBILITY** for any data loss\n- The authors accept **NO LIABILITY** for any damages\n- By using this software, you agree to **NOT SUE** or hold liable the authors\n- **ALWAYS BACKUP YOUR DATA** before using this tool\n\n**BY INSTALLING AND USING THIS SOFTWARE, YOU AGREE TO THE FULL [LEGAL DISCLAIMER](https://github.com/TheLazyIndianTechie/lazyscan/blob/main/DISCLAIMER.md)**\n\n---\n\n## Overview\n\nLazyScan is a powerful disk space analyzer and cache cleaner for developers who want to reclaim disk space with minimal effort. Created by TheLazyIndianTechie.\n\n## Features\n\n- \ud83d\ude80 **Fast Scanning** - Multi-threaded file system analysis\n- \ud83c\udfae **Interactive Mode** - Select directories the lazy way\n- \ud83e\uddf9 **macOS Cache Cleaning** - Clean system caches safely\n- \ud83c\udfaf **Unity Project Support** - Detect and clean Unity project caches\n- \ud83c\udf10 **Chrome Cache Cleaning** - Smart Chrome browser cache management\n- \ud83c\udfa8 **Beautiful Output** - Cyberpunk-themed terminal interface\n- \ud83d\udcbe **Multiple App Support** - Clean caches for Slack, Discord, VS Code, and more\n\n## Installation\n\n```bash\npip install lazyscan\n```\n\n## Quick Start\n\n```bash\n# Scan current directory\nlazyscan\n\n# Scan with interactive directory selection\nlazyscan -i\n\n# Clean macOS caches (BE CAREFUL!)\nlazyscan --macos\n\n# Clean Chrome browser cache\nlazyscan --chrome\n\n# Scan Unity projects via Unity Hub\nlazyscan --unity\n```\n\n## Supported Cache Types\n\n- **macOS System Caches**\n- **Chrome Browser** (with profile support)\n- **Unity Projects** (via Unity Hub integration)\n- **Developer Tools**: VS Code, Xcode\n- **Communication Apps**: Slack, Discord, Zoom, Teams\n- **Browsers**: Safari, Firefox, Chrome\n- **Package Managers**: Homebrew, npm\n\n## Command Options\n\n```\nusage: lazyscan [-h] [-n TOP] [-w WIDTH] [-i] [--no-logo] [--macos] [--chrome]\n [--unity] [--clean] [path]\n\nArguments:\n path Directory to scan (default: current directory)\n\nOptions:\n -n, --top Number of files to display (default: 20)\n -w, --width Bar width in characters (default: 40)\n -i, --interactive Interactive directory selection\n --no-logo Hide the LazyScan logo\n --macos Clean macOS cache directories\n --chrome Clean Chrome browser cache\n --unity Scan Unity projects via Unity Hub\n --clean Auto-clean without prompting (use with caution!)\n```\n\n## Safety Features\n\n- Categorizes data into \"safe to delete\" and \"preserve\"\n- Interactive confirmation before any deletion\n- Preserves user data, bookmarks, passwords\n- Clear indication of what will be deleted\n\n## System Requirements\n\n- Python 3.6 or higher\n- Works best on ANSI-compatible terminals\n- macOS-specific features require macOS\n- Unity features require Unity Hub\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License.\n\n## Author\n\nCreated with \ud83d\udc9c by [TheLazyIndianTechie](https://github.com/TheLazyIndianTechie)\n\n---\n\n**\u26a0\ufe0f FINAL WARNING**: This tool deletes files permanently. Always backup your data first. Use at your own risk. The authors are not responsible for any data loss.\n",
"bugtrack_url": null,
"license": null,
"summary": "A lazy way to find what's eating your disk space - by TheLazyIndianTechie",
"version": "0.4.2",
"project_urls": {
"Bug Tracker": "https://github.com/TheLazyIndianTechie/lazyscan/issues",
"Homepage": "https://github.com/TheLazyIndianTechie/lazyscan",
"Source Code": "https://github.com/TheLazyIndianTechie/lazyscan"
},
"split_keywords": [
"disk",
"space",
"scanner",
"cleaner",
"cache",
"macos",
"terminal",
"cli"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c60f097d39ea828fc08e1de4c5a3d6a3cd8a4a33de16d740c057bc24e82d570e",
"md5": "2e402379e8e0c4b6080c8971e41e9f31",
"sha256": "875b350fb5ba2509d19d2781578b9b110ea442cb4da89ea82bfc3960c2029fac"
},
"downloads": -1,
"filename": "lazyscan-0.4.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2e402379e8e0c4b6080c8971e41e9f31",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 32953,
"upload_time": "2025-07-31T08:32:11",
"upload_time_iso_8601": "2025-07-31T08:32:11.269500Z",
"url": "https://files.pythonhosted.org/packages/c6/0f/097d39ea828fc08e1de4c5a3d6a3cd8a4a33de16d740c057bc24e82d570e/lazyscan-0.4.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7a217bcbbbd6cfc8850ff2578a8379b4dcacfa17184c10f93a2c96b7a68fbb93",
"md5": "cecef678f0bfca5cbd9eec07e3916066",
"sha256": "6671fb7948a8891773fac7765d18a7867e12d4fda99dbc52b52ade71f1c82893"
},
"downloads": -1,
"filename": "lazyscan-0.4.2.tar.gz",
"has_sig": false,
"md5_digest": "cecef678f0bfca5cbd9eec07e3916066",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 33102,
"upload_time": "2025-07-31T08:32:12",
"upload_time_iso_8601": "2025-07-31T08:32:12.599184Z",
"url": "https://files.pythonhosted.org/packages/7a/21/7bcbbbd6cfc8850ff2578a8379b4dcacfa17184c10f93a2c96b7a68fbb93/lazyscan-0.4.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-31 08:32:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "TheLazyIndianTechie",
"github_project": "lazyscan",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "lazyscan"
}
JSON
