Merge branch 'jackdbus-split' into stable
[jackdbus.git] / README.rst
blob1751b4cac3f30f208ab765946e74ae1218b83368
1 `JACK2 <https://jackaudio.org/>`_
2 ################################
4 .. image:: https://travis-ci.org/jackaudio/jack2.svg?branch=master
5    :target: https://travis-ci.org/jackaudio/jack2  
6 .. image:: https://repology.org/badge/tiny-repos/jack-audio-connection-kit.svg
7    :target: https://repology.org/metapackage/jack-audio-connection-kit/versions
8    
9 JACK2 aka jackdmp is a C++ version of the JACK low-latency audio server for
10 multi-processor machines. It is a new implementation of the JACK server core
11 features that aims at removing some limitations of the JACK1 design. The
12 activation system has been changed for a data flow model and lock-free
13 programming techniques for graph access have been used to have a more dynamic
14 and robust system.
16 - uses a new client activation model, that allows simultaneous client
17   execution (on a SMP machine) when parallel clients exist in the graph (client
18   that have the same inputs). This activation model allows to better use
19   available CPU on a smp machine, but also works on mono-processor machine.
21 - uses a lock-free way to access (read/write) the client graph, thus
22   allowing connections/disconnection to be done without interrupting the audio
23   stream. The result is that connections/disconnections are glitch-free.
25 - can work in two different modes at the server level:
27   - *synchronous activation*: in a given cycle, the server waits for all
28     clients to be finished (similar to normal jackd)
30   - *asynchronous activation*: in a given cycle, the server does not wait for
31     all clients to be finished and use output buffer computed the previous
32     cycle.
33     The audible result of this mode is that if a client is not activated
34     during one cycle, other clients may still run and the resulting audio
35     stream will still be produced (even if its partial in some way). This
36     mode usually result in fewer (less audible) audio glitches in a loaded
37     system.
39 For further information, see the JACK `homepage <https://jackaudio.org/>`_ and `wiki <https://github.com/jackaudio/jackaudio.github.com/wiki>`_. There are also the #jack and #lad chat channels on `freenode IRC <https://freenode.net>`_.