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.0.tar.gz (29.5 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.0-py3-none-any.whl (30.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: lazyscan-0.3.0.tar.gz
  • Upload date:
  • Size: 29.5 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.0.tar.gz
Algorithm Hash digest
SHA256 ad514eb5b2916aa8e32dd058ccd7d6ab1c6a55a3ae1df4c283bc01822ad9b4e1
MD5 91511287245c76fe7a6e5c34a8faea1e
BLAKE2b-256 b521a74a5ccdac30bd6c6dbd53d732f43ef9c0afa9740536f7e04787427944f4

See more details on using hashes here.

File details

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

File metadata

  • Download URL: lazyscan-0.3.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 41c452443d67be3f106a32a7f49b38dda767d4d2562d4d4d13199ae2651bbb31
MD5 85ff2d841bea7604cbf640eb0a29a65e
BLAKE2b-256 4d4c3fb7f8f6aaee922f0b193cf6f7cf7e70744441b7b7ba4197d286488da2dd

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