arecordmidi.1 (2203B)
1 .TH ARECORDMIDI 1 "17 Sep 2007" 2 3 .SH NAME 4 arecordmidi \- record Standard MIDI Files 5 6 .SH SYNOPSIS 7 .B arecordmidi 8 \-p client:port[,...] [options] midifile 9 10 .SH DESCRIPTION 11 .B arecordmidi 12 is a command-line utility that records a Standard MIDI File from one or 13 more ALSA sequencer ports. 14 15 To stop recording, press Ctrl+C. 16 17 .SH OPTIONS 18 19 .TP 20 .I \-h,\-\-help 21 Prints a list of options. 22 23 .TP 24 .I \-V,\-\-version 25 Prints the current version. 26 27 .TP 28 .I \-l,\-\-list 29 Prints a list of possible input ports. 30 31 .TP 32 .I \-p,\-\-port=client:port,... 33 Sets the sequencer port(s) from which events are recorded. 34 35 A client can be specified by its number, its name, or a prefix of its 36 name. A port is specified by its number; for port 0 of a client, the 37 ":0" part of the port specification can be omitted. 38 39 .TP 40 .I \-b,\-\-bpm=beats 41 Sets the musical tempo of the MIDI file, in beats per minute. 42 The default value is 120 BPM. 43 44 .TP 45 .I \-f,\-\-fps=frames 46 Sets the SMPTE resolution, in frames per second. 47 Possible values are 24, 25, 29.97 (for 30 drop-frame), and 30. 48 49 .TP 50 .I \-t,\-\-ticks=ticks 51 Sets the resolution of timestamps (ticks) in the MIDI file, 52 in ticks per beat (when using musical tempo) or ticks per frame 53 (when using SMPTE timing). 54 The default value is 384 ticks/beat or 40 ticks/frame, respectively. 55 56 .TP 57 .I \-s,\-\-split\-channels 58 Specifies that the data for each MIDI channel should be written to a 59 separate track in the MIDI file. 60 This will result in a "format 1" file. 61 Otherwise, when there is only one track, 62 .B arecordmidi 63 will generate a "format 0" file. 64 65 .TP 66 .I \-m,\-\-metronome=client:port 67 Plays a metronome signal on the specified sequencer port. 68 69 Metronome sounds are played on channel 10, MIDI notes 33 & 34 (GM2/GS/XG 70 metronome standard notes), with velocity 100 and duration 1. 71 72 .TP 73 .I \-i,\-\-timesig=numerator:denominator 74 Sets the time signature for the MIDI file and metronome. 75 76 The time signature is specified as usual with two numbers, representing 77 the numerator and denominator of the time signature as it would be 78 notated. The denominator must be a power of two. Both numbers should be 79 separated by a colon. The time signature is 4:4 by default. 80 81 .SH AUTHOR 82 Clemens Ladisch <clemens@ladisch.de>