X: 1
T:Paddy O'Rafferty
C:Trad.
M:6/8
F:http://abcnotation.com/blog/2010/01/31/how-to-understand-abc-the-basics/	 2024-04-24 135237 UT
K:D
dff cee|def gfe|dff cee|dfe dBA|dff cee|def gfe|faf gfe|1 dfe dBA:|2 dfe dcB|]
~A3 B3|gfe fdB|AFA B2c|dfe dcB|~A3 ~B3|efe efg|faf gfe|1 dfe dcB:|2 dfe dBA|]
fAA eAA|def gfe|fAA eAA|dfe dBA|fAA eAA|def gfe|faf gfe|dfe dBA:|</pre>
<p>We will now look at all the elements of this tune in more detail.</p>
<h2><a name="tuneheader"></a>The header</h2>
<p>First, notice that each line of the header starts with a different letter telling you what information it contains &#8211; the first line, &#8220;X:1&#8221;, is just a reference number (see below), then the line beginning T: contains the <strong>T</strong>itle of the tune and the line beginning C: contains the <strong>C</strong>omposer (in this case it&#8217;s a traditional one &#8211; the composer&#8217;s name has been lost in the mists of time).</p>
<p>In abc-speak, these lines are sometimes known as <strong>fields </strong>&#8211; you may hear people talking about the &#8220;T field&#8221; or the &#8220;C field&#8221; &#8211; they just mean the <strong>title </strong>or the <strong>composer</strong>.</p>
<p>Each tune can contain a lot of background information so there are fields to cover almost every eventuality. For now, however, the only other fields you need to know about are X, M &amp; K for the header and the L field which we will look at below.</p>
<p>M: and K: are straightforward and define the <strong>meter </strong>and the <strong>key </strong>of the tune &#8211; the example above is a 6/8 tune (a jig) in D (two sharps). If you leave out the M: field, most abc software will assume you want common time &#8211; i.e. M:C. However, you must include the K: field which also tells abc software where the header ends and the notes start.</p>
<p>Finally the X: field just contains a <strong>reference </strong>number. This is not so important now that there&#8217;s loads of good <strong><a href="/software">software</a></strong> that allows you to pick tunes with the click of a mouse, but in the early days of abc it was useful for selecting specific tunes from a file.</p>
<p>Note that some people choose to store each tune in a separate file and so you may sometimes encounter tunes without an X: field. However, not all abc software recognises these as tunes so it&#8217;s best, especially if you want to share tunes with friends, to always include an X: field, even if you only ever use X:1.</p>
<p>The only other thing you need know is the <strong>order </strong>&#8211; each tune should start with an X: field, followed by a T: field and the header then ends at the K: field.</p>
<p>Apart from that you can put the other fields (e.g. the C: and M: fields in the example above) in any order.  You can also have as many as you want. We will cover other fields and how to use them in a subsequent article &#8211; see the links at the bottom of this article.</p>
<h2><a name="notes"></a>The notes</h2>
<p>The notes of the tune start after the first K: field.</p>
<p>Each note is written as a separate letter and &#8211; surprise, surprise &#8211; the letter C represents the note C, D represents D, and so on.</p>
<p>Upper case (capital) letters, CDEFGAB, are used to denote the bottom octave (C represents middle C, on the first leger line below the treble stave), continuing with lower case letters for the top octave, cdefgab (b is the one above the first leger line above the stave).</p>
<p>To go down an octave, just put a comma after the letter and to go up an octave use an apostrophe.</p>
<p>Here are four octaves shown both in abc notation and staff notation:</p>
<pre class="larger">X:1
T:Notes
M:C
L:1/4
K:C
C, D, E, F,|G, A, B, C|D E F G|A B c d|e f g a|b c' d' e'|f' g' a' b'|]</pre>
<p><span style="text-decoration: line-through;"><img decoding="async" class="alignnone" title="example - notes" src="/res/img/examples/Notes.gif" alt="" width="432" height="99" /></span></p>
<p>Notice one other thing about this example &#8211; the L: field, which sets the <strong>basic note length</strong> and in this case, L:1/4 tells abc software that each letter in the notes section represents a crotchet or quarter note.</p>
<p>This brings us to the next topic &#8230;</p>
<h3><a name="lengths"></a>Note lengths</h3>
<p>Now we know how to pitch notes, the other important thing is their length.</p>
<p>Firstly, you can set a basic note length for every note via the L: field &#8211; so that L:1/16 would mean that each letter in the notes section represents a semi-quaver or sixteenth note and similarly L:1/8 implies that they are quavers or eighth notes.</p>
<p>If you leave out the L: field, most abc software will assume you want the basic note length to be eighth notes (although some software sets the basic note length according to the meter, so if in doubt, include an L: field).</p>
<p>Having set the basic length you can modify the length of an individual note by putting a number after it. For example, in the second line of the tune Paddy Rafferty given above, the first four bars are:</p>
<pre class="larger">~A3 B3|gfe fdB|AFA B2c|dfe dcB|</pre>
<p>So here, since the basic note length is eighth notes (quavers), the B2 in the third bar represents a quarter note (crotchet) &#8211; i.e. 2 times as long as an eighth note, whilst the A3 and B3 in the first bar represent dotted quarter notes &#8211; i.e. 3 times as long as an eighth note.</p>
<p>If the note is above or below the stave then the note length comes after the comma or apostrophe &#8211; e.g. c&#8217;4 is a half note (minim) on high C.</p>
<p>To shorten the length of a note, just follow it by a / and the appropriate length &#8211; e.g. if A is an eighth note, then A/2 is a sixteenth (semi-quaver). You can also use a / as shorthand for /2  so that A/ also represents a sixteenth note.</p>
<p>Finally, you can change the basic note length at any point in a tune. The following example demonstrates all the different note length possibilities (some pretty uncommon) for 3 different values of the basic note length:</p>
<pre class="larger">X:1
T:Note lengths and default note length
M:C
K:C
L:1/16
A/2 A/ A A2 A3 A4 A6 A7 A8 A12 A15 A16|]
L:1/8
A/4 A/2 A/ A A2 A3 A4 A6 A7 A8 A12 A15|]
L:1/4
A/8 A/4 A/2 A/ A A2 A3 A4 A6 A7|]</pre>
<p><img decoding="async" loading="lazy" class="alignnone" title="example - note lengths" src="/res/img/examples/Note-lengths.gif" alt="" width="432" height="175" /></p>
<h3><a name="barlines"></a>Bar lines</h3>
<p>Bar lines are easily inserted with a | symbol and you can use || for a double bar line or |] for a thin-thick double bar line.</p>
<p>Similarly |: represents the start of a repeated section and :| represents the end.</p>
<p>Where one repeated section ends and a new one starts, use :||: or :: for short.</p>
<p>Alternate repeats are represented by [1 and [2 and, if these are adjacent to a bar line, the [ can be omitted, so that |1 is short for |[1.</p>
<h3><a name="beams"></a>Beams</h3>
<p>To put two or more eighth or sixteenth notes together under a beam, just put them next to each other with no space in between.</p>
<p>The following example show various choices of beaming:</p>
<pre class="larger">X:1
T:Beams
M:C
K:C
A B c d AB cd|ABcd ABc2|]</pre>
<p><img decoding="async" loading="lazy" class="alignnone" title="example - beams" src="/res/img/examples/Beams.gif" alt="" width="432" height="64" /></p>
<h2><a name="alltogether"></a>Putting it all together</h2>
<p>Although there&#8217;s plenty more to learn, with the information contained in this article you should be able to figure out 90% of most tunes.</p>
<p>However, to finish off, we just need to know that the ~ (tilde) symbol represents an ornament, such as a roll or turn in Irish music.</p>
<p>We now have all the tools required to interpret the abc of Paddy O&#8217;Rafferty shown above. Here it is again, with the staff notation underneath:</p>
<pre class="larger">X:1
T:Paddy O'Rafferty
C:Trad.
M:6/8
K:D
dff cee|def gfe|dff cee|dfe dBA|dff cee|def gfe|faf gfe|1 dfe dBA:|2 dfe dcB|]
~A3 B3|gfe fdB|AFA B2c|dfe dcB|~A3 ~B3|efe efg|faf gfe|1 dfe dcB:|2 dfe dBA|]
fAA eAA|def gfe|fAA eAA|dfe dBA|fAA eAA|def gfe|faf gfe|dfe dBA:|</pre>
<p><img decoding="async" loading="lazy" class=" alignnone" title="example - Paddy O'Rafferty" src="/res/img/examples/Jigs.gif" alt="example - Paddy ORafferty" width="433" height="352" /></p>
<h2><a name="further"></a>Further reading</h2>
<p>Probably the best way to carry on from here is just to try some playing around with and perhaps modifying some examples. There are  plenty of tunes to try out in the <strong><a href="/search">abc tune search</a></strong> and the <strong><a href="/blog/2009/12/23/how-to-get-started-with-abc-notation/">previous article</a></strong> in this series has a link to an online converter so you can see how changes you make affect the music.</p>
<p>You could also read another article in this series [more to follow]:</p>
<ul>
<li>Previous article &#8211; &#8220;<strong><a href="/blog/2009/12/23/how-to-get-started-with-abc-notation/">How to get started with abc notation</a></strong>&#8220;</li>
<li>Next article &#8211; [to follow shortly]</li>
</ul>
<p>Finally, there are plenty other pages which can help to explain abc, such as the <strong><a href="/examples">examples</a></strong> page on this website, Steve Mansfield&#8217;s excellent <strong><a onclick="javascript:pageTracker._trackPageview('/outgoing/www.lesession.co.uk/abc/abc_notation.htm');"  href="http://www.lesession.co.uk/abc/abc_notation.htm">tutorial</a></strong> and John Chambers&#8217; <strong><a onclick="javascript:pageTracker._trackPageview('/outgoing/trillian.mit.edu/~jc/music/abc/ABC-FAQ.html');"  href="http://trillian.mit.edu/~jc/music/abc/ABC-FAQ.html">FAQ</a></strong>.</p>
<p>Have fun!</p>
<p>Chris Walshaw</p>


[P=get.cgi V=1/1 B=0 scale=0.60 512x512 ]
filesizedescription
Tune-77189-get.log 4744 Log file, useful mostly for debugging
Tune-77189-how-to-understand-abc-the-basics.abc 9889 ABC music file with the extracted tune(s)
Tune-77189-how-to-understand-abc-the-basics.txt 9889 Plain-text file with the extracted tune(s)
These files should be available for 24 hours.