Provided by: jamin_0.97.14~cvs~81203-4_amd64 bug

NAME

       jamin - JACK Audio Mastering interface

SYNOPSIS

       jamin [ options ] [ inport1 inport2 [ outport1 outport2 ]]

       jamin-scene <scene-num>

DESCRIPTION

       The  jamin command invokes JAMin, the JACK Audio Mastering interface which is based on the
       JACK Audio Connection Kit, <http://jackit.sourceforge.net>.

       JAMin is designed for professional stereo audio mastering.  It provides  of  a  number  of
       tools:  a  1024-band  hand-drawn EQ with parametric controls, a 31-band graphic EQ, 3-band
       compressor, 3-band stereo width control, lookahead limiter, boost, and other features.

       For the latest JAMin information, see <http://jamin.sourceforge.net>.

OPTIONS

       -f filename
              Load session file filename on startup.  If no  session  file  is  specified,  JAMin
              loads  "~/.jamin/default.jam"  if  that  exists,  or else uses some system-provided
              default settings.

       -h
              Print a brief usage message describing  the  main  jamin  options,  including  some
              developer options not intended for normal users.

       -j servername
              Connect to JACK server servername.  Otherwise, use the default server.

       -n clientname
              Set  JACK  clientname  used  to  identify  input  and output ports.  Otherwise, use
              "jamin".

       -s frequency
              Set the spectrum update frequency (per second).  The range is 1 to 10  with  10  as
              the default.  Set to 0 to disable spectrum update.

       -c time
              Set  the  crossfade  time  in  seconds.   The  range  is 0.0 to 2.0 with 1.0 as the
              default.  WARNING: fast crossfade times in combination with large jack buffer sizes
              may introduce zipper noise to some signals (especially sustained sounds in the bass
              range).

       -p
              Don't automatically connect any JACK output ports.

              Without this option, JAMin will connect to  outport1  and  outport2  if  they  were
              explicitly  listed  on  the  command  line.   If  not, it connects to the first two
              physical output ports with the string ":playback" in their names.

       -i
              Use IIR type crossover  instead  of  the  default  FFT  type  crossover.   The  IIR
              crossover  is  less  CPU  intensive  but the FFT crossover will give better results
              (YMMV).

       -l
              Set to 0 to use Steve Harris' fast-lookahead-limiter or 1  for  Sampo  Savolainen's
              foo-limiter.   At this time there is a problem with the foo-limiter if you push the
              input too hard.

       -r
              Load GTK resource information from an example  JAMin  resource  file.   If  the  -r
              option   is   not   specified,   look   for   a   user-defined   resource  file  in
              ~/.jamin/jamin_ui.  Otherwise, use the system-wide GTK settings.

       -v
              Print verbose output.  Use -vv or -vvv for more detail.

       -V     Print version and copyright information, then quit.

FILES

       ~/.jamin
              Directory containing per-user JAMin data.  Created automatically  if  it  does  not
              already exist.

       ~/.jamin/jamin_ui
              Default  resource  file  for  GTK  user  interface  customization, used when the -r
              command option is not  specified.   JAMin  provides  a  default  resource  file  in
              ${prefix}/share/jamin/examples/jamin_ui.   To  customize  that  file,  copy  it  to
              ~/.jamin/jamin_ui and make changes.

       ~/.jamin/*.jam
              Normal location for user-defined session files.  They can be stored  elsewhere,  if
              desired.

       ~/.jamin/default.jam
              If  this  session  file  exists,  it  is  loaded by default on startup, except when
              overridden by the -f option.

IPC

       If JAMin has been built with OSC support enabled it responds to UDP OSC messages  on  port
       4444.

       Messages  to  /jamin/scene  with  a numerical argument cause the scene number to change. A
       commaind line tool (jamin-scene) and LADSPA Plugin (jamin_cont, ID:1912) are provided  for
       remote scene changes.

EXAMPLES

       Since  jamin is not a standalone program we generally need other programs to provide input
       audio and receive the mastered output.  This example uses alsaplayer with output going  to
       the first two ALSA playback ports:

              jackd -R -d alsa -p 2048 -r 44100 &
              alsaplayer -o jack -s src -d noconnect song.wav &
              jamin src:out_1 src:out_2

       That was the brute force method.  It is much easier to have qjackctl start the JACK server
       and handle its connections.  After the server is running, start jackplayer and jamin.  The
       "transport"  option  tells  jackplayer  (an alsaplayer alias) to start and stop under JACK
       transport control.

              qjackctl &
              jackplayer -d noconnect/transport song.wav &
              jamin

       Any JACK-aware player such as rezound, ecasound or ecamegapedal can be used, instead.

       A more advanced technique uses ardour for both the source and destination.  In ardour, run
       all  of  your track outputs into a stereo bus, connect its output ports to JAMin, then run
       the JAMin outputs back into  a  record-enabled  stereo  track.   This  allows  mixing  and
       mastering  at the same time.  If JAMin is already running when ardour reopens the session,
       it will automatically reconnect all these ports.

              qjackctl &
              jamin &
              ardour

SEE ALSO:

       <http://jamin.sourceforge.net>
       <http://www.alsa-project.org>
       <http://jackaudio.org>
       <http://qjackctl.sourceforge.net>
       <http://www.suse.de/~mana/jack.html>
       <http://alsaplayer.sourceforge.net>
       <http://www.ardour.org>
       <http://rezound.sourceforge.net>
       jackd(1)
       alsaplayer(1)
       ardour(1)

BUGS

       Please send bug reports to <jamin-devel@lists.sourceforge.net>.

AUTHORS

       Steve Harris is the principal JAMin author and team leader.  Other developers include: Jan
       Depner,  Jack  O'Quin,  Ron  Parker,  Emmanuel  Saracco,  and  Patrick Shirkey.  Alexandre
       Prokoudine and Yuri N.  Sedunov developed the translation infrastructure.  Alexandre  also
       translated JAMin into Russian and is our (really good) web engineer.