<div dir="ltr"><div class=""><p>
The small but intrepid group of JACK 1 developers announce the release
today of JACK 0.124.0, the latest version of JACK 1. This release
features 3 major new features that are designed to make JACK easier to
use and better in several ways, along with a large set of minor bug
fixes and improvements. You can fetch the tarball
release <a href="http://jackaudio.org/downloads/jack-audio-connection-kit-0.124.0.tar.gz">here</a>. It
has been tagged in the JACK 1 git repository as "0.124.0". 
</p><p>
</p>
One of the "minor" bug fixes will make a huge difference for some
users: if a particular JACK client crashes <em>only</em> the
misbehaving client will be "zombified" - other clients will continue
functioning normally (after a short delay). If you are developing JACK
applications, this can make a huge difference to your day-to-day
experience of JACK 1.


<h2>The Metadata API</h2>
<p>
It is now possible to define arbitrary metadata to be associated with
any JACK port or JACK client. This API lays the groundwork for more
useful naming of ports and clients (particularly those associated with
hardware), as well as many other features that developers have talked
about in a JACK context for several years. The full docs on the API
can be found <a href="http://jackaudio.org/files/docs/html/group__Metadata.html">here</a> and there is
also a man page for <code>jack_property</code>, which is the primary
command line tool for setting, removing and changing metadata. A short
<a href="http://jackaudio.org/metadata">tutorial</a> on using the Metadata API is available.
</p>

<h2>Builtin MIDI hardware I/O (on Linux)</h2>
<p>
  For years, we have known that the performance of the -X seq and -X
  raw options to the ALSA backend have left much to be desired. For
  that reason, most users have been instructed to
  use <code>a2jmidid</code> (typically with the -e flag to tell it use
  external (hardware) MIDI devices). Although <code>a2jmidid</code>
  provided good MIDI I/O, it has two problems:
  </p><ol><li>Requires starting an addition program in order to get MIDI I/O
    via hardware working</li><li>Adds latency to the MIDI I/O "through" or "monitor" signal pathway</li></ol>

<p>
  This release of JACK 1 sees the transformation
  of <code>a2jmidid</code> into a "slave" driver that can be started
  as a part of JACK, much like the old -X seq and -X raw options. This
  not only removes the need to start a separate program, but also
  reduces the "through" or "monitoring" latency of MIDI I/O by 1 JACK period. 
</p>
<p>
  The canonical way to invoke this new internal MIDI driver is
  with <code>-X alsa_midi</code>, which will create JACK ports for all
  MIDI devices (and other MIDI applications) known to ALSA at the time
  that JACK starts up. Note that the new internal driver does not
  currently notice the arrival or departure of MIDI hardware or
  applications, but future improvements will correct this.
</p>
<p>
  In addition, the old <code>-X seq</code> and <code>-X raw</code> implementations have been
  removed. However, using <code>-X seq</code> will be interpreted as a
  request to use the new internal MIDI driver, and so is formally
  equivalent to using <code>-X alsa_midi</code>. Note that <code>-X
  seq</code> is an argument to the ALSA backend, and so
  comes <em>after</em> the backend specification; by contrast, <code>-X
  alsa_midi</code> is a server argument, and must come before the
  backend specification.
</p>
<p>
  It is worth noting that the server argument <code>-X
  alsa_midi</code> can be used with any Linux-based backend (ALSA,
  OSS, Dummy, Netjack) to get the ALSA MIDI bridge functional.
</p>

<h2>Builtin Internal Client for using additional ALSA devices</h2>
<p>
  Older versions of JACK have come with the tools <code>alsa_in</code>
  and <code>alsa_out</code> which can be used to add additional
  ALSA supported audio devices to a running JACK setup. These tools
  work quite well, but:
  </p><ol><li>Fons Adriennsen developed significantly better versions known
      as zita-a2j and zita-j2a that use his own resampler.</li><li>these tools are (like the rest of the JACK tools) separate
      programs that the user must start up after the server is
      running</li></ol>

<p>
  To address these two points, the zita-a2j/zita-j2a code has been
  merged into the tools part of JACK as a pair of <em>internal</em>
  clients ("zalsa_in" and "zalsa_out") that can be
  specified on the command line. So for example, this JACK command
  line:
</p><pre>   jackd ... -I "USB Mic:zalsa_in/-dhw:USB,-r44100,-n2,-p512" ...
</pre>
  will create an internal client called "USB Mic" that represents
the ALSA device "hw:USB" using the ZITA alsa/jack bridge code, running
at 44100kHz, with 2 periods of size 512. If you do not specify the
period size or sample rate, then the values in use by the backend will
be adopted.

Audio being captured or played back via devices
added to JACK in this way will be resampled with substantial accuracy
and quality. 

<p>
  Note that the -I argument has been present in JACK 2 for sometime,
  but the new JACK1 implementation extends the semantics of its
  argument by allowing the user to specify a client name as well as
  arguments for the internal client code.
</p>
<p>
Both internal clients (zalsa_in and zalsa_out) will accept the -h
argument to show their possible arguments:
<code>jackd -I zalsa_in/-h -d alsa</code> (the final <code>-d
  alsa</code> is required by JACK but not used in this case). The
  arguments will match those of the standalone zita-a2j and zita-j2a
  (external) clients.
</p>
<p>
Since this new "multiple device" capability is implemented using JACK
internal clients, you can remove a given device by just unloading the
client using the long-existing but rarely
used <code>jack_unload</code> command. Similarly, if you wanted to add
a device to a running server after it has
started, <code>jack_load</code> can be used for that.
</p>
<p>
  It is worth noting that these internal clients can be used with any
Linux-based backend (ALSA, FFADO, OSS, Dummy, Netjack) to add
additional ALSA-support devices to an instance of JACK.
</p>

<h3>Syntactic Sugar Version</h3>
<p>
To make the addition of extra audio devices to an instance of JACK
even easier, JACK 1 also features the new <code>-A</code> option which
takes almost nothing more than an ALSA card name (e.g. "SB", "DSP",
"Codec", "HDMI" and many others) and makes the device available for
playback or capture or both. Adding %p or %c to the card name limits
the direction of audio flow. 
</p>
<p>
This option does nothing more than translate its argument into an
equivalent use of -I, so for example:
</p><pre>   -A SB
</pre>
is equivalent to using <em>both</em> of these arguments:
<pre>     -I SB/zalsa_in/-dhw:SB
        -I SB/zalsa_out/-dhw:SB
</pre>
As with <code>-I</code>, the <code>-A</code> argument may be used
multiple times to add as many devices as you want. <code>-A</code> is
simple but not very powerful - if you need to provide more options
(e.g. to adjust I/O latency values), then you must use the -I argument
instead.

<p>
Finally, note that these internal clients are theoretically compatible
with JACK 2, and should work with that implementation of JACK once
JACK 2 has a working internal client loading mechanism restored.
</p>

<h2>Complete Change List for 0.124.0</h2>

<h3>Major New Features</h3>

<ul><li>add the new metadata API, allowing arbitrary metadata to be
  associated with JACK ports and clients</li><li>merge a2jmidid code into JACK as (slave) driver.</li><li>add  zita-a2j as internal clients</li></ul>

<h3>Notable Source Code Rearrangements</h3>

<ul><li>Use separated JACK public headers and tools repositories, in an
    attempt to share these with JACK 2</li><li>JACK 1 now requires the Berkeley DB library to build (this is
  used inside the metadata API implementation)</li><li>The new ZITA-based internal clients are optional - to build them
  you will need Fons Adriennsen's ALSA PCMI and ZITA resampler
  libraries available.</li></ul>

<h3>Bug Fixes, Updates and Other Enhancements</h3>

<ul><li>Install jslist.h with JACK headers since it is used by control.h</li><li>clarify use of alsa_in/alsa_out's -q parameter</li><li>check for engine->driver before delivery latency events to its
    internal client</li><li>the default error callback no longer calls DEBUG, which breaks
    if <code>_jack_get_microseconds</code> has not been set</li><li>remove all references to MMX/MME (which was never used within
  JACK)</li><li>remove --enable-ensure-mlock configure option</li><li>deprecate <code>jack_thread_wait()</code> as done in JACK2</li><li>clean up client code to fix inconsistent handling of the return
    value from the process callback</li><li>improve <a href="http://configure.ac">configure.ac</a> for use on OS X</li><li>redesign thread calls to make them work correctly on OS X</li><li>remove port.g from documentation since it is not a public
  header</li><li>remove timestamps code, since it was no longer used or
  useful.</li><li>fix detection of libsamplerate</li><li>support <code>setbufsize</code> now available in firewire
  driver</li><li>improved <code>jack_get_cycle_times()</code> and improved DLL
    implementation (particularly after freewheeling)</li><li>compile with FFADO versions < 9 once more</li><li>update FFADO latencies after setbufsize</li><li>use  max (JACK_CLIENT_EVENT_TIMEOUT,command-line-client-timeout)
  for poll on event handling when in non-RT mode</li><li>tidy up error messages when something goes wrong with client
    event handling</li><li>add a latency callback to the ALSA backend, and ensure that the
  backend's latency callback, if it exists, is called after a buffer
  size change</li><li>provide FFADO/firewire backend with its own latency
  callback</li><li>adjust driver/backend port latencies for both playback and
  capture ports in both directions</li><li>handle latency callbacks before graph reorder callbacks, as per
  a recent (correct) change in JACK 2</li><li>handled failed malloc caused limits.conf being changed while
    jackd is running</li><li>Correctly recognize ALSA subdevices when symbolic names like hw:Live
    are used.
  </li><li>If an attempt to reconfigure the ALSA backend fails, it will
    fall back to its previous successful configuration.</li><li>remove watchdog thread from engine/jackd, since Linux no longer
  allows SCHED_{FIFO,RR} tasks to take over the cpu unless the user
  misconfigures a very obscure part of their system configuration</li><li>fix delivery of buffer size changes to internal clients</li><li>fix incorrect memset() of an event in latency handling</li><li>fix arguably incorrect marking of client with errors after
  process cycle fails to return to server</li><li>use a default size of 2048 byte for MIDI port buffers, like JACK
    2, to avoid problems with MIDI delivery under fairly common circumstances</li><li>add -I option to command line to allow loading internal clients
    (consistent with JACK 2), though with more complex argument style
    to -I to permit client names and arguments</li></ul>

<h3>Authors</h3>

<p>Jonathan Woithe, Adrian Knoth, Fons Adriennsen, Nedko Arnaudov, Torben
Hohn, Paul Davis.
</p>
<p>
Thanks to David Robillard, Jonathan Liles and Filipe Coehlo for their
  participation in the design of the metadata API.
</p></div></div>