Content
Data
license:
Version: 1.1.8 (in Debian 10)
Developer / owner:
Short description:
The manual page and help for the amidi linux command. Amidi is a command line utility that allows you to receive and send SysEx (systemless) data from external MIDI devices. The program can also send other MIDI commands.
Amidi only handles files that contain raw MIDI commands, without timing information. Amidi does not support standard MIDI (.mid) files, but aplaymidi (1) and arecordmidi (1) do.
Man page output
man amidi
AMIDI(1) General Commands Manual AMIDI(1) NAME amidi - read from and write to ALSA RawMIDI ports SYNOPSIS amidi [-p port] [-s file | -S data] [-r file] [-d] [-t seconds] [-a] DESCRIPTION amidi is a command-line utility which allows one 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. OPTIONS 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 or receive. -h, --help Help: prints a list of options. -V, --version Prints the current version. -l, --list-devices Prints a list of all hardware MIDI ports. -L, --list-rawmidis Prints all RawMIDI definitions. (used when debugging configuration files) -p, --port=name Sets the name of the ALSA RawMIDI port to use. If this is not specified, amidi uses the default port defined in the configuration file (the default for this is port 0 on card 0, which may not exist). -s, --send=filename 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). -r, --receive=filename 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 arecordmidi(1). amidi will filter out any Active Sensing and Clock bytes (FEh, F8h), unless the -a or -c options have been given. -S, --send-hex="..." Sends the bytes specified as hexadecimal numbers to the MIDI port. -d, --dump Prints data received from the MIDI port as hexadecimal bytes. Active Sensing and Clock bytes (FEh, F8h) will not be shown, unless the -a or -c options have been given. This option is useful for debugging. -t, --timeout=seconds 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 receiv‐ ing data. -a, --active-sensing Does not ignore Active Sensing bytes (FEh) when saving or printing received MIDI com‐ mands. -c, --clock Does not ignore Clock bytes (F8h) when saving or printing received MIDI commands. -i, --sysex-interval=mseconds Adds a delay in between each SysEx message sent to a device. It is useful when sending firmware updates via SysEx messages to a remote device. EXAMPLES amidi -p hw:0 -s my_settings.syx will send the MIDI commands in my_settings.syx to port hw:0. amidi -p hw:1,0,0 -s firmware.syx -i 100 will send the MIDI commands in firmware.syx to port hw:1,0,0 with 100 milliseconds delay in between each SysEx message. 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 port. FILES /usr/share/alsa/alsa.conf default rawmidi definitions /etc/asound.conf system-wide rawmidi definitions ~/.asoundrc user specific rawmidi definitions SEE ALSO aplaymidi(1) arecordmidi(1) AUTHOR Clemens Ladisch <clemens@ladisch.de> 30 Aug 2016 AMIDI(1)
Help output
amidi --help
Usage: amidi options -h, --help this help -V, --version print current version -l, --list-devices list all hardware ports -L, --list-rawmidis list all RawMIDI definitions -p, --port=name select port by name -s, --send=file send the contents of a (.syx) file -r, --receive=file write received data into a file -S, --send-hex="..." send hexadecimal bytes -d, --dump print received data as hexadecimal bytes -t, --timeout=seconds exits when no data has been received for the specified duration -a, --active-sensing include active sensing bytes -c, --clock include clock bytes -i, --sysex-interval=mseconds delay in between each SysEx message
Related Content
- 15 views