&dhucpackage; &dhsection;

rubberband

an audio time-stretching and pitch-shifting utility program

          &dhpackage;

          options
          input file
          output file

## DESCRIPTION

This manual page documents briefly the `&dhpackage;` command.

Rubber Band is a program that permits you to change the tempo and pitch of an audio recording independently of one another.

## OPTIONS

These programs follow the usual &gnu; command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

You must specify at least one of the following time and pitch ratio options.

`-t`, `--time` `X`

- Stretch to `X` times original duration, or

`-T`, `--tempo` `X`

- Change tempo by multiple `X` (equivalent to --time 1/X)

`-p`, `--pitch` `X`

- Raise pitch by `X` semitones, or

`-f`, `--frequency` `X`

- Change frequency by multiple `X`

The following option provides a simple way to adjust the sound. See below for more details.

`-n`, `--crisp` `N`

- Crispness (N = 0,1,2,3,4,5); default 4 (see below)

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.

`-P`, `--precise`

- Aim for minimal time distortion (implied by -R)

`-R`, `--realtime`

- Select realtime mode (implies -P --no-threads)

`--no-threads`

- No extra threads regardless of CPU and channel count

`--threads`

- Assume multi-CPU even if only one CPU is identified

`--no-transients`

- Disable phase resynchronisation at transients

`--bl-transients`

- Band-limit phase resync to extreme frequencies

`--no-peaklock`

- Disable phase locking to peak frequencies

`--no-softening`

- Disable large-ratio softening of phase locking

`--window-long`

- Use longer processing window (actual size may vary)

`--window-short`

- Use shorter processing window

`--thresh` `N` `F`

- Set internal freq threshold `N` (N = 0,1,2) to `F` Hz

`-d`, `--debug` `N`

- Select debug level (N = 0,1,2,3); default 0, full 3 (N.B. debug level 3 includes audible ticks in output)

`-q`, `--quiet`

- Suppress progress output

`-h`, `--help`

- Show a list of available options

"Crispness" levels:

0

- equivalent to --no-transients --no-peaklock --window-long

1

- equivalent to --no-transients --no-peaklock

2

- equivalent to --no-transients

3

- equivalent to --bl-transients

4

- default processing options

5

- equivalent to --no-peaklock --window-short (may be suitable for drums)

## AUTHOR

Rubber Band was written by Chris Cannam <cannam@all-day-breakfast.com>.

This manual page was written by &dhusername; <&dhemail;> for the &debian; system (but may be used by others), because the original program does not have a manual page. Permission is granted to copy, distribute and/or modify this document under the terms of the &gnu; General Public License, Version 2 any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.