1AMIDI(1) General Commands Manual AMIDI(1)
2
6 amidi - read from and write to ALSA RawMIDI ports
7
10 amidi [-p port] [-s file | -S data] [-r file] [-d] [-t seconds] [-a]
11
14 amidi is a command-line utility which allows one to receive and send
15 SysEx (system exclusive) data from/to external MIDI devices. It can
16 also send any other MIDI commands.
17 amidi handles only files containing raw MIDI commands, without timing
19 information. amidi does not support Standard MIDI (.mid) files, but
20 aplaymidi(1) and arecordmidi(1) do.
21
24 Use the -h, -V, -l, or -L options to display information; or use at
25 least one of the -s, -r, -S, or -d options to specify what data to send
26 or receive.
27 -h, --help
30 Help: prints a list of options.
31 -V, --version
34 Prints the current version.
35 -l, --list-devices
38 Prints a list of all hardware MIDI ports.
39 -L, --list-rawmidis
42 Prints all RawMIDI definitions. (used when debugging configura‐
43 tion files)
44 -p, --port=name
47 Sets the name of the ALSA RawMIDI port to use. If this is not
48 specified, amidi uses the default port defined in the configura‐
49 tion file (the default for this is port 0 on card 0, which may
50 not exist).
51 -s, --send=filename
54 Sends the contents of the specified file to the MIDI port. The
55 file must contain raw MIDI commands (e.g. a .syx file); for
56 Standard MIDI (.mid) files, use aplaymidi(1).
57 -r, --receive=filename
60 Writes data received from the MIDI port into the specified file.
61 The file will contain raw MIDI commands (such as in a .syx
62 file); to record a Standard MIDI (.mid) file, use arecord‐
63 midi(1).
64 amidi will filter out any Active Sensing and Clock bytes (FEh,
66 F8h), unless the -a or -c options have been given.
67 -S, --send-hex="..."
70 Sends the bytes specified as hexadecimal numbers to the MIDI
71 port.
72 -d, --dump
75 Prints data received from the MIDI port as hexadecimal bytes.
76 Active Sensing and Clock bytes (FEh, F8h) will not be shown,
77 unless the -a or -c options have been given.
78 This option is useful for debugging.
80 -t, --timeout=seconds
83 Stops receiving data when no data has been received for the
84 specified amount of time.
85 If this option has not been given, you must press Ctrl+C (or
87 kill amidi) to stop receiving data.
88 -a, --active-sensing
91 Does not ignore Active Sensing bytes (FEh) when saving or print‐
92 ing received MIDI commands.
93 -c, --clock
96 Does not ignore Clock bytes (F8h) when saving or printing
97 received MIDI commands.
98 -i, --sysex-interval=mseconds
101 Adds a delay in between each SysEx message sent to a device. It
102 is useful when sending firmware updates via SysEx messages to a
103 remote device.
104
107 amidi -p hw:0 -s my_settings.syx
108 will send the MIDI commands in my_settings.syx to port hw:0.
109 amidi -p hw:1,0,0 -s firmware.syx -i 100
112 will send the MIDI commands in firmware.syx to port hw:1,0,0
113 with 100 milliseconds delay in between each SysEx message.
114 amidi -S 'F0 43 10 4C 00 00 7E 00 F7'
117 sends an XG Reset to the default port.
118 amidi -p hw:1,2 -S F0411042110C000000000074F7 -r dump.syx -t 1
121 sends a “Parameter Dump Request” to a GS device, saves the
122 received parameter data to the file dump.syx, and stops after
123 the device has finished sending data (when no data has been
124 received for one second).
125 amidi -p virtual -d
128 creates a virtual RawMIDI port and prints all data sent to this
129 port.
130
133 /usr/share/alsa/alsa.conf default rawmidi definitions
134 /etc/asound.conf system-wide rawmidi definitions
135 ~/.asoundrc user specific rawmidi definitions
136
139 aplaymidi(1)
140 arecordmidi(1)
141
144 Clemens Ladisch <clemens@ladisch.de>
145 30 Aug 2016 AMIDI(1)