Add brief documentation

git-svn-id: file:///home/vcs/svn/jsweeper/trunk@26 6611ac79-6612-48ef-a1e9-b906f853523e
master
petern 2009-12-02 14:50:40 +00:00
parent 0ed2dbe4ff
commit 31af6e82b2
1 changed files with 39 additions and 0 deletions

39
README.TXT 100644
View File

@ -0,0 +1,39 @@
jsweeper
--------
JACK Sweeper is a port connection manager with support for port aliases and
port groups. It is named after Minesweeper, due to the port grid it uses.
By using port aliases and port groups, it is able to fit larger numbers of
ports on screen than just by showing ports as is.
It can talk to torbenh's sessionmanager.py via DBus calls.
The configuration file is stored in XDG_CONFIG_DIR/jsweeper/jsweeper.ini
Alias examples
--------------
Rules are evaluated sequentially, so rules at the start have precedence over
later rules. These two rules will group most stereo ports of most programs.
(.*)[_ -]1$ = \1.L
(.*)[_ -]2$ = \2.R
Rules can be used to rename ports logically, for example with an M-Audio 2496
the following rules give human-meaningful names to the output ports.
system:playback_1$ = system:line.L
system:playback_2$ = system:line.R
system:playback_9$ = system:spdif.L
system:playback_10$ = system:spdif.R
Client-side or JACK aliases can be also be selected in the configuration. Due
to how JACK aliases work, client-side aliases can give better results.
TODO
----
Automatic connections (aka 'Patchbay') are not implemented.
GUI-based alias editing and some other GUI elements are not implemented.