1JAMIN(1) Audio JAMIN(1)
2
3
4
6 jamin - JACK Audio Mastering interface
7
8
10 jamin [ options ] [ inport1 inport2 [ outport1 outport2 ]]
11
12 jamin-scene <scene-num>
13
14
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
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
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
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
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
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
171 Please send bug reports to <jamin-devel@lists.sourceforge.net>.
172
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.14 JAMIN(1)