josephpaul0 / tdu

Top Disk Usage. You want to know what is using all your disk space ? This command-line tool estimates the disk space occupied by all files in a given path. It displays a sorted list of the biggest items. The estimation method is similar to the 'du -skx' command from GNU Coreutils package.

tdu - Top Disk Usage

This command-line tool estimates the disk space occupied by all files in a given path. It displays a sorted list of the biggest items. The estimation method is similar to the du -skx command from GNU Coreutils package.

Program usage

Usage: tdu [options] [directory]

  -b n           Number of big files shown (default 7)

  -l n           Number of depth1 items shown (default 15)

  --max          Show deepest and longest paths

  -o file        Export result to Ncdu JSON format
                 (https://dev.yorhel.nl/ncdu/jsonfmt)

  -e n           Number of empty directories shown (default 0)

  -d n           Number of access denied directories shown (default 0)

  -f n           Number of character and block devices shown (default 0)

  -t n           Number of sockets and named pipes shown (default 0)

  -s n           Number of file status errors shown (default 0)

  --human        Print sizes in human readable format (default yes)
  --human=false  Print sizes in kilobytes
  --consolemax   Maximize console window (on Windows only, default no)
  --version      Program info and usage
  --license      Show the GNU General Public License V2
  --help         Program help

Quick start guide for end users

• If you just want to use the program on Linux or Windows x86-64, then you can download a ready-to-run binary at https://bitbucket.org/josephpaul0/tdu/downloads/
• On the "Downloads" page, you will find packages for:
  • Linux (386, Amd64, Armv6), including Raspberry Pi.
  • Windows 7, 8, 10 (386, Amd64)
  • FreeBSD (386, Amd64)

Quick start guide for advanced users / developers

• You need a Go compiler
• Do not use Go v1.12 or v1.12.1 on Windows, because of this issue: golang/go#30883
• Clone the git repository or download the source archive.
• Run 'make' or 'build.cmd' to build the binary

Other Operating Systems

• If you use FreeBSD or macOS, please test the code and submit patches for supporting those operating systems.

Project information:

• Author: Joseph Paul
• Homepage: https://github.com/josephpaul0/tdu
• License: GNU General Public Licence version 2.

Screenshot

tdu's Issues

Fail to build on OS X

There is an error while building tdu for OS X.

# github.com/josephpaul0/tdu
./tdu.go:154:18: too many arguments in call to getTtyWidth
	have (*s_scan)
	want ()
./tdu.go:848:9: assignment mismatch: 2 variables but osInit returns 1 values
./tdu.go:867:7: too many arguments in call to osEnd
./tdu_generic.go:35:18: undefined: sc_scan

I've made a Homebrew package for tdu, and the error is reported by Homebrew CI - https://github.com/abitrolly/homebrew-tap/runs/3234326039#step:8:30

Bug in Ncdu Export if filename contains a double quote

When exporting to Ncdu's JSON format, the double quotes in file names are not escaped. JSON format is then invalid.
Example: filename is "Haddaway - What Is Love (7" Mix).lrc"

`-human` by default

It would be nice to have all sizes in human readable format by default as more users are going to invoke it interactively rather than trying to get machine readable format.

Add an option to disable "Windows Console maximized" feature

https://bitbucket.org/josephpaul0/tdu/issues/4/