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.