Ubuntu Manpage: jamin - JACK Audio Mastering interface

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

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

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.