ncdu(1)                               ncdu manual                               ncdu(1)



NAME
       ncdu - NCurses Disk Usage


SYNOPSIS
       ncdu [-hqvx] [--exclude PATTERN] [-X FILE] dir


DESCRIPTION
       ncdu  (NCurses Disk Usage) is a curses-based version of the well-known 'du', and
       provides a fast way to see what directories are using your disk space.


OPTIONS
       -h     Print a small help message

       -q     Quiet mode. While calculating disk space, ncdu will update the screen  10
              times a second by default, this will be decreased to once every 2 seconds
              in quiet mode. Use this feature to save  bandwidth  over  remote  connec‐
              tions.

       -r     Read-only mode. This will disable the built-in file deletion feature.

       -v     Print version.

       -x     Only  count files and directories on the same filesystem as the specified
              dir.

       --exclude PATTERN
              Exclude files that match PATTERN. This argument  can  be  added  multiple
              times to add more patterns.

       -X FILE, --exclude-from FILE
              Exclude  files  that  match any pattern in FILE. Patterns should be sepa‐
              rated by a newline.


KEYS
       ?      Show help + keys + about screen

       up, down j, k
              Cycle through the items

       right, enter, l
              Open selected directory

       left, <, h
              Go to parent directory

       n      Order by filename (press again for descending order)

       s      Order by filesize (press again for descending order)

       a      Toggle between showing disk usage and showing apparent size.

       d      Delete the selected file or directory. An error  message  will  be  shown
              when  the  contents of the directory do not match or do not exist anymore
              on the filesystem.

       t      Toggle dirs before files when sorting.

       g      Toggle between showing percentage, graph, both, or  none.  Percentage  is
              relative  to  the size of the current directory, graph is relative to the
              largest item in the current directory.

       e      Show/hide 'hidden' or 'excluded' files and directories. Please note  that
              even  though  you  can't  see  the hidden files and directories, they are
              still there and they are still included in the directory  sizes.  If  you
              suspect  that  the  totals shown at the bottom of the screen are not cor‐
              rect, make sure you haven't enabled this option.

       i      Show information about the current selected item.

       r      Refresh/recalculate the current directory.

       q      Quit


HARD LINKS
       Every disk usage analysis utility has its own way of (not) counting hard  links.
       There  does not seem to be any universally agreed method of handling hard links,
       and it is even inconsistent among  different  versions  of  ncdu.  This  section
       explains what each version of ncdu does.

       ncdu 1.5 and below does not support any hard link detection at all: each link is
       considered a separate inode and its size is counted for every link.  This  means
       that  the  displayed  directory  sizes  are incorrect when analyzing directories
       which contain hard links.

       ncdu 1.6 has basic hard link detection: When a link to a previously  encountered
       inode  is  detected,  the  link is considered to have a file size of zero bytes.
       Its size is not counted again, and the link is indicated in the  browser  inter‐
       face  with  a  'H' mark. The displayed directory sizes are only correct when all
       links to an inode reside within that directory. When this is not the  case,  the
       sizes  may  or  may  not be correct, depending on which links were considered as
       "duplicate" and which as "original". The indicated size of the topmost directory
       (that  is,  the  one specified on the command line upon starting ncdu) is always
       correct.

       ncdu 1.7 has improved hard link detection. Each file  that  has  more  than  two
       links  has  the  "H"  mark  visible  in the browser interface. Each hard link is
       counted exactly once for every directory it appears in. The  indicated  size  of
       each  directory  is  therefore,  correctly,  the  sum of the sizes of all unique
       inodes that can be found in that directory. Note, however,  that  this  may  not
       always be same as the space that will be reclaimed after deleting the directory,
       as some inodes may still be accessible from hard links outside it.


BUGS
       Directory hard links are not supported. They will not be detected as being  hard
       links, and will thus be scanned and counted multiple times.

       Some  minor glitches may appear when displaying filenames that contain multibyte
       or multicolumn characters.

       Please report any other bugs you may find at the bug tracker, which can be found
       on the web site at http://dev.yorhel.nl/ncdu


AUTHOR
       Written by Yoran Heling <projects@yorhel.nl>.


SEE ALSO
       du(1)



ncdu-1.8                              Nov 3, 2011                               ncdu(1)
