rclone/docs/content/commands/rclone_ncdu.md

90 lines
2.9 KiB
Markdown
Raw Normal View History

---
title: "rclone ncdu"
description: "Explore a remote with a text based user interface."
slug: rclone_ncdu
url: /commands/rclone_ncdu/
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/ncdu/ and as part of making a release run "make commanddocs"
---
# rclone ncdu
Explore a remote with a text based user interface.
## Synopsis
This displays a text based user interface allowing the navigation of a
remote. It is most useful for answering the question - "What is using
all my disk space?".
{{< asciinema 157793 >}}
2018-03-19 10:06:13 +00:00
To make the user interface it first scans the entire remote given and
builds an in memory representation. rclone ncdu can be used during
this scanning phase and you will see it building up the directory
structure as it goes along.
2022-07-09 17:08:20 +00:00
You can interact with the user interface using key presses,
press '?' to toggle the help on and off. The supported keys are:
↑,↓ or k,j to Move
→,l to enter
←,h to return
c toggle counts
g toggle graph
2021-02-02 13:42:35 +00:00
a toggle average size in directory
2021-11-01 15:42:05 +00:00
u toggle human-readable format
2021-02-02 13:42:35 +00:00
n,s,C,A sort by name,size,count,average size
2018-11-24 13:44:25 +00:00
d delete file/directory
2022-07-09 17:08:20 +00:00
v select file/directory
V enter visual select mode
D delete selected files/directories
2021-07-20 18:45:41 +00:00
y copy current path to clipboard
2019-08-26 14:25:20 +00:00
Y display current path
2022-07-09 17:08:20 +00:00
^L refresh screen (fix screen corruption)
? to toggle help on and off
2022-07-09 17:08:20 +00:00
q/ESC/^c to quit
Listed files/directories may be prefixed by a one-character flag,
some of them combined with a description in brackes at end of line.
These flags have the following meaning:
e means this is an empty directory, i.e. contains no files (but
may contain empty subdirectories)
~ means this is a directory where some of the files (possibly in
subdirectories) have unknown size, and therefore the directory
size may be underestimated (and average size inaccurate, as it
is average of the files with known sizes).
. means an error occurred while reading a subdirectory, and
therefore the directory size may be underestimated (and average
size inaccurate)
! means an error occurred while reading this directory
This an homage to the [ncdu tool](https://dev.yorhel.nl/ncdu) but for
2018-11-24 13:44:25 +00:00
rclone remotes. It is missing lots of features at the moment
but is useful as it stands.
2022-07-09 17:08:20 +00:00
Note that it might take some time to delete big files/directories. The
2018-11-24 13:44:25 +00:00
UI won't respond in the meantime since the deletion is done synchronously.
2022-07-09 17:08:20 +00:00
For a non-interactive listing of the remote, see the
[tree](/commands/rclone_tree/) command. To just get the total size of
the remote you can also use the [size](/commands/rclone_size/) command.
```
2017-09-30 13:19:47 +00:00
rclone ncdu remote:path [flags]
```
## Options
2017-09-30 13:19:47 +00:00
```
-h, --help help for ncdu
```
See the [global flags page](/flags/) for global options not listed here.
## SEE ALSO
2018-10-15 10:03:08 +00:00
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.
2018-03-19 10:06:13 +00:00