rclone/docs/content/commands/rclone_tree.md

78 lines
2.5 KiB
Markdown
Raw Normal View History

2017-09-30 13:19:47 +00:00
---
title: "rclone tree"
description: "List the contents of the remote in a tree like fashion."
2017-09-30 13:19:47 +00:00
slug: rclone_tree
url: /commands/rclone_tree/
2022-12-20 17:16:14 +00:00
versionIntroduced: v1.38
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/tree/ and as part of making a release run "make commanddocs"
2017-09-30 13:19:47 +00:00
---
# rclone tree
2017-09-30 13:19:47 +00:00
List the contents of the remote in a tree like fashion.
## Synopsis
2017-09-30 13:19:47 +00:00
rclone tree lists the contents of a remote in a similar way to the
unix tree command.
For example
$ rclone tree remote:path
/
├── file1
├── file2
├── file3
└── subdir
├── file4
└── file5
2022-03-18 12:29:54 +00:00
2017-09-30 13:19:47 +00:00
1 directories, 5 files
2021-02-02 13:42:35 +00:00
You can use any of the filtering options with the tree command (e.g.
2022-07-09 17:08:20 +00:00
`--include` and `--exclude`. You can also use `--fast-list`.
2017-09-30 13:19:47 +00:00
The tree command has many options for controlling the listing which
2022-07-09 17:08:20 +00:00
are compatible with the tree command, for example you can include file
sizes with `--size`. Note that not all of them have
2017-09-30 13:19:47 +00:00
short options as they conflict with rclone's short options.
2022-07-09 17:08:20 +00:00
For a more interactive navigation of the remote see the
[ncdu](/commands/rclone_ncdu/) command.
2017-09-30 13:19:47 +00:00
```
rclone tree remote:path [flags]
```
## Options
2017-09-30 13:19:47 +00:00
```
2021-11-01 15:42:05 +00:00
-a, --all All files are listed (list . files too)
-d, --dirs-only List directories only
--dirsfirst List directories before files (-U disables)
--full-path Print the full path prefix for each file
2017-09-30 13:19:47 +00:00
-h, --help help for tree
2021-11-01 15:42:05 +00:00
--level int Descend only level directories deep
2017-09-30 13:19:47 +00:00
-D, --modtime Print the date of last modification.
2021-11-01 15:42:05 +00:00
--noindent Don't print indentation lines
--noreport Turn off file/directory count at end of tree listing
-o, --output string Output to file instead of stdout
2017-09-30 13:19:47 +00:00
-p, --protections Print the protections for each file.
-Q, --quote Quote filenames with double quotes.
-s, --size Print the size in bytes of each file.
2021-11-01 15:42:05 +00:00
--sort string Select sort: name,version,size,mtime,ctime
--sort-ctime Sort files by last status change time
-t, --sort-modtime Sort files by last modification time
-r, --sort-reverse Reverse the order of the sort
-U, --unsorted Leave files unsorted
--version Sort files alphanumerically by version
2017-09-30 13:19:47 +00:00
```
See the [global flags page](/flags/) for global options not listed here.
## SEE ALSO
2017-09-30 13:19:47 +00:00
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