aconnect(1) [suse man page]
aconnect(1) General Commands Manual aconnect(1) NAME
aconnect - ALSA sequencer connection manager SYNOPSIS
aconnect [-d] [-options] sender receiver aconnect -i|-o [-options] aconnect -x DESCRIPTION
aconnect is a utility to connect and disconnect two existing ports on ALSA sequencer system. The ports with the arbitrary subscription permission, such as created by aseqview(1), can be connected to any (MIDI) device ports using aconnect. For example, to connect from port 64:0 to 65:0, run as follows: % aconnect 64:0 65:0 The connection is one-way, and the whole data to the sender port (64:0) is redirected to the receiver port (65:0). When another port (e.g. 65:1) is attached to the same sender port, the data is sent to both receiver ports. For disconnection, use -d option. % aconnect -d 64:0 65:0 The address can be given using the client's name. % aconnect External:0 Emu8000:1 Then the port 0 of the client matching with the string "External" is connected to the port 1 of the client matching with the "Emu8000". Another function of aconnect is to list the present ports on the given condition. The input ports, which may become sender ports, can be listed with -i option. % aconnect -i client 0: 'System' [type=kernel] 0 'Timer ' 1 'Announce ' client 64: 'External MIDI-0' [type=kernel] 0 'MIDI 0-0 ' Similarly, to see the output ports, use -o flag. You can remove all existing exported connections using -x option. This function is useful for terminating the ALSA drivers, because the modules with sequencer connections cannot be unloaded unless their connections are removed. OPTIONS
CONNECTION MANAGEMENT -d, --disconnect Disconnect the given subscription. -e, --exclusive Connect ports with exclusive mode. Both sender and receiver ports can be no longer connected by any other ports. -r, --real queue Convert time-stamps of event packets to the current value of the given real-time queue. This is option is, however, not so useful, since the receiver port must use (not necessarily own) the specified queue. -t, --tick queue Like -r option, but time-stamps are converted to the current value of the given tick queue. LIST PORTS -i, --input List existing input (readable) ports. This option is exclusive to -o. -o, --output List existing output (writable) ports. This option is exclusive to -i. -l, --list List the current connection status. The connected and connecting ports from/to each port are listed together. The suffix flag [ex] means the connection is exclusive. The suffix flag [real:#] and [tick:#] mean the connection includes real-time and tick conversion on the listed queue, respectively. REMOVE ALL CONNECTIONS -x, --removeall Remove all exported connections. SEE ALSO
aseqnet(1), aseqview(1) AUTHOR
Takashi Iwai <tiwai@suse.de> August 31, 2000 aconnect(1)
Check Out this Related Man Page
vkeybd(1) General Commands Manual vkeybd(1) NAME
vkeybd - virtual keyboard on X SYNOPSIS
vkeybd [-options] DESCRIPTION
vkeybd is a virtual keyboard for AWE/OSS, MIDI/OSS and ALSA drivers. It's a simple fake of a MIDI keyboard on X-windows system. Enjoy a music with your mouse and computer keyboard :-) OPTIONS
Common Options --device mode Use the specified mode for output device. The argument are awe, midi or alsa, for AWE/OSS, MIDI/OSS and ALSA devices, respectively. Default is alsa. --config file Use the specified file as config file (see section "KEYBOARD"). --preset file Use the specified file as preset list file (see section "PRESET LIST FILE"). --channel num Specify the channel to be played for normal instruments. Valid only for MIDI and ALSA devices. Default is 0. --drum num Specify the channel to be played for drum instruments. Valid only for MIDI and ALSA devices. Default is 9. --octave num Specify the number of octaves to display keys. Default is 3. ALSA Device Option --addr destination Set ALSA client and port numbers to be connected. If argument begins with 's' or 'S', the port is opened as subscription port, and events are sent to all connected subscribers. The port can be connected to other ports via aconnect(1). Otherwise, vkeybd connects directly to the specified port. The argument must be a form like client:port or client.port, where client and port are index num- bers listed in /proc/asound/seq/clients. Default is 's'. --name string Specify the name of client/port. Some applications like tk707 check the client/port name whether it is a valid MIDI device port. This options makes vkeybd possible to "fake" as a real MIDI device. OSS Sequencer Device Options --seqdev file Specify the device file path for sequencer access. As default /dev/sequencer is used. --seqidx num Specify the synth device index for AWE32/64 WaveTable. If negative value is given, the device is auto-probed. Default value is -1. MIDI Device Option --mididev num Speicfy the file path of MIDI device. Default value is /dev/midi. FILE MENU
Connection shows whether the vkeybd connects to the device. On OSS system, only one application is allowed to access sequencer device. Thus, if one wants to play another program even using another device, he needs to disconnect vkeybd once. On ALSA or OSS emulation on ALSA, you don't have to switch vkeybd off, since multiple access is allowed. With Save Config , the current keymap and view configuration are saved on ~/.vkeybdrc config file. This file will be read at the next invoke. VIEW MENU
Thie menu shows the check buttons to toggle the display of control buttons. With Key/Velocity button, a key and a velocity scale bars are shown. The key scale indicates the lowest note value of the visible keyboard (as default 48 = C4). The velocity scale bar is used to change the velocity of each note-on. With Control button, controls for the current channel and for the MIDI continous-controls are enabled. The channel number is increased or decreased by clicking the right or left button around the shown channel number. The bank and preset are remembered for each channel. You may choose the CC to be adjusted by pull-down menu, which indicates ModWheel as default. Then change the parameter value with the scale bar at the right side. With Pitch button, you may adjust pitch wheel. The pitch goes back to the center position when you click the Pitch Clear button at the left. With Program button, the selection list of playing instrument is toggled. The shown presets are read from preset list file. KEYBOARD
Each visible key is mapped on your computer keyboard from 'z' to ''. To use the computer keyboard, you should turn off auto repeat on your X display via xset(1) : % xset -r The key assignment can be changed by editing the config file ~/.vkeybdrc. Once save the current configuration via File/Save Config menu. The config file is the Tcl source, and you may change the list of keymap as you wish. The keymap is a list of elements consisting on the key symbol and the corresponding note offset. The key symbol is the X key symbol for assigned key, and note offset is the shifted note number from note key of beginning of keyboard, which is changed by Key scalebar. For example, when a pair of {a 8} is defined and the lowest MIDI key is 48, a MIDI note 56 will be turned on by pressing the key 'a'. PRESET LIST FILE
The preset list file is used to describe the list of MIDI preset names. If the command line option is omitted, the default preset list file ~/vkeybd.list, ~/.vkeybd.list and $vkblib/vkeybd.list are searched sequentially. The preset list will appear when Program toggle but- ton is on, and you can select a tone to be played from the list. The preset list file can be converted from SoundFont(tm) file via sftovkb(1) utility. For example, % sftovkb synthgm.sbk > vkeybd.list SEE ALSO
sftovkb(1), X(1), xset(1), aconnect(1) AUTHOR
Takashi Iwai <tiwai@suse.de> January 1, 2000 vkeybd(1)