amidi - read from and write to ALSA RawMIDI ports
amidi [-p port] [-s file | -S data] [-r file] [-d] [-t seconds] [-a]
amidi is a command-line utility which allows to receive and send SysEx
(system exclusive) data from/to external MIDI devices. It can also
send any other MIDI commands.
amidi handles only files containing raw MIDI commands, without timing
information. amidi does not support Standard MIDI (.mid) files, but
aplaymidi(1) and arecordmidi(1) do.
Use the -h, -V, -l, or -L options to display information; or use at
least one of the -s, -r, -S, or -d options to specify what data to send
Help: prints a list of options.
Prints the current version.
Prints a list of all hardware MIDI ports.
Prints all RawMIDI definitions. (used when debugging configura-
Sets the name of the ALSA RawMIDI port to use. If this is not
specified, amidi uses the default port defined in the configura-
tion file (the default for this is port 0 on card 0, which may
Sends 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 aplaymidi(1).
Writes 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 arecord-
amidi will filter out any Active Sensing bytes (FEh), unless the
-a option has been given.
Sends the bytes specified as hexadecimal numbers to the MIDI
Prints data received from the MIDI port as hexadecimal bytes.
Active Sensing bytes (FEh) will not be shown, unless the -a
option has been given.
This option is useful for debugging.
Stops receiving data when no data has been received for the
specified amount of time.
If this option has not been given, you must press Ctrl+C (or
kill amidi) to stop receiving data.
Does not ignore Active Sensing bytes (FEh) when saving or print-
ing received MIDI commands.
amidi -p hw:0 -s my_settings.syx
will send the MIDI commands in my_settings.syx to port hw:0.
amidi -S â€â€™F0 43 10 4C 00 00 7E 00 F7â€â€™
sends an XG Reset to the default port.
amidi -p hw:1,2 -S F0411042110C000000000074F7 -r dump.syx -t 1
sends a â€śParameter Dump Requestâ€ť to a GS device, saves the
received parameter data to the file dump.syx, and stops after
the device has finished sending data (when no data has been
received for one second).
amidi -p virtual -d
creates a virtual RawMIDI port and prints all data sent to this
/usr/share/alsa/alsa.conf default rawmidi definitions
/etc/asound.conf system-wide rawmidi definitions
~/.asoundrc user specific rawmidi definitions
The --list-devices option pretends that output and input ports are the
Clemens Ladisch <email@example.com>
15 Feb 2005 AMIDI(1)
Man(1) output converted with