Directive

enum Directive: String, CaseIterable

The directives Chord Provider supports

Show on GitHub

Official directives

  • t

    Meta-data directives

    This directive defines the title of the song

    Declaration

    Swift

    case t
    Show on GitHub

  • Declaration

    Swift

    case t, title
    Show on GitHub
  • st

    This directive defines a subtitle of the song

    Note

    It will be used as artist

    Declaration

    Swift

    case st
    Show on GitHub

  • Declaration

    Swift

    case st, subtitle
    Show on GitHub

  • This directive defines an artist

    Declaration

    Swift

    case artist
    Show on GitHub

  • This directive defines an album this song occurs on

    Declaration

    Swift

    case album
    Show on GitHub

  • The year this song was first published, as a four-digit number

    Declaration

    Swift

    case year
    Show on GitHub
  • key

    This directive specifies the key the song is written in

    Declaration

    Swift

    case key
    Show on GitHub

  • This directive specifies a time signature

    Declaration

    Swift

    case time
    Show on GitHub

  • This directive specifies the tempo in number of beats per minute for the song

    Declaration

    Swift

    case tempo
    Show on GitHub

  • This directive specifies the capo setting for the song

    Declaration

    Swift

    case capo
    Show on GitHub

  • This directive specifies the instrument setting for the song

    Declaration

    Swift

    case instrument
    Show on GitHub
  • c

    Formatting directives

    This directive introduce a comment line

    Declaration

    Swift

    case c
    Show on GitHub

  • Declaration

    Swift

    case c, comment
    Show on GitHub

  • Environment directives

    Chorus

    This directive indicates that the lines that follow form the song’s chorus

    Declaration

    Swift

    case startOfChorus = "start_of_chorus"
    Show on GitHub
  • soc

    This directive indicates that the lines that follow form the song’s chorus

    Declaration

    Swift

    case soc
    Show on GitHub

  • This directive indicates the end of the chorus

    Declaration

    Swift

    case endOfChorus = "end_of_chorus"
    Show on GitHub
  • eoc

    This directive indicates the end of the chorus

    Declaration

    Swift

    case eoc
    Show on GitHub

  • This directive indicates that the song chorus must be played here

    Declaration

    Swift

    case chorus
    Show on GitHub

  • Verse

    Specifies that the following lines form a verse of the song

    Declaration

    Swift

    case startOfVerse = "start_of_verse"
    Show on GitHub
  • sov

    Specifies that the following lines form a verse of the song

    Declaration

    Swift

    case sov
    Show on GitHub

  • Specifies the end of the verse

    Declaration

    Swift

    case endOfVerse = "end_of_verse"
    Show on GitHub
  • eov

    Specifies the end of the verse

    Declaration

    Swift

    case eov
    Show on GitHub

  • Bridge

    Specifies that the following lines form a bridge of the song

    Declaration

    Swift

    case startOfBridge = "start_of_bridge"
    Show on GitHub
  • sob

    Specifies that the following lines form a bridge of the song

    Declaration

    Swift

    case sob
    Show on GitHub

  • Specifies the end of the bridge

    Declaration

    Swift

    case endOfBridge = "end_of_bridge"
    Show on GitHub
  • eob

    Specifies the end of the bridge

    Declaration

    Swift

    case eob
    Show on GitHub

  • Tab

    This directive indicates that the lines that follow form a section of guitar TAB instructions

    Declaration

    Swift

    case startOfTab = "start_of_tab"
    Show on GitHub
  • sot

    This directive indicates that the lines that follow form a section of guitar TAB instructions

    Declaration

    Swift

    case sot
    Show on GitHub

  • This directive indicates the end of the tab

    Declaration

    Swift

    case endOfTab = "end_of_tab"
    Show on GitHub
  • eot

    This directive indicates the end of the tab

    Declaration

    Swift

    case eot
    Show on GitHub

  • Grid

    This directive indicates that the lines that follow define a chord grid in the style of Jazz Grilles

    Declaration

    Swift

    case startOfGrid = "start_of_grid"
    Show on GitHub
  • sog

    This directive indicates that the lines that follow define a chord grid in the style of Jazz Grilles

    Declaration

    Swift

    case sog
    Show on GitHub

  • This directive indicates the end of the grid

    Declaration

    Swift

    case endOfGrid = "end_of_grid"
    Show on GitHub
  • eog

    This directive indicates the end of the grid

    Declaration

    Swift

    case eog
    Show on GitHub

  • Textblock

    This directive indicates that the lines that follow define a piece of text that is combined into a single object that can be placed as an image

    Declaration

    Swift

    case startOfTextblock = "start_of_textblock"
    Show on GitHub

  • This directive indicates the end of the textblock

    Declaration

    Swift

    case endOfTextblock = "end_of_textblock"
    Show on GitHub

  • Chord diagrams

    This directive defines a chord in terms of fret/string positions and, optionally, finger settings

    Declaration

    Swift

    case define
    Show on GitHub

Custom directives

  • This directive has the path to the music file

    Declaration

    Swift

    case musicPath = "musicpath"
    Show on GitHub
  • tag

    This directive defines a tag for the song

    Declaration

    Swift

    case tag
    Show on GitHub

  • Not a directive

    Declaration

    Swift

    case none
    Show on GitHub

  • Strum

    This directive indicates that the lines that follow defines a strum pattern

    Declaration

    Swift

    case startOfStrum = "start_of_strum"
    Show on GitHub
  • sos

    This directive indicates that the lines that follow defines a strum pattern

    Declaration

    Swift

    case sos
    Show on GitHub

  • This directive indicates the end of the strum

    Declaration

    Swift

    case endOfStrum = "end_of_strum"
    Show on GitHub
  • eos

    This directive indicates the end of the strum

    Declaration

    Swift

    case eos
    Show on GitHub

Details of a directive

Directive extensions

  • The start and end of the directive

    Declaration

    Swift

    var format: (start: String, end: String)
    Show on GitHub

  • The raw label of the directive

    Declaration

    Swift

    func label(_ directive: ChordPro.Directive) -> String

    Parameters

    directive

    The ChordPro/Directive

    Return Value

    The raw value as String

    Show on GitHub

  • The kind of directive (block, inline or optional label)

    Declaration

    Swift

    var kind: Kind
    Show on GitHub

  • The kind of directive (block or inline)

    See more

    Declaration

    Swift

    enum Kind
    Show on GitHub

Grouped directives