1ROC-CONV(1)                       Roc Toolkit                      ROC-CONV(1)
2
3
4

NAME

6       roc-conv - convert audio
7

SYNOPSIS

9       roc-conv OPTIONS
10

DESCRIPTION

12       Read  audio stream from a file, transform it, and and write it to a an‐
13       other file.
14
15   Options
16       -h, --help
17              Print help and exit
18
19       -V, --version
20              Print version and exit
21
22       -v, --verbose
23              Increase verbosity level (may be used multiple times)
24
25       -L, --list-supported
26              list supported schemes and formats
27
28       -i,--input=FILE_URI
29              Input file URI
30
31       -o,--output=FILE_URI
32              Output file URI
33
34       --input-format=FILE_FORMAT
35              Force input file format
36
37       --output-format=FILE_FORMAT
38              Force output file format
39
40       --frame-length=TIME
41              Duration of the internal frames, TIME units
42
43       -r,--rate=INT
44              Output sample rate, Hz
45
46       --no-resampling
47              Disable resampling  (default=off)
48
49       --resampler-backend=ENUM
50              Resampler backend  (possible values="builtin" default=`builtin')
51
52       --resampler-profile=ENUM
53              Resampler profile  (possible values="low", "medium", "high"  de‐
54              fault=`medium')
55
56       --poisoning
57              Enable uninitialized memory poisoning (default=off)
58
59       --profiling
60              Enable self profiling (default=off)
61
62       --color=ENUM
63              Set  colored  logging  mode  for  stderr  output  (possible val‐
64              ues="auto", "always", "never" default=`auto')
65
66   File URI
67       --input and --output options require a file URI in one of the following
68       forms:
69
70       • file:///ABS/PATH -- absolute file path
71
72       • file://localhost/ABS/PATH  --  absolute  file path (alternative form;
73         only "localhost" host is supported)
74
75       • file:/ABS/PATH -- absolute file path (alternative form)
76
77       • file:REL/PATH -- relative file path
78
79       • file://- -- stdout
80
81       • file:- -- stdout (alternative form)
82
83       Examples:
84
85       • file:///home/user/test.wav
86
87       • file://localhost/home/user/test.wav
88
89       • file:/home/user/test.wav
90
91       • file:./test.wav
92
93       • file:-
94
95       The list of supported file formats can be retrieved  using  --list-sup‐
96       ported option.
97
98       If the --output is omitted, the conversion results are discarded.
99
100       The --input-format and --output-format options can be used to force the
101       file format. If the option is omitted,  the  file  format  is  auto-de‐
102       tected. This option is always required for stdin or stdout.
103
104       The  path  component of the provided URI is percent-decoded. For conve‐
105       nience, unencoded characters are allowed as well, except that %  should
106       be always encoded as %25.
107
108       For  example, the file named /foo/bar%/[baz] may be specified using ei‐
109       ther  of  the  following  URIs:  file:///foo%2Fbar%25%2F%5Bbaz%5D   and
110       file:///foo/bar%25/[baz].
111

EXAMPLES

113       Convert sample rate to 48k:
114
115          $ roc-conv -vv --rate=48000 -i file:input.wav -o file:output.wav
116
117       Drop output results (useful for benchmarking):
118
119          $ roc-conv -vv --rate=48000 -i file:input.wav
120
121       Input from stdin, output to stdout:
122
123          $ roc-conv -vv --input-format=wav -i file:- --output-format=wav -o file:- >./output.wav <./input.wav
124

SEE ALSO

126       roc-recv(1),      roc-send(1),      the     Roc     web     site     at
127       https://roc-streaming.org/
128

BUGS

130       Please     report     any     bugs     found     via     GitHub      (‐
131       https://github.com/roc-streaming/roc-toolkit/).
132

AUTHORS

134       See authors page on the website for a list of maintainers and contribu‐
135       tors.
136

138       2023, Roc Streaming authors
139
140
141
142
143Roc Toolkit 0.2                      2023                          ROC-CONV(1)
Impressum