aboutsummaryrefslogtreecommitdiff
path: root/audio/rubberband/rubberband.1
blob: 73bbf1058cec751e077d5ac58fd9107b61773188 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "RUBBERBAND" "1" "15 September 2014" "" ""

.SH NAME
rubberband \- an audio time-stretching and pitch-shifting utility program
.SH SYNOPSIS

\fBrubberband\fR [ \fB\fIoptions\fB\fR ] [ \fB\fIinput file\fB\fR ] [ \fB\fIoutput file\fB\fR ]

.SH "DESCRIPTION"
.PP
This manual page documents briefly the
\fBrubberband\fR command.
.PP
Rubber Band is a program that permits you to change the
tempo and pitch of an audio recording independently of one
another.
.SH "OPTIONS"
.PP
These programs follow the usual GNU command line syntax,
with long options starting with two dashes (`-').  A summary of
options is included below.
.PP
You must specify at least one of the following time and
pitch ratio options.
.TP
\fB-t, --time \fIX\fB\fR
Stretch to \fIX\fR times original
duration, or
.TP
\fB-T, --tempo \fIX\fB\fR
Change tempo by multiple \fIX\fR (equivalent to --time 1/X)
.TP
\fB-p, --pitch \fIX\fB\fR
Raise pitch by \fIX\fR semitones, or
.TP
\fB-f, --frequency \fIX\fB\fR
Change frequency by multiple \fIX\fR
.PP
The following option provides a simple way to adjust the
sound.  See below for more details.
.TP
\fB-n, --crisp \fIN\fB\fR
Crispness (N = 0,1,2,3,4,5); default 4 (see below)
.PP
The remaining options fine-tune the processing mode and
stretch algorithm.  These are mostly included for test purposes;
the default settings and standard crispness parameter are
intended to provide the best sounding set of options for most
situations.
.TP
\fB-P, --precise\fR
Aim for minimal time distortion (implied by -R)
.TP
\fB-R, --realtime\fR
Select realtime mode (implies -P --no-threads)
.TP
\fB--no-threads\fR
No extra threads regardless of CPU and channel count
.TP
\fB--threads\fR
Assume multi-CPU even if only one CPU is identified
.TP
\fB--no-transients\fR
Disable phase resynchronisation at transients
.TP
\fB--bl-transients\fR
Band-limit phase resync to extreme frequencies
.TP
\fB--no-peaklock\fR
Disable phase locking to peak frequencies
.TP
\fB--no-softening\fR
Disable large-ratio softening of phase locking
.TP
\fB--window-long\fR
Use longer processing window (actual size may vary)
.TP
\fB--window-short\fR
Use shorter processing window
.TP
\fB--thresh \fIN\fB \fIF\fB\fR
Set internal freq threshold \fIN\fR (N = 0,1,2) to \fIF\fR Hz
.TP
\fB-d, --debug \fIN\fB\fR
Select debug level (N = 0,1,2,3); default 0, full 3
(N.B. debug level 3 includes audible ticks in output)
.TP
\fB-q, --quiet\fR
Suppress progress output
.TP
\fB-h, --help\fR
Show a list of available options
.PP
Crispness levels:
.TP
\fB0\fR
equivalent to --no-transients --no-peaklock --window-long
.TP
\fB1\fR
equivalent to --no-transients --no-peaklock
.TP
\fB2\fR
equivalent to --no-transients
.TP
\fB3\fR
equivalent to --bl-transients
.TP
\fB4\fR
default processing options
.TP
\fB5\fR
equivalent to --no-peaklock --window-short (may be suitable for drums)
.SH "AUTHOR"
.PP
Rubber Band was written by Chris Cannam <cannam@all-day-breakfast.com>\&.