&dhucpackage; &dhsection;

&dhpackage;

JACK audio recorder for spontaneous and conservatory use

          &dhpackage;

          -h
    	  -c <number of channels>
    	  -n <JACK client name>
    	  -p <file prefix>

## DESCRIPTION

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

This manual page was written for the &debian; distribution because the original program does not have a manual page.

`&dhpackage;` writes the last 10 seconds of audio _before_ the button press and everything from now on up to the next button press into a WAV-file.

The idea is that you doodle away with whatever is kicking around in your studio and when you heard an interesting noise, you'd press record and capture it, without having to try and recreate it.

Run it with `&dhpackage;` then connect it up with a jack patchbay app. To start recording click in the window, to stop recording click in the window again.

It will create a file following tm-*.wav, with an ISO 8601 timestamp, eg tm-2003-01-19T20:47:03.wav. The time is the time that the recording starts from, not when you click.

It uses the JACK audio connection kit, an API that lets audio application communicate with each other and share audio data in realtime.

The generated file will be a W64 file, a valid but unusual WAV format that might not be recognized by some programs. Binaries linked with libsndfile should be able to read it. Also, note that the sample rate of the file with be the same as the sample rate `jackd` is running at when `&dhpackage;` is started.

## OPTIONS

`-h`

- Help: show available flags.

`-c <number of channels>`

- Specifies the numer of channels to listen on, record and write to the file. Valind numbers: 1-8, 2 is the default.

`-n <jack-name>`

- Name with which to register as a JACK client. Defaults to "TimeMachine".

`-p <file prefix>`

- The prefix for WAV files to be written. Defaults to "tm-".

## SEE ALSO

jackd(1)

## AUTHOR

This manual page was written by &dhusername; &dhemail; for the &debian; system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2. On Debian systems, the full text of this license can be found in the file /usr/share/common-licenses/GPL-2.