biggest

Crates.iobiggest
lib.rsbiggest
version0.1.1
created_at2025-12-09 15:47:06.370175+00
updated_at2026-01-05 22:00:01.185046+00
descriptionFind out which program folders take up the most space.
homepagehttps://github.com/winkt0/biggest
repositoryhttps://github.com/winkt0/biggest
max_upload_size
id1975659
size15,352
(winkt0)

documentation

README

biggest

License: MIT Rust Version

Find out which program folders take up the most space.

Installation

From crates.io:

cargo install biggest

From GitHub:

cargo install --git https://github.com/winkt0/biggest

Or by cloning the project:

git clone https://github.com/winkt0/biggest
cd biggest
cargo install --path .

Usage

biggest

returns a list of the 10 biggest program folders along with their sizes found from within the current directory. If you wish to specify the number of results, you can do so using the optional argument --limit:

biggest --limit 20

returns a list of the 20 biggest program folders along with their sizes found from within the current directory. If you don't want to search in the current directory, you can also specify the path within which to search:

biggest --path "/home"

finds the 10 biggest folders contained within /home. Both arguments can also be combined:

biggest --path "/home" --limit 3

finds the 3 biggest folders within /home.

Output obtained by running biggest --help:

Find out which program folders take up the most space.

Usage: biggest [OPTIONS]

Options:
      --limit <LIMIT>  Only capture the biggest <LIMIT> folders [default: 10]
      --path <PATH>    Restrict search to folders within <PATH> [default: ./]
  -h, --help           Print help
  -V, --version        Print version

How does it work?

Since not all program folders are tracked by package managers (e.g. folders obtained using git clone), this program traverses all folders within your current directory and attempts to find those that are probably folders containing a program (or some sort of functional unit) by using the following heuristic:

  • Program folders typically contain folders named "SRC", "BIN", "LOGS", ".GIT"
  • Program folders typically contain files named "README", "LICENSE", "LOGS", "VERSION", "LAUNCHER", "SETTINGS", plus some file ending or other slight variation

These lists are of course not exhaustive, but have proven sufficient for my use cases.

Commit count: 10

cargo fmt