lazyscan 0.2.0

A lazy way to find what's eating your disk space - by TheLazyIndianTechie

lazyscan 🚀

A lazy way to find what's eating your disk space - now with powerful cache cleaning!

Created by TheLazyIndianTechie - for the lazy developer in all of us.

Features

• Fast disk scanning - Find the biggest files in any directory
• Visual progress bars - See file sizes at a glance with cyberpunk-style bars
• Interactive mode - Too lazy to type paths? Use -i to select directories
• macOS cache cleaner - Clean system caches with --macos
• App-specific cleaners - Clean caches for:
  • Chrome (--chrome)
  • Safari (--safari)
  • Firefox (--firefox)
  • Slack (--slack)
  • Discord (--discord)
  • Spotify (--spotify)
  • VS Code (--vscode)
  • Zoom (--zoom)
  • Microsoft Teams (--teams)
  • Perplexity AI (--perplexity)
  • Dia (--dia)

Installation

Method 1: Using pipx (Recommended for macOS/Linux)

# Install pipx if you haven't already
brew install pipx  # macOS
# or
sudo apt install pipx  # Ubuntu/Debian
# or
python3 -m pip install --user pipx  # Other systems

# Ensure pipx is in PATH
pipx ensurepath

# Install lazyscan
pipx install git+https://github.com/TheLazyIndianTechie/lazyscan.git

Method 2: Using pip

pip install git+https://github.com/TheLazyIndianTechie/lazyscan.git

Method 3: Direct download (no installation needed)

# Download the script
curl -O https://raw.githubusercontent.com/TheLazyIndianTechie/lazyscan/main/lazyscan.py

# Make it executable
chmod +x lazyscan.py

# Run it
python3 lazyscan.py

Method 4: Clone and install

git clone https://github.com/TheLazyIndianTechie/lazyscan.git
cd lazyscan
pipx install .  # or pip install .

Usage

Basic disk scanning

# Scan current directory
lazyscan

# Scan specific directory
lazyscan ~/Downloads

# Interactive directory selection
lazyscan -i

# Show top 10 files instead of 20
lazyscan -n 10

# Hide the logo
lazyscan --no-logo

Cache cleaning (macOS only)

# Clean macOS system caches
lazyscan --macos

# Clean specific app caches
lazyscan --chrome    # Chrome browser
lazyscan --slack     # Slack
lazyscan --discord   # Discord
lazyscan --spotify   # Spotify
lazyscan --vscode    # VS Code
lazyscan --zoom      # Zoom (includes recorded meetings)

# Combine operations
lazyscan --macos ~/Downloads  # Clean cache then scan Downloads

Requirements

• Python 3.6 or higher
• macOS (for cache cleaning features)
• Terminal with color support (recommended)

Safety

• All cache cleaning operations show what will be deleted before proceeding
• User confirmation is required before any deletion
• Only known cache directories are cleaned
• User data (bookmarks, passwords, etc.) is preserved

Contributing

Feel free to open issues or submit pull requests on GitHub!

License

MIT License - feel free to use this in your own projects!

---

Made with 💜 by TheLazyIndianTechie