Man page - roc-copy(1)

Packages contains this manual

Package:  roc-toolkit-tools
apt-get install roc-toolkit-tools

Manuals in package:
• roc-recv(1)
• roc-send(1)
• roc-copy(1)
Documentations in package:
• roc-toolkit-tools

Manual

ROC-COPY

NAME
SYNOPSIS
DESCRIPTION
Options
File URI
Time units
EXAMPLES
ENVIRONMENT VARIABLES
SEE ALSO
BUGS
AUTHORS
COPYRIGHT

---

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-send(1) , 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

---