Skip to main content

Directory summary tool.

Project description


Summarize a directory recursively by file size. This tool can be used to quickly search a drive for large files taking up too much space.


Install the current PyPI release:

pip install dirsum

Or install from source:

pip install git+


# Run the dirsum command to summarize a directory
dirsum <path-to-directory>

# Specify the minimum file size (default is 1GB)
dirsum <path-to-directory> --size 750MB
dirsum <path-to-directory> --size 50KB

# Print full absolute paths to directories instead of directory names
dirsum <path-to-directory> --absolute

Example Output

# Summarize the /home/user/my_documents directory
# showing only directories greater than 20MB in size
dirsum /home/user/my_documents --size 20MB
|->  69.0 GB > my_documents
    |->  67.8 GB > movies
        |->  62.0 GB > from_the_internet
        |->   5.8 GB > home_movies
    |-> 638.1 MB > photos
        |-> 368.2 MB > rock_concert
        |-> 251.6 MB > vacation_2019
        |->  18.4 MB > family_photos
    |-> 521.6 MB > work
        |-> 263.8 MB > boring_docs
        |-> 257.7 MB > reports
    |->  22.5 MB > games

Project details

Download files

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

Files for dirsum, version 1.1.5
Filename, size File type Python version Upload date Hashes
Filename, size dirsum-1.1.5-py3-none-any.whl (8.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size dirsum-1.1.5.tar.gz (7.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page