2016-10-04 21:30:48 +11:00
|
|
|
---
|
|
|
|
title: "rclone cat"
|
2020-05-17 00:11:55 +10:00
|
|
|
description: "Concatenates any files and sends them to stdout."
|
2016-10-04 21:30:48 +11:00
|
|
|
slug: rclone_cat
|
|
|
|
url: /commands/rclone_cat/
|
2022-12-21 04:16:14 +11:00
|
|
|
versionIntroduced: v1.33
|
2020-02-10 23:31:45 +11:00
|
|
|
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/cat/ and as part of making a release run "make commanddocs"
|
2016-10-04 21:30:48 +11:00
|
|
|
---
|
2020-05-22 20:17:37 +10:00
|
|
|
# rclone cat
|
2016-10-04 21:30:48 +11:00
|
|
|
|
|
|
|
Concatenates any files and sends them to stdout.
|
|
|
|
|
2020-05-22 20:17:37 +10:00
|
|
|
## Synopsis
|
2016-10-04 21:30:48 +11:00
|
|
|
|
|
|
|
|
|
|
|
rclone cat sends any files to standard output.
|
|
|
|
|
|
|
|
You can use it like this to output a single file
|
|
|
|
|
|
|
|
rclone cat remote:path/to/file
|
|
|
|
|
2020-02-11 02:07:40 +11:00
|
|
|
Or like this to output any file in dir or its subdirectories.
|
2016-10-04 21:30:48 +11:00
|
|
|
|
|
|
|
rclone cat remote:path/to/dir
|
|
|
|
|
2020-02-11 02:07:40 +11:00
|
|
|
Or like this to output any .txt files in dir or its subdirectories.
|
2016-10-04 21:30:48 +11:00
|
|
|
|
|
|
|
rclone --include "*.txt" cat remote:path/to/dir
|
|
|
|
|
2021-02-03 00:42:35 +11:00
|
|
|
Use the `--head` flag to print characters only at the start, `--tail` for
|
|
|
|
the end and `--offset` and `--count` to print a section in the middle.
|
2017-03-18 22:16:43 +11:00
|
|
|
Note that if offset is negative it will count from the end, so
|
2021-02-03 00:42:35 +11:00
|
|
|
`--offset -1 --count 1` is equivalent to `--tail 1`.
|
2017-03-18 22:16:43 +11:00
|
|
|
|
2023-04-24 21:01:53 +10:00
|
|
|
Use the `--separator` flag to print a separator value between files. Be sure to
|
|
|
|
shell-escape special characters. For example, to print a newline between
|
|
|
|
files, use:
|
|
|
|
|
|
|
|
* bash:
|
|
|
|
|
|
|
|
rclone --include "*.txt" --separator $'\n' cat remote:path/to/dir
|
|
|
|
|
|
|
|
* powershell:
|
|
|
|
|
|
|
|
rclone --include "*.txt" --separator "`n" cat remote:path/to/dir
|
|
|
|
|
2016-10-04 21:30:48 +11:00
|
|
|
|
|
|
|
```
|
2017-06-16 05:12:26 +10:00
|
|
|
rclone cat remote:path [flags]
|
2016-10-04 21:30:48 +11:00
|
|
|
```
|
|
|
|
|
2020-05-22 20:17:37 +10:00
|
|
|
## Options
|
2017-03-18 22:16:43 +11:00
|
|
|
|
|
|
|
```
|
2023-04-24 21:01:53 +10:00
|
|
|
--count int Only print N characters (default -1)
|
|
|
|
--discard Discard the output instead of printing
|
|
|
|
--head int Only print the first N characters
|
|
|
|
-h, --help help for cat
|
|
|
|
--offset int Start printing at offset N (or from end if -ve)
|
|
|
|
--separator string Separator to use between objects when printing multiple files
|
|
|
|
--tail int Only print the last N characters
|
2017-03-18 22:16:43 +11:00
|
|
|
```
|
|
|
|
|
2019-06-21 01:18:02 +10:00
|
|
|
See the [global flags page](/flags/) for global options not listed here.
|
|
|
|
|
2020-05-22 20:17:37 +10:00
|
|
|
## SEE ALSO
|
2016-10-04 21:30:48 +11:00
|
|
|
|
2018-10-15 21:03:08 +11:00
|
|
|
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.
|
2018-03-19 21:06:13 +11:00
|
|
|
|