Work at SourceForge, help us to make it a better place! We have an immediate need for a Support Technician in our San Francisco or Denver office.

Close

Tree [r738] / tags / qjackctl_0_1_1a /
History



File Date Author Commit
icons 2003-11-01 rncbc [r65] Release 0.1.1a: Whatever happened to OK button ...
src 2003-11-01 rncbc [r65] Release 0.1.1a: Whatever happened to OK button ...
AUTHORS 2003-11-01 --none-- [r66] This commit was manufactured by cvs2svn to crea...
COPYING 2003-11-01 --none-- [r66] This commit was manufactured by cvs2svn to crea...
ChangeLog 2003-11-01 rncbc [r65] Release 0.1.1a: Whatever happened to OK button ...
INSTALL 2003-11-01 --none-- [r66] This commit was manufactured by cvs2svn to crea...
Makefile.in 2003-10-15 rncbc [r51] Icon install rule fixed again.
README 2003-10-27 rncbc [r61] Open window persistence; patchbay and socket di...
TODO 2003-10-29 rncbc [r63] Release 0.1.1: Minor feature enhancements and b...
configure.in 2003-10-19 rncbc [r55] Connection persistence code intro.
qjackctl.pro 2003-10-27 rncbc [r61] Open window persistence; patchbay and socket di...

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. With time, this primordial interface has become
richer by including a enhanced patchbay and connection control features.

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.80.0 and beyond, on SuSE 8.1, Mandrake 9.1 and RedHat 9,
with a custom 2.4.22 kernel with low-latency, preemptible and capabilities
enabling patches.

One misfeature that still bugs everyone who runs qjackctl and watches for
the messages output window is that stdout/stderr capture from JACK daemon
seems to be somewhat broken. The evident behaviour is that stdout only shows
up on server shutdown, while stderr is captured and shown unbuffered as
expected. This happens regardeless of proper communication settings on the Qt
class responsible for this precise behaviour (QProcess). To date, this has
been kept unsolved.

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 start and stop JACK only once.
After that, one might 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 glibc, 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!

Here are some people who helped this project in one way or another,
and in fair and strict alphabetic order:

    Alexandre Prokoudine
    Austin Acton
    Dave Phillips
    Fernando Pablo Lopez-Lezcano
    Jack O'Quin
    Jesse Chappell
    Kasper Souren
    Lawrie Abbott
    Mark Knecht
    Melanie
    Paul Davis
    Robert Jonsson
    Steve Harris
    Taybin Rutkin

Thanks to you all.