Music.Abc

A Haskell representation and parser for ABC notation. Based on the 2.1 standard.

For more information see http://abcnotation.com.

Abc format

Files

data AbcFile

A full ABC file (2.2).

Constructors

AbcFile (Maybe String) (Maybe FileHeader) [Element]

File header

data FileHeader

File header (2.2.2).

Constructors

FileHeader [Information] [Directive]

Instances

Eq FileHeader

Ord FileHeader

Show FileHeader

data Element

Either a tune, free text or typeset text (2.2.3).

Constructors

Tune AbcTune

An Abc tune.

FreeText String

Free text (2.2.3).

TypesetText String

Typeset text (2.2.3).

Instances

Eq Element

Ord Element

Show Element

Tunes

data AbcTune

Constructors

AbcTune TuneHeader TuneBody

Instances

Eq AbcTune

Ord AbcTune

Show AbcTune

data TuneHeader

Constructors

TuneHeader [Information]

Instances

Eq TuneHeader

Ord TuneHeader

Show TuneHeader

type TuneBody = [Music]

Music

data Music

Constructors

Music [Note :|: (MultiRest :|: (Barline :|: ()))]

Instances

Eq Music

Ord Music

Show Music

Note stack

type Note = DecorationT (SlurT (BeamT (GraceT (TupletT (DurationT (RestT Pitch))))))

type DecorationT a = ([Decoration], a)

type SlurT a = (Bool, a, Bool)

type BeamT a = (Bool, a, Bool)

type GraceT a = (Bool, a)

type TupletT a = (Duration, a)

type DurationT a = (a, Duration)

type RestT a = Maybe (Maybe a)

type :|: a b = Either a b

Basic types

Time

newtype Duration

Constructors

Duration

Fields

getDuration :: Rational

Instances

Enum Duration

Eq Duration

Fractional Duration

Num Duration

Ord Duration

Real Duration

RealFrac Duration

Show Duration

Pitch

data PitchClass

Constructors

C

D

E

F

G

A

B

Instances

Bounded PitchClass

Enum PitchClass

Eq PitchClass

Ord PitchClass

Show PitchClass

data Accidental

Constructors

DoubleFlat

Flat

Natural

Sharp

DoubleSharp

Instances

Bounded Accidental

Enum Accidental

Eq Accidental

Ord Accidental

Show Accidental

newtype Octave

Constructors

Octave

Fields

getOctave :: Int

Instances

Enum Octave

Eq Octave

Integral Octave

Num Octave

Ord Octave

Real Octave

Show Octave

newtype Pitch

Constructors

Pitch

Fields

getPitch :: (PitchClass, Accidental, Octave)

Instances

Eq Pitch

Ord Pitch

Show Pitch

Decorations (articulation, dynamics etc)

data Decoration

Constructors

Trill

TrillBegin

TrillEnd

Lowermordent

Uppermordent

Roll

Turn

Turnx

Invertedturn

Invertedturnx

Arpeggio

Accent

Fermata Bool

Tenuto

Fingering Int

Plus

Snap

Slide

Wedge

Upbow

Downbow

Open

Thumb

Breath

Crescendo

EndCrescendo

Diminuendo

EndDiminuendo

Segno

Coda

DaSegno

DaCapo

Dacoda

Fine

Shortphrase

Mediumphrase

Longphrase

Instances

Eq Decoration

Ord Decoration

Show Decoration

Structure

data Barline

Barline, including special barlines and repeats.

Constructors

Barline

DoubleBarline Bool Bool

Repeat Int Bool Bool

DottedBarline Barline

InvisibleBarline Barline

Instances

Eq Barline

Ord Barline

Show Barline

newtype MultiRest

Constructors

MultiRest

Fields

getMultiRest :: Int

Instances

Eq MultiRest

Ord MultiRest

Show MultiRest

Information etc

data Information

Constructors

Area String

Book String

Composer String

Discography String

FileUrl String URI

Group String

History String

Instruction Directive

Key Key

UnitNoteLength Duration

Meter Meter

Notes String

Origin String

Parts

Tempo Tempo

Rhythm String

Source String

SymbolLine Symbol

TuneTitle String

Voice VoiceProps

Words String

ReferenceNumber Integer

Transcription String

Instances

Eq Information

Ord Information

Show Information

type Directive = (String, String)

Abc directive.

Import and export

readAbc :: String -> AbcFile

showAbc :: AbcFile -> String