NAME

       freqtweak - Realtime audio frequency spectral manipulation

SYNOPSIS

       freqtweak [-h] [ -c <num> ] [ -i <str> ] [ -o <str> ] [ -n <str> ] [ -D <str> ] [ -p <str> ] [ -r <str> ]

DESCRIPTION

       freqtweak  is  a graphical tool for realtime audio spectral manipulation and display. It provides several
       algorithms for processing audio data in the frequency domain and a highly interactive GUI  to  manipulate
       each  associated  filter.  It  also  provides high-resolution spectral displays in the form of scrolling-
       raster spectrograms and energy vs frequency plots displaying both pre and post-processed spectra.

       Freqtweak is a jack client. You need to have jackd running in order to get sound input  and  output  with
       freqtweak.

MOUSE CONTROL

       The  processing  filters  are controlled through mouse operations on each filter GUI window. The possible
       operations are:

       Left button click/drag to draw filters. If Control is down, the  y-axis  is  fixed  at  the  last  cursor
       location  (to  draw  nice  horizontal  lines).   If  Control and Alt are down you can draw nice arbitrary
       straight lines.

       Right button drag to move filters around in space.  The filters wrap around the left/right  edges  unless
       you  hold down Control.  Dragging with both left and right buttons down on the GUI for the Gate processor
       moves both the primary and the alternate filter together.

       Holding Shift modifies the alternate filter  (on  double  filter  graphs  like  Gate)  for  the  previous
       operations.

       Middle-button pops up frequency axis menu.

       Ctrl-Alt right-click resets a filter to default values.

       Shift-Ctrl-Alt left-drag zooms in on the y axis.  Look at the status bar to see the values for the cursor
       itself and the values of the filter at the cursor's frequency.

       Shift-Ctrl-Alt right-click release resets the Y-zoom to full.

       The B and BA buttons mean Bypass and Bypass All respectively.

       The L and LA buttons mean Link and Link All respectively.

       The G and GS buttons mean Toggle Grid and Toggle Grid Snap respectively.

OPTIONS

       This program follows the usual GNU command line syntax, with long options starting with two dashes (`-').
       A summary of options is included below.

       -h, --help
              Show summary of options.

       -c <num>, --channels=<num>
              Processing channels (1-4). Default is 2.

       -i <str>, --inputs=<str>
              Connect  inputs  from  these  jack  ports  (separate  each  channel  with  commas).   Defaults  to
              'alsa_pcm:capture_1,...'

       -o <str>, --outputs=<str>
              Connect  outputs  to  these  jack  ports  (separate  each  channel  with  commas).   Defaults   to
              'alsa_pcm:playback_1,...'

       -n <str>, --jack-name=<str>
              Jack name. Default is freqtweak_1.

       -D <str>, --tmpdir=<str>
              Jack server tmp directory (should match jackd --tmpdir).

       -p <str>, --preset=<str>
              Load the given preset initially.

       -r <str>, --rc-dir=<str>
              Specifies what directory to use for run-control state. Default is ~/.freqtweak.

EXAMPLES

       Here  is  an  example  of  using  freqtweak  with  an  alsaplayer feeding it and output going to speakers
       (alsa_pcm:out_?) without using a JACK patchbay:

       Start freqtweak first with this command line:

       freqtweak -n ft &

       Then start alsaplayer like so:

       alsaplayer -o jack -d ft:in_1,ft:in_2 &

SEE ALSO

       jackd(1), jack_connect(1), jack_lsp(1)

AUTHOR

       Freqtweak was written and is maintained by Jesse Chappell <jesse@essej.net>.

       This manual page was created by Enrique  Robledo  Arnuncio  <era@debian.org>  for  the  Debian  GNU/Linux
       system, using text from the README file by Jesse Chappell.

                                                February 11, 2003                                   FREQTWEAK(1)