Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aleksaan/diskusage

Duck is a very fast utility to find largest directories or files
https://github.com/aleksaan/diskusage

analyzes biggest command-line command-line-tool depth directories disk disk-space disk-usage diskusage files folder folders largest size top usage utility

Last synced: 3 months ago
JSON representation

Duck is a very fast utility to find largest directories or files

Host: GitHub
URL: https://github.com/aleksaan/diskusage
Owner: aleksaan
License: mit
Created: 2018-03-29T11:32:49.000Z (almost 7 years ago)
Default Branch: master
Last Pushed: 2022-09-07T16:11:01.000Z (over 2 years ago)
Last Synced: 2024-08-01T05:20:28.132Z (5 months ago)
Topics: analyzes, biggest, command-line, command-line-tool, depth, directories, disk, disk-space, disk-usage, diskusage, files, folder, folders, largest, size, top, usage, utility
Language: Go
Homepage:
Size: 24 MB
Stars: 97
Watchers: 4
Forks: 13
Open Issues: 3
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

jimsghstars - aleksaan/diskusage - Duck is a very fast utility to find largest directories or files (Go)

README

# DUCK - (D)isk(U)sage(CK)
Duck is a very fast utility to find largest directories or files

Illustrator: Ekaterina [[t.me/@kateUV](https://t.me/kateUV)]

## To Elon Musk
I hope you will see it and I have couple of quite well ideas to chat them with you.

Write to [[t.me/@AngryMuscle](https://t.me/AngryMuscle)]

## Features
- Gathers directories/files sizes
- Finds top of largest directories/files
- Very fast
- JSON compatible (for a service using)
- Human readable mode of output (for a console using)
- More accuracy than FAR manager

## Releases
Releases available as single executable files – just [download latest release](https://github.com/aleksaan/diskusage/releases) for your platform, unpack and run.

## How it works
Since version **2.8.0** utility has a two parts:
- ```Duck_a``` duck says **analyse**
- ```Duck_f``` duck says **find**

```Duck_a``` gathers sizes of all directories and files under specific path.
```Duck_f``` takes results of ```Duck_a``` and looks for top of largest objects among them.

You can scanning 1Tb disk only once by ```Duck_a``` (*some minutes*) and then many times finds largest objects by ```Duck_f``` with different parameters (*some milliseconds*).

## ```Duck_a``` utility

```Duck_a``` calculates sizes of directories and files.

**Parameters**:
- ```-path=c:\temp``` - starting point to analyse
- ```-hr``` - human readable results representation (text format), if omit that means JSON format
- ```-hrrows``` - how many rows will be printed in a human readable mode (default - 50)

By default program outputs results to ```console```.

**Example a.1**. Scanning from c:\temp and saving results in JSON format to ```results_a.txt```

```duck_a.exe -path c:\temp\ > .\results_a.txt```

**Example a.2**. Scanning from c:\temp and output results in human readable format to ```console```

```duck_a.exe -path c:\temp\ -hr```

## ```Duck_f``` utility

```Duck_f``` takes results of ```Duck_a```, iterates over them and finds top largest directories or files

**Parameters**:
- ```-top=20``` - how much directories or files will be founded
- ```-depth=2``` - depth of analysis inside of results ```Duck_a```
- ```-filter=df``` - filter by objects types (```f``` - files only, ```d``` - directories only, ```df``` - both of them)
- ```-size=c``` - method of calculating directories size (```c``` clean size (excludes sizes of subdirectories) or ```f``` - full size (inludes subdirectories))
- ```-path=abc``` - not the same what this parameters means in ```duck_a```. It's a filter by part of the path (will be outputed all rows which path includes this one)
- ```-hr``` - human readable results representation (text format), if omit that will be JSON format

By default program outputs results to ```console```.

**Example f.1**. Searching top-10 largest directories or files on depth 2 and outputing results as JSON to file

```duck_f.exe -depth=2 -size=c -top=10 -filter=df < .\results_a.txt > .\results_f.txt```

**Example f.2**. Searching top-12 largest directories or files on depth 3 and outputing results in human readable format to ```console```

```duck_f.exe -depth=3 -size=c -top=12 -filter=d -hr < .\results_a.txt```

**Example f.3**. Like as ```Example f.2``` but with filtering by path of file (for example, print only dir or files contains `.git` in their path & names)

```duck_f.exe -depth=2 -size=c -top=12 -filter=d -path=.git -hr < .\results_a.txt```

**Note about ```FULL SIZE``` and ```CLEAN SIZE```**

For example, if you have directories:
- ```A (100Mb)\B (70Mb)\C (60Mb)```

then ```CLEAN SIZE``` of these dirs will be:
- ```A``` - ```30Mb``` (excluded size of ```B```)
- ```B``` - ```10Mb``` (excluded size of ```C```)
- ```C``` - ```60Mb``` (the same as ```FULL SIZE``` because no any subdirs inside)