123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121 |
- .\" 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>\&.
|