NAME

       arecordmidi - record Standard MIDI Files

SYNOPSIS

       arecordmidi -p client:port[,...] [options] midifile

DESCRIPTION

       arecordmidi  is  a command-line utility that records a Standard MIDI File from one or more ALSA sequencer
       ports.

       To stop recording, press Ctrl+C.

OPTIONS

       -h,--help
              Prints a list of options.

       -V,--version
              Prints the current version.

       -l,--list
              Prints a list of possible input ports.

       -p,--port=client:port,...
              Sets the sequencer port(s) from which events are recorded.

              A client can be specified by its number, its name, or a prefix of its name. A port is specified by
              its number; for port 0 of a client, the ":0" part of the port specification can be omitted.

       -b,--bpm=beats
              Sets the musical tempo of the MIDI file, in beats per minute.  The default value is 120 BPM.

       -f,--fps=frames
              Sets the SMPTE resolution, in frames per second.  Possible values are 24, 25, 29.97 (for 30  drop-
              frame), and 30.

       -t,--ticks=ticks
              Sets  the resolution of timestamps (ticks) in the MIDI file, in ticks per beat (when using musical
              tempo) or ticks per frame (when using SMPTE timing).  The default value is 384  ticks/beat  or  40
              ticks/frame, respectively.

       -s,--split-channels
              Specifies  that  the  data for each MIDI channel should be written to a separate track in the MIDI
              file.  This will result in  a  "format  1"  file.   Otherwise,  when  there  is  only  one  track,
              arecordmidi will generate a "format 0" file.

       -m,--metronome=client:port
              Plays a metronome signal on the specified sequencer port.

              Metronome  sounds  are  played  on  channel  10,  MIDI notes 33 & 34 (GM2/GS/XG metronome standard
              notes), with velocity 100 and duration 1.

       -i,--timesig=numerator:denominator
              Sets the time signature for the MIDI file and metronome.

              The time signature is specified  as  usual  with  two  numbers,  representing  the  numerator  and
              denominator  of the time signature as it would be notated. The denominator must be a power of two.
              Both numbers should be separated by a colon. The time signature is 4:4 by default.

AUTHOR

       Clemens Ladisch <clemens@ladisch.de>

                                                   17 Sep 2007                                    ARECORDMIDI(1)