ARECORDMIDI(1)              General Commands Manual             ARECORDMIDI(1)



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 val-
              ues 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,  rep-
              resenting 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)
