Skip to main content

ABC Notation (.abc)

Introductionโ€‹

abc notation is a shorthand form of musical notation for computers. In basic form it uses the letters A through G, letter accidentals, and numbers to represent notes, and other elements are used to place composition-wide elements โ€” meter, tempo, key, and so on โ€” and note-specific elements such as ornaments and note lengths.

abc notation was originally intended as a compact ASCII format usable in email, but has grown into a fully-fledged music description language.

ABC notation standard v2.1

Compatibility Level: Basic support.

alphaTab reads ABC as piano-style notation. It parses letter+octave pitches, durations against the tune's unit note length, chords, tuplets, grace notes, ties, slurs, bars and repeats, voltas, multi-voice bodies, %%score staff grouping, and the common set of decorations and dynamics. ABC's tablature dialects (fret/string notation, custom tab clefs) are outside the v1 scope.

ABC areas that do not have a matching alphaTab model surface are dropped with a diagnostic (via Logger.warning) rather than being silently corrupted. This affects, among other things, non-default accidental propagation modes, macro expansion (m:), symbol lines (s:), part play-order (P:ABABC), stylesheet directives beyond %%score, and I:abc-include. Where an ABC feature can only be approximated (modal keys collapsed to the nearest major/minor, additive meters summed to a single numerator, exotic clefs rounded to the nearest supported clef), the approximation is applied and a warning is emitted so that the loss is visible to callers.

Multi-tune files are supported at detection time but only the first tune is imported; the reference numbers and titles of the remaining tunes are listed in an informational warning. This is a deliberate choice: alphaTab's Score carries a single MasterBar timeline, so packing multiple independent tunes into one Score would either interleave their bars or leak metadata (title, tempo, key) between tunes.

Fragment input (a music body with no X: header) is accepted. A minimal header (X:1, L:1/8, K:C, empty T:) is synthesized and a warning identifies the fragment mode. This keeps embedded tutorial snippets and single-line examples usable without requiring callers to wrap them in boilerplate.

The feature table below follows the same conventions as the other format-support docs in this section: the Data Model column reflects whether alphaTab's model can represent the concept at all, Reading whether the ABC importer parses it, Rendering whether alphaTab draws it today, and Audio whether it affects playback.

Feature Tableโ€‹

How to read the table:

  • Rows are grouped by ABC concept area, roughly mirroring the sections of the ABC v2.1 spec.
  • Information-field rows use the ABC field letter (e.g. T: title, K: key).
  • Where a row is marked as Partial, hover the cell for a short note describing what was dropped or approximated. In all such cases a runtime warning is also emitted by the importer.
  • Rows marked as Ignored are parsed but produce no runtime effect โ€” this is intentional and covers bibliographic fields, rendering hints alphaTab does not use, and remarks.
  • In case of doubt, consult the ABC v2.1 spec and the alphaTab source to see how a specific construct is handled.

Number of total supported features: 84% (101/119)
Number of relevant supported features: 75% (80/106)

Table Legend

The following table describes the support of the different features of the input format.

Columns

  • Feature: The related feature. If marked with โญ its a new or changed feature compared to the previous version of this format (e.g. a feature added in Guitar Pro 6)
  • Data Model: Whether alphaTab supports storing this information in its own data model (e.g. from other formats).
  • Reading: Whether alphaTab can read this information from the file format.
  • Rendering: Whether alphaTab can display the information in the music sheet when rendered (display might differ from reference software).
  • Audio: Whether alphaTab can generate audio information for this feature.
  • alphaTex: Whether this feature is supported when describing music notation with alphaTex.

Values

  • โœ… Supported - The feature is fully supported by alphaTab.
  • โš ๏ธ Partial - The feature is partially supported by alphaTab, hover the item to see more details.
  • โŒ Not Supported - The feature is not supported by alphaTab.
  • โœ… Ignored - The feature is ignored from the input format because it is considered not relevant for display or playback. This is opinionated based on the feature set in alphaTab, open a feature request if you need it.
FeatureData ModelReadingRenderingAudioalphaTex
File Structure
%abc / %abc-2.1 file markerโœ… Supportedโœ… Supportedโœ… Ignoredโœ… IgnoredโŒ Not Supported
Fragment / body-only inputโœ… Supportedโœ… Supportedโœ… Supportedโœ… SupportedโŒ Not Supported
File header (fields before first X:)โœ… Supportedโœ… Supportedโœ… Supportedโœ… SupportedโŒ Not Supported
Multiple tunes per fileโš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… SupportedโŒ Not Supported
Free text between tunesโœ… Ignoredโœ… Ignoredโœ… Ignoredโœ… IgnoredโŒ Not Supported
% line commentโœ… Ignoredโœ… Supportedโœ… Ignoredโœ… IgnoredโŒ Not Supported
\\ music-line continuationโœ… Supportedโœ… Supportedโœ… Supportedโœ… SupportedโŒ Not Supported
+: field continuationโœ… Supportedโœ… Supportedโœ… Supportedโœ… SupportedโŒ Not Supported
! legacy line-break (pre-v2.0)โœ… Supportedโœ… Supportedโœ… Supportedโœ… IgnoredโŒ Not Supported
Text field mnemonic escapesโœ… Supportedโœ… Supportedโœ… Supportedโœ… IgnoredโŒ Not Supported
Information Fields (Header)
X: reference numberโœ… Supportedโœ… Supportedโœ… Ignoredโœ… IgnoredโŒ Not Supported
T: title (first / repeat)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Ignoredโœ… Supported
C: composerโœ… Supportedโœ… Supportedโœ… Supportedโœ… Ignoredโœ… Supported
O: originโœ… Supportedโœ… Ignoredโœ… Supportedโœ… IgnoredโŒ Not Supported
A: area (deprecated)โœ… Supportedโœ… Ignoredโœ… Supportedโœ… IgnoredโŒ Not Supported
R: rhythmโœ… Supportedโœ… Ignoredโœ… Supportedโœ… IgnoredโŒ Not Supported
M: meter numericโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
M:C common timeโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
M:C| cut timeโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
M:none free meterโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
M: additive (2+3)/8โš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… SupportedโŒ Not Supported
L: unit note lengthโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
L: omitted (derived from M:)โœ… Supportedโœ… Supportedโœ… Supportedโœ… SupportedโŒ Not Supported
Q: tempo (first, incl. non-quarter reference)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Q: mid-tune (line-start and inline [Q:...])โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
K: key + mode + explicit accidentalsโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
K: finishes-header state transitionโœ… Supportedโœ… Supportedโœ… Ignoredโœ… IgnoredโŒ Not Supported
K:HP / K:Hp Highland pipesโš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… SupportedโŒ Not Supported
K:noneโœ… Supportedโœ… Supportedโœ… Supportedโœ… SupportedโŒ Not Supported
K: clef parameters (combined with key)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
V: voice (header)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
V: voice (body) additive re-entryโœ… Supportedโœ… Supportedโœ… Supportedโœ… SupportedโŒ Not Supported
V: clef=treble/bass/percโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
V: clef=alto/tenorโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
V: clef=soprano/baritone/mezzoโš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… SupportedโŒ Not Supported
V: clef=treble+8 / bass-8 / etc.โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
V: name / snameโœ… Supportedโœ… Supportedโœ… Supportedโœ… Ignoredโœ… Supported
V: transposeโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
V: octaveโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
V: stem / gstemโœ… Ignoredโœ… Ignoredโœ… Ignoredโœ… IgnoredโŒ Not Supported
V: middle / stafflinesโŒ Not SupportedโŒ Not SupportedโŒ Not Supportedโœ… IgnoredโŒ Not Supported
P: parts play-orderโŒ Not SupportedโŒ Not SupportedโŒ Not SupportedโŒ Not SupportedโŒ Not Supported
P: body markersโœ… Supportedโœ… Supportedโœ… Supportedโœ… Ignoredโœ… Supported
w: inline lyricsโœ… Supportedโš ๏ธ Partialโœ… Supportedโœ… Ignoredโœ… Supported
Multi-verse w:โœ… Supportedโœ… Supportedโœ… Supportedโœ… Ignoredโœ… Supported
W: block lyricsโœ… Supportedโœ… Ignoredโœ… Supportedโœ… IgnoredโŒ Not Supported
s: symbol lineโŒ Not SupportedโŒ Not SupportedโŒ Not Supportedโœ… IgnoredโŒ Not Supported
N:, H:, B:, D:, F:, S:, Z:, G: bibliographicโœ… Supportedโœ… Ignoredโœ… Supportedโœ… IgnoredโŒ Not Supported
U: user-defined symbolsโš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… IgnoredโŒ Not Supported
m: macrosโŒ Not SupportedโŒ Not SupportedโŒ Not SupportedโŒ Not SupportedโŒ Not Supported
r: remark and [r:...] inlineโœ… Ignoredโœ… Ignoredโœ… Ignoredโœ… IgnoredโŒ Not Supported
[N:...] inline noteโœ… Supportedโœ… Ignoredโœ… Supportedโœ… IgnoredโŒ Not Supported
I:abc-charsetโœ… Supportedโœ… Supportedโœ… Ignoredโœ… IgnoredโŒ Not Supported
I:abc-versionโœ… Supportedโœ… Supportedโœ… Ignoredโœ… IgnoredโŒ Not Supported
I:abc-creatorโœ… Ignoredโœ… Ignoredโœ… Ignoredโœ… IgnoredโŒ Not Supported
I:linebreakโš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… IgnoredโŒ Not Supported
I:score / %%score staff groupingโœ… Supportedโœ… Supportedโœ… Supportedโœ… SupportedโŒ Not Supported
I:stavesโš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… SupportedโŒ Not Supported
I:decoration abcโœ… Supportedโœ… Supportedโœ… Supportedโœ… SupportedโŒ Not Supported
I:decoration extra / noneโš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… SupportedโŒ Not Supported
I:MIDI program / channel / transpose Nโœ… Supportedโœ… Supportedโœ… Supportedโœ… SupportedโŒ Not Supported
I:MIDI otherโŒ Not SupportedโŒ Not SupportedโŒ Not SupportedโŒ Not SupportedโŒ Not Supported
I:propagate-accidentals non-defaultโŒ Not SupportedโŒ Not Supportedโœ… Supportedโœ… SupportedโŒ Not Supported
I:abc-includeโŒ Not SupportedโŒ Not SupportedโŒ Not SupportedโŒ Not SupportedโŒ Not Supported
Stylesheet %% directives (non-score)โœ… Ignoredโœ… Ignoredโœ… Ignoredโœ… IgnoredโŒ Not Supported
Pitch, Duration, Rests
Note letters C-B / c-bโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Octave markers , and ' (stackable)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
octave= param on K: / V:โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Accidentals ^ _ = ^^ __โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Microtonal ^/, _/, =/โš ๏ธ Partialโš ๏ธ Partialโš ๏ธ Partialโš ๏ธ Partialโš ๏ธ Partial
Accidental propagation (pitch, default)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Duration A2, A3, A/2, A/, A//โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Dotted-via-multiplier A3, A7โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Duration not representable via Duration + dotsโš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… SupportedโŒ Not Supported
Rest z, zn, z/nโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Invisible rest x, xnโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Multi-measure rest Zn / Xnโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Spacer yโœ… Ignoredโœ… Supportedโœ… Ignoredโœ… IgnoredโŒ Not Supported
Broken rhythm > < >> << >>> <<<โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Broken rhythm edge cases (across bar / inside tuplet / unrepresentable)โŒ Not SupportedโŒ Not Supportedโœ… Supportedโœ… SupportedโŒ Not Supported
Grouping
Chord [CEG], [CEG]2โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Per-note duration in chord [C2EG]โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Chord accidentals [C^EG]โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Chord-to-chord tie [CEG]-[CEG]โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Tuplet (p shorthandโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Tuplet full (p:q:rโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Grace {ab}cโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Acciaccatura {/ab}cโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Grace-chord {[ab]c}dโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Tie -โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Tie across barโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Tie across voiceโš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… SupportedโŒ Not Supported
Tie on grace noteโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Slur (...)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Ignoredโœ… Supported
Nested slursโš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… IgnoredโŒ Not Supported
Bars and Repeats
| single barโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
|| double, [| thick-thin, |] thin-thickโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
.| dotted, [|] invisibleโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
|: :| :: repeatsโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
|:: ::| extended repeats (3x)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
[1 [2 volta endingsโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
|1 :|2 shorthand endingsโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Range / list endings [1,3 or [1-3โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
Decorations, Dynamics, Annotations
. staccatoโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
~ roll (Irish)โš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… SupportedโŒ Not Supported
T trill (shorthand)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
H fermataโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
L accent (emphasis)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
M mordentโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
P prallโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
S segnoโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
O open string, u/v bowingโŒ Not SupportedโŒ Not SupportedโŒ Not SupportedโŒ Not SupportedโŒ Not Supported
!name! dynamics (!pp!..!fff!, !sfz!, !crescendo(!, !diminuendo(!)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
!name! ornaments (!trill!, !mordent!, !turn!, !fermata!)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
!name! directions (segno / coda / D.C. / D.S. / tocoda / fine variants)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Supportedโœ… Supported
!name! unknownโŒ Not SupportedโŒ Not Supportedโœ… SupportedโŒ Not SupportedโŒ Not Supported
Placement prefix on named ^!pp! _!pp! < > @โš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… SupportedโŒ Not Supported
Chord symbol "Am" (default or ^ prefix)โœ… Supportedโœ… Supportedโœ… Supportedโœ… Ignoredโœ… Supported
Text annotation "^text" "_text" "<text" ">text" "@x,y text"โš ๏ธ Partialโš ๏ธ Partialโœ… Supportedโœ… Ignoredโš ๏ธ Partial