| .TH ARECORDMIDI 1 "17 Sep 2007" |
| |
| .SH NAME |
| arecordmidi \- record Standard MIDI Files |
| |
| .SH SYNOPSIS |
| .B arecordmidi |
| \-p client:port[,...] [options] midifile |
| |
| .SH DESCRIPTION |
| .B 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. |
| |
| .SH OPTIONS |
| |
| .TP |
| .I \-h,\-\-help |
| Prints a list of options. |
| |
| .TP |
| .I \-V,\-\-version |
| Prints the current version. |
| |
| .TP |
| .I \-l,\-\-list |
| Prints a list of possible input ports. |
| |
| .TP |
| .I \-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. |
| |
| .TP |
| .I \-b,\-\-bpm=beats |
| Sets the musical tempo of the MIDI file, in beats per minute. |
| The default value is 120 BPM. |
| |
| .TP |
| .I \-f,\-\-fps=frames |
| Sets the SMPTE resolution, in frames per second. |
| Possible values are 24, 25, 29.97 (for 30 drop-frame), and 30. |
| |
| .TP |
| .I \-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. |
| |
| .TP |
| .I \-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, |
| .B arecordmidi |
| will generate a "format 0" file. |
| |
| .TP |
| .I \-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. |
| |
| .TP |
| .I \-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. |
| |
| .SH AUTHOR |
| Clemens Ladisch <clemens@ladisch.de> |
