Whatbox Logo

Wiki > NCurses Disk Usage

Intro

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.

It's aimed to be run on a remote server where you don't have an entire graphical setup, but have to do with a simple SSH connection. ncdu aims to be fast, simple and easy to use, and should be able to run in any minimal POSIX-like environment with ncurses installed.

Installation

  1. Download the latest source tarball

     wget https://dev.yorhel.nl/download/ncdu-2.0-linux-x86_64.tar.gz
    
  2. Extract the source executable

     tar xvzf ncdu-2.0-linux-x86_64.tar.gz
    
  3. Move the executable to your 'bin' directory:

     mkdir -p $HOME/bin; mv ncdu $HOME/bin/
    
  4. Remove the source tarball:

    rm ncdu-2.0-linux-x86_64.tar.gz
    

Usage

  1. Add the bin directory to your PATH (if you've done this previously, you do not need to do it again)

     echo "PATH=\$HOME/bin:\$PATH" >> ~/.bashrc && source ~/.bashrc
    
  2. Start the application

    To scan and browse the directory you're currently in:

     ncdu
    

    To scan and browse a specific directory:

     ncdu /path/to/directory
    
  3. For more usage examples and documentation check out: ncdu's documentation

Updating

To update NCurses Disk Usage, follow the installation steps again using the latest version.