---
name: "roc-copy"
section: "1"
platform: "linux"
package: "roc-toolkit"
version: "0.4.0-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/roc-copy"
---

# roc-copy(1)

copy local audio

## NAME

roc-copy - copy local audio

## SYNOPSIS

**roc-copy** *OPTIONS*

## DESCRIPTION

Read audio stream from a file, transform it, and and write it to a another file.

### Options

- **-h, --help**

  Print help and exit

- **-V, --version**

  Print version and exit

- **-v, --verbose**

  Increase verbosity level (may be used multiple times)

- **-L, --list-supported**

  list supported schemes and formats

- **-i,***--input**=*****FILE\_URI**

  Input file URI

- **-o,***--output**=*****FILE\_URI**

  Output file URI

- **--input-format=***FILE\_FORMAT*

  Force input file format

- **--output-format=***FILE\_FORMAT*

  Force output file format

- **--frame-len=***TIME*

  Duration of the internal frames, TIME units

- **-r,***--rate**=*****INT**

  Output sample rate, Hz

- **--resampler-backend=***ENUM*

  Resampler backend  (possible values="default", "builtin", "speex", "speexdec" default=\`default')

- **--resampler-profile=***ENUM*

  Resampler profile  (possible values="low", "medium", "high" default=\`medium')

- **--profiling**

  Enable self profiling  (default=off)

- **--color=***ENUM*

  Set colored logging mode for stderr output (possible values="auto", "always", "never" default=\`auto')

### File URI

**--input** and **--output** options require a file URI in one of the following forms:

- •

  **file:///ABS/PATH** -- absolute file path

- •

  **file://localhost/ABS/PATH** -- absolute file path (alternative form; only "localhost" host is supported)

- •

  **file:/ABS/PATH** -- absolute file path (alternative form)

- •

  **file:REL/PATH** -- relative file path

- •

  **file://-** -- stdout

- •

  **file:-** -- stdout (alternative form)

Examples:

- •

  **file:///home/user/test.wav**

- •

  **file://localhost/home/user/test.wav**

- •

  **file:/home/user/test.wav**

- •

  **file:./test.wav**

- •

  **file:-**

The list of supported file formats can be retrieved using **--list-supported** option.

If the **--output** is omitted, the conversion results are discarded.

The **--input-format** and **--output-format** options can be used to force the file format. If the option is omitted, the file format is auto-detected. This option is always required for stdin or stdout.

The path component of the provided URI is *percent-decoded*. For convenience, unencoded characters are allowed as well, except that **%** should be always encoded as **%25**.

For example, the file named **/foo/bar%/\[baz\]** may be specified using either of the following URIs: **file:///foo%2Fbar%25%2F%5Bbaz%5D** and **file:///foo/bar%25/\[baz\]**.

### Time units

- ***TIME* should have one of the following forms:**

  123ns; 1.23us; 1.23ms; 1.23s; 1.23m; 1.23h;

## EXAMPLES

Convert sample rate to 48k:

```
$ roc-copy -vv --rate=48000 -i file:input.wav -o file:output.wav
```

Drop output results (useful for benchmarking):

```
$ roc-copy -vv --rate=48000 -i file:input.wav
```

Input from stdin, output to stdout:

```
$ roc-copy -vv --input-format=wav -i file:- \
    --output-format=wav -o file:- >./output.wav <./input.wav
```

## ENVIRONMENT VARIABLES

The following environment variables are supported:

- **NO\_COLOR**

  By default, terminal coloring is automatically detected. This environment variable can be set to a non-empty string to disable terminal coloring. It has lower precedence than **--color** option.

- **FORCE\_COLOR**

  By default, terminal coloring is automatically detected. This environment variable can be set to a positive integer to enable/force terminal coloring. It has lower precedence than  **NO\_COLOR** variable and **--color** option.

## SEE ALSO

**[roc-recv(1)](/roc-recv/1.md)**, **[roc-send(1)](/roc-send/1.md)**, the Roc web site at *https://roc-streaming.org/*

## BUGS

Please report any bugs found via GitHub (*https://github.com/roc-streaming/roc-toolkit/*).

## AUTHORS

See authors page on the website for a list of maintainers and contributors (*https://roc-streaming.org/toolkit/docs/about\_project/authors.html*).

## COPYRIGHT

2024, Roc Streaming authors