2017-09-30 13:19:47 +00:00
|
|
|
---
|
|
|
|
title: "rclone tree"
|
2020-05-16 14:11:55 +00:00
|
|
|
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/
|
2023-08-02 09:02:38 +00:00
|
|
|
groups: Filter,Listing
|
2022-12-20 17:16:14 +00:00
|
|
|
versionIntroduced: v1.38
|
2020-02-10 12:31:45 +00:00
|
|
|
# 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
|
|
|
---
|
2020-05-22 10:17:37 +00:00
|
|
|
# rclone tree
|
2017-09-30 13:19:47 +00:00
|
|
|
|
|
|
|
List the contents of the remote in a tree like fashion.
|
|
|
|
|
2020-05-22 10:17:37 +00:00
|
|
|
## 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]
|
|
|
|
```
|
|
|
|
|
2020-05-22 10:17:37 +00:00
|
|
|
## 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
|
|
|
```
|
|
|
|
|
2023-08-02 09:02:38 +00:00
|
|
|
|
|
|
|
## Filter Options
|
|
|
|
|
|
|
|
Flags for filtering directory listings.
|
|
|
|
|
|
|
|
```
|
|
|
|
--delete-excluded Delete files on dest excluded from sync
|
|
|
|
--exclude stringArray Exclude files matching pattern
|
|
|
|
--exclude-from stringArray Read file exclude patterns from file (use - to read from stdin)
|
|
|
|
--exclude-if-present stringArray Exclude directories if filename is present
|
|
|
|
--files-from stringArray Read list of source-file names from file (use - to read from stdin)
|
|
|
|
--files-from-raw stringArray Read list of source-file names from file without any processing of lines (use - to read from stdin)
|
|
|
|
-f, --filter stringArray Add a file filtering rule
|
|
|
|
--filter-from stringArray Read file filtering patterns from a file (use - to read from stdin)
|
|
|
|
--ignore-case Ignore case in filters (case insensitive)
|
|
|
|
--include stringArray Include files matching pattern
|
|
|
|
--include-from stringArray Read file include patterns from file (use - to read from stdin)
|
|
|
|
--max-age Duration Only transfer files younger than this in s or suffix ms|s|m|h|d|w|M|y (default off)
|
|
|
|
--max-depth int If set limits the recursion depth to this (default -1)
|
|
|
|
--max-size SizeSuffix Only transfer files smaller than this in KiB or suffix B|K|M|G|T|P (default off)
|
|
|
|
--metadata-exclude stringArray Exclude metadatas matching pattern
|
|
|
|
--metadata-exclude-from stringArray Read metadata exclude patterns from file (use - to read from stdin)
|
|
|
|
--metadata-filter stringArray Add a metadata filtering rule
|
|
|
|
--metadata-filter-from stringArray Read metadata filtering patterns from a file (use - to read from stdin)
|
|
|
|
--metadata-include stringArray Include metadatas matching pattern
|
|
|
|
--metadata-include-from stringArray Read metadata include patterns from file (use - to read from stdin)
|
|
|
|
--min-age Duration Only transfer files older than this in s or suffix ms|s|m|h|d|w|M|y (default off)
|
|
|
|
--min-size SizeSuffix Only transfer files bigger than this in KiB or suffix B|K|M|G|T|P (default off)
|
|
|
|
```
|
|
|
|
|
|
|
|
## Listing Options
|
|
|
|
|
|
|
|
Flags for listing directories.
|
|
|
|
|
|
|
|
```
|
|
|
|
--default-time Time Time to show if modtime is unknown for files and directories (default 2000-01-01T00:00:00Z)
|
|
|
|
--fast-list Use recursive list if available; uses more memory but fewer transactions
|
|
|
|
```
|
|
|
|
|
2019-06-20 15:18:02 +00:00
|
|
|
See the [global flags page](/flags/) for global options not listed here.
|
|
|
|
|
2023-08-02 09:02:38 +00:00
|
|
|
# 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
|
|
|
|