Skip to main content

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

Project description

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
  • Unity Hub integration - Automatically discover and manage Unity projects:
    • Scan cache sizes for Unity projects
    • Interactive project selection
    • Targeted cache cleaning (Library, Temp, obj, Logs)
  • 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

From PyPI (Recommended)

pip install lazyscan

Using pipx (Recommended for isolated installation)

pipx install lazyscan

From GitHub (Latest development version)

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

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

Unity project management

# Scan and manage Unity projects
lazyscan --unity              # Auto-discover projects from Unity Hub
lazyscan --unity --no-unityhub  # Manual directory selection
lazyscan --unity --build-dir  # Include build directories in scan
lazyscan --unity --clean      # Clean Unity project caches

# Clean specific Unity cache types:
# a - All caches
# l - Library folder (preserves essential files)
# t - Temp folder
# o - obj folder
# g - Logs folder

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lazyscan-0.3.1.tar.gz (29.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lazyscan-0.3.1-py3-none-any.whl (30.2 kB view details)

Uploaded Python 3

File details

Details for the file lazyscan-0.3.1.tar.gz.

File metadata

  • Download URL: lazyscan-0.3.1.tar.gz
  • Upload date:
  • Size: 29.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for lazyscan-0.3.1.tar.gz
Algorithm Hash digest
SHA256 16b86a9bca5fd7607b21ad9568fa95a01a48f8d2bde4ac3af6624bd01fdd3a75
MD5 84e998735cd330c59edc129012afacc0
BLAKE2b-256 0efdee89eb352a5a3933e5596db64745f3e05dee22c5f822d8f753650b37dfa0

See more details on using hashes here.

File details

Details for the file lazyscan-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: lazyscan-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 30.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for lazyscan-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a7603c43697ac24bf8b25820fbbecc53e538ed2169c4ae3ee70d99da05ee3fe0
MD5 67273df0d1ff5360c0e8d69032b5ff76
BLAKE2b-256 0715fd5499d90e26cad82595f43248620bd167f5e68ebb821be5991e57e17aa4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page