.TH AMIDI 1 "26 Jun 2006".SH NAMEamidi \- read from and write to ALSA RawMIDI ports.SH SYNOPSIS\fBamidi\fP [\fI\-p port\fP] [\fI\-s file\fP | \fI\-S data\fP][\fI\-r file\fP] [\fI\-d\fP] [\fI\-t seconds\fP] [\fI\-a\fP].SH DESCRIPTION.B amidiis a command-line utility which allows to receive and sendSysEx (system exclusive) data from/to external MIDI devices.It can also send any other MIDI commands..B amidihandles only files containing raw MIDI commands, without timinginformation..B amididoes not support Standard MIDI (.mid) files, but.B aplaymidi(1)and.B arecordmidi(1)do..SH OPTIONSUse the.I \-h,.I \-V,.I \-l,or.I \-Loptions to display information;or use at least one of the.I \-s,.I \-r,.I \-S,or.I \-doptions to specify what data to send or receive..TP.I \-h, \-\-helpHelp: prints a list of options..TP.I \-V, \-\-versionPrints the current version..TP.I \-l, \-\-list\-devicesPrints a list of all hardware MIDI ports..TP.I \-L, \-\-list\-rawmidisPrints all RawMIDI definitions.(used when debugging configuration files).TP.I \-p, \-\-port=nameSets the name of the ALSA RawMIDI port to use.If this is not specified,.B amidiuses the default port defined in the configuration file(the default for this is port 0 on card 0, which may not exist)..TP.I \-s, \-\-send=filenameSends the contents of the specified file to the MIDI port.The file must contain raw MIDI commands (e.g. a .syx file);for Standard MIDI (.mid) files, use.B aplaymidi(1)..TP.I \-r, \-\-receive=filenameWrites data received from the MIDI port into the specified file.The file will contain raw MIDI commands (such as in a .syx file);to record a Standard MIDI (.mid) file, use.B arecordmidi(1)..B amidiwill filter out any Active Sensing bytes (FEh), unless the.I \-aoption has been given..TP.I \-S, \-\-send\-hex="..."Sends the bytes specified as hexadecimal numbers to the MIDI port..TP.I \-d, \-\-dumpPrints data received from the MIDI port as hexadecimal bytes.Active Sensing bytes (FEh) will not be shown, unless the.I \-aoption has been given.This option is useful for debugging..TP.I \-t, \-\-timeout=secondsStops receiving data when no data has been received for the specifiedamount of time.If this option has not been given, you must press Ctrl+C (or kill.B amidi\fR)to stop receiving data..TP.I \-a, \-\-active\-sensingDoes not ignore Active Sensing bytes (FEh) when saving or printingreceived MIDI commands..SH EXAMPLES.TP.B amidi \-p hw:0 \-s my_settings.syxwill send the MIDI commands in.I my_settings.syxto port.I hw:0..TP.B amidi \-S 'F0 43 10 4C 00 00 7E 00 F7'sends an XG Reset to the default port..TP.B amidi \-p hw:1,2 \-S F0411042110C000000000074F7 \-r dump.syx \-t 1sends a \(lqParameter Dump Request\(rq to a GS device, saves the receivedparameter data to the file.I dump.syx,and stops after the device has finished sending data(when no data has been received for one second)..TP.B amidi \-p virtual \-dcreates a virtual RawMIDI port and prints all data sent to this port..SH FILES.I /usr/share/alsa/alsa.confdefault rawmidi definitions.br.I /etc/asound.confsystem-wide rawmidi definitions.br.I ~/.asoundrcuser specific rawmidi definitions.SH SEE ALSOaplaymidi(1).brarecordmidi(1).SH AUTHORClemens Ladisch <clemens@ladisch.de>