1JAMIN(1)                             Audio                            JAMIN(1)
2
3
4

NAME

6       jamin - JACK Audio Mastering interface
7
8

SYNOPSIS

10       jamin [ options ] [ inport1 inport2 [ outport1 outport2 ]]
11
12       jamin-scene <scene-num>
13
14

DESCRIPTION

16       The  jamin  command  invokes  JAMin, the JACK Audio Mastering interface
17       which is based on the JACK Audio Connection Kit, <http://jackit.source
18       forge.net>.
19
20       JAMin is designed for professional stereo audio mastering.  It provides
21       of a number of tools: a 1024-band hand-drawn EQ  with  parametric  con‐
22       trols,  a  31-band  graphic  EQ, 3-band compressor, 3-band stereo width
23       control, lookahead limiter, boost, and other features.
24
25       For the latest JAMin information, see <http://jamin.sourceforge.net>.
26
27

OPTIONS

29       -f filename
30              Load session file filename on startup.  If no  session  file  is
31              specified, JAMin loads "~/.jamin/default.jam" if that exists, or
32              else uses some system-provided default settings.
33
34       -h
35              Print a brief usage message describing the main  jamin  options,
36              including some developer options not intended for normal users.
37
38       -j servername
39              Connect  to  JACK server servername.  Otherwise, use the default
40              server.
41
42       -n clientname
43              Set JACK clientname used to identify  input  and  output  ports.
44              Otherwise, use "jamin".
45
46       -s frequency
47              Set  the spectrum update frequency (per second).  The range is 1
48              to 10 with 10 as the default.  Set  to  0  to  disable  spectrum
49              update.
50
51       -c time
52              Set the crossfade time in seconds.  The range is 0.0 to 2.0 with
53              1.0 as the default.  WARNING: fast crossfade times  in  combina‐
54              tion  with large jack buffer sizes may introduce zipper noise to
55              some signals (especially sustained sounds in the bass range).
56
57       -p
58              Don't automatically connect any JACK output ports.
59
60              Without this option, JAMin will connect to outport1 and outport2
61              if  they were explicitly listed on the command line.  If not, it
62              connects to the first two physical output ports with the  string
63              ":playback" in their names.
64
65       -i
66              Use  IIR  type  crossover instead of the default FFT type cross‐
67              over.  The IIR crossover is  less  CPU  intensive  but  the  FFT
68              crossover will give better results (YMMV).
69
70       -l
71              Set  to  0  to use Steve Harris' fast-lookahead-limiter or 1 for
72              Sampo Savolainen's foo-limiter.  At this time there is a problem
73              with the foo-limiter if you push the input too hard.
74
75       -r
76              Load  GTK  resource  information  from an example JAMin resource
77              file.  If the -r option is  not  specified,  look  for  a  user-
78              defined  resource file in ~/.jamin/jamin_ui.  Otherwise, use the
79              system-wide GTK settings.
80
81       -v
82              Print verbose output.  Use -vv or -vvv for more detail.
83
84       -V     Print version and copyright information, then quit.
85
86

FILES

88       ~/.jamin
89              Directory containing per-user JAMin data.  Created automatically
90              if it does not already exist.
91
92       ~/.jamin/jamin_ui
93              Default resource file for GTK user interface customization, used
94              when the -r command option is not specified.  JAMin  provides  a
95              default    resource    file    in    ${prefix}/share/jamin/exam‐
96              ples/jamin_ui.    To   customize   that   file,   copy   it   to
97              ~/.jamin/jamin_ui and make changes.
98
99       ~/.jamin/*.jam
100              Normal  location  for  user-defined  session files.  They can be
101              stored elsewhere, if desired.
102
103       ~/.jamin/default.jam
104              If this session file exists, it is loaded by default on startup,
105              except when overridden by the -f option.
106
107

IPC

109       If JAMin has been built with OSC support enabled it responds to UDP OSC
110       messages on port 4444.
111
112       Messages to /jamin/scene with a numerical argument cause the scene num‐
113       ber  to  change.  A  commaind line tool (jamin-scene) and LADSPA Plugin
114       (jamin_cont, ID:1912) are provided for remote scene changes.
115
116

EXAMPLES

118       Since jamin is not a standalone program we generally  need  other  pro‐
119       grams  to  provide  input  audio and receive the mastered output.  This
120       example uses alsaplayer with output going to the first two  ALSA  play‐
121       back ports:
122
123
124              jackd -R -d alsa -p 2048 -r 44100 &
125              alsaplayer -o jack -s src -d noconnect song.wav &
126              jamin src:out_1 src:out_2
127
128
129       That  was  the  brute force method.  It is much easier to have qjackctl
130       start the JACK server and handle its connections.  After the server  is
131       running,  start  jackplayer  and  jamin.   The "transport" option tells
132       jackplayer (an alsaplayer alias) to start and stop under JACK transport
133       control.
134
135
136              qjackctl &
137              jackplayer -d noconnect/transport song.wav &
138              jamin
139
140       Any  JACK-aware player such as rezound, ecasound or ecamegapedal can be
141       used, instead.
142
143
144       A more advanced technique uses ardour for both the source and  destina‐
145       tion.  In ardour, run all of your track outputs into a stereo bus, con‐
146       nect its output ports to JAMin, then run the JAMin outputs back into  a
147       record-enabled  stereo  track.  This allows mixing and mastering at the
148       same time.  If JAMin is already running when ardour  reopens  the  ses‐
149       sion, it will automatically reconnect all these ports.
150
151
152              qjackctl &
153              jamin &
154              ardour
155
156

SEE ALSO:

158       <http://jamin.sourceforge.net>
159       <http://www.alsa-project.org>
160       <http://jackaudio.org>
161       <http://qjackctl.sourceforge.net>
162       <http://www.suse.de/~mana/jack.html>
163       <http://alsaplayer.sourceforge.net>
164       <http://www.ardour.org>
165       <http://rezound.sourceforge.net>
166       jackd(1)
167       alsaplayer(1)
168       ardour(1)
169

BUGS

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

AUTHORS

174       Steve  Harris  is  the  principal  JAMin author and team leader.  Other
175       developers include: Jan  Depner,  Jack  O'Quin,  Ron  Parker,  Emmanuel
176       Saracco,  and  Patrick  Shirkey.   Alexandre  Prokoudine  and  Yuri  N.
177       Sedunov  developed  the  translation  infrastructure.   Alexandre  also
178       translated JAMin into Russian and is our (really good) web engineer.
179
180
181
182June 2007                           0.97.16                           JAMIN(1)
Impressum