Tree [r738] / tags / qjackctl_0_0_9 /
History



File Date Author Commit
AUTHORS 2003-10-03 --none-- [r44] This commit was manufactured by cvs2svn to crea...
COPYING 2003-10-03 --none-- [r44] This commit was manufactured by cvs2svn to crea...
ChangeLog 2003-10-03 --none-- [r45] This commit was manufactured by cvs2svn to crea...
INSTALL 2003-10-03 --none-- [r44] This commit was manufactured by cvs2svn to crea...
Makefile.in 2003-09-04 rncbc [r16] I18n support introduced; new dummy and portaudi...
README 2003-09-19 rncbc [r33] Release 0.0.8: Transport and buffer size status...
TODO 2003-09-25 rncbc [r40] Trivial documentation sync for 0.0.9 release.
clienti.xpm 2003-09-07 rncbc [r21] Patchbay connection handling initial rewrite; m...
cliento.xpm 2003-09-22 rncbc [r35] New pixmaps for physical ports; configure.in up...
configure.in 2003-09-22 rncbc [r35] New pixmaps for physical ports; configure.in up...
main.cpp 2003-09-15 rncbc [r29] Release 0.0.7: Minor bufixes.
pause1.png 2003-09-18 rncbc [r31] Transport status and control introduced; statis...
play1.png 2003-09-18 rncbc [r31] Transport status and control introduced; statis...
portlni.xpm 2003-09-07 rncbc [r21] Patchbay connection handling initial rewrite; m...
portlno.xpm 2003-09-07 rncbc [r21] Patchbay connection handling initial rewrite; m...
portlti.xpm 2003-09-22 rncbc [r35] New pixmaps for physical ports; configure.in up...
portlto.xpm 2003-09-22 rncbc [r35] New pixmaps for physical ports; configure.in up...
portpni.xpm 2003-09-22 rncbc [r35] New pixmaps for physical ports; configure.in up...
portpno.xpm 2003-09-22 rncbc [r35] New pixmaps for physical ports; configure.in up...
portpti.xpm 2003-09-22 rncbc [r35] New pixmaps for physical ports; configure.in up...
portpto.xpm 2003-09-22 rncbc [r35] New pixmaps for physical ports; configure.in up...
qjackctl.pro 2003-09-18 rncbc [r31] Transport status and control introduced; statis...
qjackctl.xpm 2003-09-15 rncbc [r29] Release 0.0.7: Minor bufixes.
qjackctlMainForm.ui 2003-09-24 rncbc [r39] Immediate button disabling on clicking, avoidin...
qjackctlMainForm.ui.h 2003-10-03 --none-- [r45] This commit was manufactured by cvs2svn to crea...
qjackctlPatchbay.cpp 2003-10-03 --none-- [r45] This commit was manufactured by cvs2svn to crea...
qjackctlPatchbay.h 2003-09-12 rncbc [r25] Messages coloring, multi-connection fixes, drag...
qtlogo.png 2003-09-15 rncbc [r29] Release 0.0.7: Minor bufixes.
quit1.png 2003-10-03 --none-- [r44] This commit was manufactured by cvs2svn to crea...
start1.png 2003-10-03 --none-- [r44] This commit was manufactured by cvs2svn to crea...
stop1.png 2003-10-03 --none-- [r44] This commit was manufactured by cvs2svn to crea...

Read Me

JACK Audio Connection Kit - Qt GUI Interface
--------------------------------------------

Qjackctl is a simple Qt application to control the JACK sound server daemon
(http://jackit.sourceforge.net), for the Linux Audio Desktop infrastructure.

Written in C++ around the Qt3 toolkit for X11, most exclusively using Qt Designer.

Provides a simple GUI dialog for setting several JACK daemon parameters,
which are properly saved between sessions, and a way control of the status
of the audio server daemon.

Homepage: http://qjackctl.sourceforge.net

License: GNU General Public License (GPL)


Installation
------------

The installation procedure follows the standard for source distributions:

    ./configure [--prefix=/usr/local]
    make

and optionally as root:

    make install

This procedure will end installing the following couple of files:

    ${prefix}/bin/qjackctl
    ${prefix}/share/icons/qjackctl.xpm

Just launch ${prefix}/bin/qjackctl and you're off (hopefully).


Configuration
-------------

Qjackctl holds its settings and configuration state per user, in a file
located as $HOME/.qt/qjackctlrc. Normally, there's no need to edit this
file, as it is recreated and rewritten everytime qjackctl is run.


Bugs
----

Plenty. After all is still alpha stage. To date, qjackctl has been tested
with JACK release 0.72.4 and beyond, on SuSE 8.1, Mandrake 9.1 and RedHat 9,
with a custom 2.4.21 kernel with low-latency, preemptible and capabilities
enabling patches.

It has been found that each case may have some issues regarding JACK running in
realtime mode. Please be sure to run a capable kernel and play with either
jackstart or jackd server paths, which shall be root suid anyway, for a better
realtime experience.

A notable case has been Planet CCRMA based Red Hat installations,
(http://ccrma-www.stanford.edu/planetccrma/software/), where until recently
jackstart has failed to initiate on a non root environment, in realtime mode.
The upgrade to the latest jack-audio-conection-kit package is therefore
highly recommended, as it probably includes already a Paul Davis'
(JACK's lead developer) patch that targets this specific issue.

This problem is now officially closed, since JACK 0.75.0 release.

Note:

It has been reported that in some systems qjackctl hangs pretty badly after
stopping and restarting the JACK audio daemon, without quitting the application.
That is, each qjackctl running instance may only start and stop JACK only once.
After that, one have to quit and run it back again. This situation only happens
in specific systems, although very deterministically.

If you experience this behaviour, or any other you find annoying, please report
it on the project's page (http://www.sourceforge.net/projects/qjackctl). Remember
to include a description of your system, namely libc, gcc and qt versions.


Acknowledgments
---------------

Qjackctl's user interface layout (and the whole idea for that matter)
was partially borrowed from Lawrie Abbott's jacko project
(http://members.iinet.net.au/~lawrieabbott/pub/jacko),
which was taken from wxWindow/Python into the Qt/C++ arena.

Since 2003-08-06, qjackctl has been included in the awesome Planet CCRMA
(http://ccrma-www.stanford.edu/planetccrma/software/) software collection.
Thanks a lot Fernando!

Enjoy.