Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

amidi(1) [centos man page]

AMIDI(1)						      General Commands Manual							  AMIDI(1)

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 bytes (FEh), unless the -a option has 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 bytes (FEh) will not be shown, unless the -a option has 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 receiving data. -a, --active-sensing Does not ignore Active Sensing bytes (FEh) when saving or printing received MIDI commands. EXAMPLES
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 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> 26 Jun 2006 AMIDI(1)

Check Out this Related Man Page

QMIDIROUTE(1)						      General Commands Manual						     QMIDIROUTE(1)

qmidiroute - MIDI event processor and router SYNOPSIS
qmidiroute [OPTION] [file] qmidiroute { --help | --version } DESCRIPTION
qmidiroute is a versatile MIDI event processor and router for the ALSA sequencer. The graphical interface is based on the Qt4 toolkit. qmidiroute permits setting up an unlimited number of MIDI maps in which incoming events are selected, modified or even changed in type before being directed to a dedicated ALSA output port. The maps work in parallel, and they are organized in tabs. With qmidiroute it is for example possible to change or invert the scale of a keyboard, to transform keyboard strokes into program changes or controller data into notes. Incoming MIDI events can be logged in a list and are displayed in different colors according to their MIDI type. qmidiroute provides one ALSA input port and as default two ALSA output ports. The numerical ALSA client id is displayed as part of the window title. General Usage After starting the application, the Unmatched tab is presented (see below). To start MIDI routing setup, the New map... button can be clicked, which will create a new MIDI map appearing as a tab in the map area. The entire setup can be saved to and loaded from a QMidiRoute file (.qmr). Several maps can be created to work in parallel. The maps can be organized using the Map Rename, Remove and Clone buttons. The Event Log is displayed in the bottom area by default, but can be hidden if not needed or floated as a top-level window on the desktop. Log- ging can also be disabled generally or for MIDI Clock events only. MIDI Input The Input field represents the incoming event filter of each map. Handled event types are Note, Controller, Pitchbend and Program Change. The events can be filtered by their respective values or by MIDI channel. Events matching the conditions specified in the Input field are directed to the Output field. MIDI Output The Output field sets terms into which event type the matching events are transformed, how their channel and values are transformed, and to which ALSA port they are directed. Channels and Values can be set Fixed, Offset or Reverse Offset with respect to the input event. As an example, Reverse Offset will take the value specified and subtract the incoming event value from it to produce the output event value. If the output range for a value is different from its input counterpart, the input range will be smoothly scaled to the output range. Events will be sent to the ALSA port specified. The number of available ALSA ports can be set using the corresponding command-line option. Unmatched MIDI events In the Unmatched tab, the handling of events not matching any input filter of the defined maps is specified. These events can be discarded or sent to a specified ALSA port. OPTIONS
--portCount <num> Set the number of available ALSA output ports to <num>. The default is 2. --help Print possible command-line options and exit. --version Print version information and exit. file Name of a valid QMidiRoute (.qmr) file to be loaded on start. FILES
*.qmr QMidiRoute files containing MIDI routing data in plain text format. EXAMPLES
An example MIDI map file can be found in /usr/share/qmidiroute or in /usr/local/share/qmidiroute NOTES
Errors and warnings are written to stderr(3). SUPPORT
alsamodular-devel@lists.sourceforge.net AUTHORS
Matthias Nagorni, Frank Kober and Guido Scholz. This manual page was written by Frank Kober <emuse@users.sourceforge.net>. 2009-09-13 QMIDIROUTE(1)
Man Page

Featured Tech Videos