File: midi2abc.1

package info (click to toggle)
abcmidi 17-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 792 kB
  • ctags: 1,455
  • sloc: ansic: 17,345; makefile: 104
file content (133 lines) | stat: -rw-r--r-- 4,315 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
.TH MIDI2ABC 1 "26. June 1999"
.SH NAME
\fBmidi2abc\fP \- program to convert MIDI format files to abc notation
.SH SYNOPSIS
midi2abc -f \fIinfile\fP [-xa] [-ga]
[-a \fIacbeats\fP] [-m \fItime signature\fP] [-xm] 
[-xl] [-b \fIbars\fP] [-Q \fItempo\fP]
[-k \fIkey\fP] [-c \fIchannel\fP]
.SH DESCRIPTION
\fImidi2abc\fP takes a MIDI format file and converts it to something as close
as possible to abc text format. The user then has to add text fields not
present in the MIDI header and possibly tidy up the abc note output.
.PP
The output of midi2abc is printed to the screen. To save it to a file, use
the redirection operator, e.g. \fImidi2abc -f file.mid > file.abc\fP.
.PP
Only the -f option is compulsory. Use only one of -xl, -b and -Q.
If none of these is present, the program attempts to guess a 
suitable note length.
.PP
If the MIDI file is computer-generated, you may be able to extract the time
signature from it using the -xm option. Otherwise you should specify it with
-m. Allowable time signatures are C, 4/4, 3/8, 2/4 and so on.
.PP
If the tune has an anacrusis, you should specify the number of beats in
it using the -a option. 
.SS OPTIONS
.TP
.B -a \fIacbeats\fP
beats in anacrusis>
.TP
.B -xa
extract anacrusis from file (find first strong note)
.TP
.B -ga
guess anacrusis (minimize ties across bars)
.TP
.B -m \fItime signature\fP
time signature
.TP
.B -xm
extract time signature from file
.TP
.B -xl
extract absolute note lengths from file
.TP
.B -b \fIbars\fP
bars wanted in output
.TP
.B -Q \fItempo\fP
tempo in quarter-notes per minute
.TP
.B -k \fIkey\fP
key signature: -6 to 6 sharps
.TP
.B -c \fIchannel\fP
select only this midi channel
.TP
.B -f \fIinfile\fP
input file in midi format
.SS FEATURES
* The key is chosen so as to minimize the number of accidentals. 
Alternatively, the user can specify the key numerically (a positive number
is the number of sharps, a negative number is minus the number of flats).
.PP
* Note length can be set by specifiying the total number of bars or the 
tempo of the piece. Alternatively the note length can be read from the file.
However, by default it is deduced in a heuristic manner from the inter-note 
distances.  This means that you do not have to use the MIDI clock as a 
metronome when playing in a tune from a keyboard. 
.PP
* Barlines are automatically inserted. The user specifies the number of
measures in the anacrusis before the first barline and the time signature.
.PP
* The program can guess how many beats there should be in the anacrusis,
either by looking for the first strong note or minimizing the number of
notes split by a tie across a barline.
.PP
* Where a note extends beyond a bar break, it is split into two tied notes.
.PP
* The output has 4 bars per line.
.PP
* Enough accidental signs are put in the music to ensure that no pitch
errors occur if a barline is added or deleted.
.PP
* The program attempts to group notes sensibly in each bar.
.PP
* Triplets and broken rhythm (a>b) are supported.
.PP
* Chords are identified.
.PP
* Text information from the original MIDI file is included as comments.
.PP
* The -c option can be used to select only 1 MIDI channel. Events on 
other channels are ignored.
.SS LIMITATIONS
midi2abc does not ...
.PP
* Supply tune title, composer or any other field apart from X: , K:, Q:, M:
and L: - these must be added by hand afterwards, though they may have been
included in the text of the MIDI file.
.PP
* Support duplets, quadruplets, other esoteric features.
.PP
* Support mid-tune key or time signature changes.
.PP
* Deduce repeats. The output is just the notes in the input file.
.PP
* Recover an abc tune as supplied to abc2midi. However, if you want to
do this, "midi2abc -xm -xl -xa -f file.mid" comes close.
.SH "SEE ALSO"
abc2ps(1), abc2midi(1), abc2abc(1)
.SH AUTHOR
James Allwright <J.R.Allwright@westminster.ac.uk>
.SH VERSION
This man page describes midi2abc version 2.0.7 from January 1999.
.SH COPYRIGHT
Copyright 1999 James Allwright
.PP
midi2abc is supplied "as is" without any warranty. It
is free software and can be used, copied, modified and
distributed without fee under the terms of the GNU General 
Public License.