diff --git a/README.md b/README.md index 003b5df..b1610f1 100644 --- a/README.md +++ b/README.md @@ -76,7 +76,7 @@ The midizap program is a command line application, so you typically run it from Try `midizap -h` for a brief summary of the available options with which the program can be invoked. -midizap uses [Jack][] for doing all its MIDI input and output, so you need to be able to run Jack and connect the Jack MIDI inputs and outputs of the program. We recommend using a Jack front-end and patchbay program like [QjackCtl][] for this purpose. In QjackCtl's setup, make sure that you have selected `seq` as the MIDI driver. This exposes the ALSA sequencer ports of your MIDI hardware and other non-Jack ALSA MIDI applications as Jack MIDI ports, so that they can easily be connected to midizap. (We're assuming that you're using Jack1 here. Jack2 works in a very similar way, but may require some more fiddling; in particular, you may have to use [a2jmidid][] as a separate ALSA-Jack MIDI bridge in order to have the ALSA MIDI devices show properly as Jack MIDI devices.) +midizap uses [Jack][] for doing all its MIDI input and output, so you need to be able to run Jack and connect the Jack MIDI inputs and outputs of the program. We recommend using a Jack front-end and patchbay program like [QjackCtl][] for this purpose. In QjackCtl's setup, make sure that you have selected `seq` as the MIDI driver. This exposes the ALSA sequencer ports of your MIDI hardware and other non-Jack ALSA MIDI applications as Jack MIDI ports, so that they can easily be connected to midizap. As an alternative, you can also run [a2jmidid][] as a separate ALSA-Jack MIDI bridge. (The latter method will work with both Jack1 and Jack2, the former method is only recommended if you're using Jack1.) Having that set up, start Jack, make sure that your MIDI controller is connected, and try running `midizap` from the command line (without any arguments). In QjackCtl, open the Connections dialog and activate the second tab named "MIDI", which shows all available Jack MIDI inputs and outputs. On the right side of the MIDI tab, you should now see a client named `midizap` with one MIDI input port named `midi_in`. That's the one you need to connect to your MIDI controller, whose output port should be visible under the `alsa_midi` client on the left side of the dialog. diff --git a/midizap.1 b/midizap.1 index 26d3f61..6b36c26 100644 --- a/midizap.1 +++ b/midizap.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 2.2.3.2 +.\" Automatically generated by Pandoc 2.3.1 .\" .TH "midizap" "1" "" "" "" .hy @@ -218,12 +218,11 @@ the MIDI driver. This exposes the ALSA sequencer ports of your MIDI hardware and other non\-Jack ALSA MIDI applications as Jack MIDI ports, so that they can easily be connected to midizap. -(We're assuming that you're using Jack1 here. -Jack2 works in a very similar way, but may require some more fiddling; -in particular, you may have to use +As an alternative, you can also run a2jmidid (http://repo.or.cz/a2jmidid.git) as a separate ALSA\-Jack MIDI -bridge in order to have the ALSA MIDI devices show properly as Jack MIDI -devices.) +bridge. +(The latter method will work with both Jack1 and Jack2, the former +method is only recommended if you're using Jack1.) .PP Having that set up, start Jack, make sure that your MIDI controller is connected, and try running \f[C]midizap\f[] from the command line