timemachine(1) JACK audio recorder for spontaneous and conservatory use


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


This manual page documents briefly the timemachine tool.

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

timemachine 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 timemachine 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 timemachine is started.


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-".


This manual page was written by Robert Jordens [email protected] 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.