ChordPro

Last updated

The ChordPro (also known as Chord) format is a text-based markup language for representing chord charts by describing the position of chords in relation to the song's lyrics. ChordPro also provides markup to denote song sections (e.g., verse, chorus, bridge), song metadata (e.g., title, tempo, key), and generic annotations (i.e., notes to the musician).

Contents

Although a human-readable format, ChordPro files are intended to be input to software that prepares a formatted chord sheet for screen display or printing. Other features available in supporting software include generation of chord diagrams, ability to transpose to different keys, and conversion between different note naming systems, such as Nashville.

File extensions used for ChordPro files include .crd, .chopro, .pro, .chordpro or .cho.

The current version of the format is v6. [1]

Screenshot of a song typeset by ChordPro Wonderful time chord postscript output.png
Screenshot of a song typeset by ChordPro

Format Overview

In its simplest form, ChordPro is used to describe the relationship of chords to lyrics (i.e., where they belong in the song), song sections, and song metadata (i.e., information about the song). All ChordPro markup is optional; yet some elements are less optional than others if the objective is a useful and nicely formatted chord chart.

Chord Placement

Chord names are placed in square brackets immediately before the syllable of the lyric to which it is associated. For example,

[C]Twinkle, twinkle, [F]little [C]star, [G7]How I wonder what you [C]are! 

In the formatted output, the chord names will be placed on top of the lyric line, as presented below:

 C                 F      C     G7                    C  Twinkle, twinkle, little star, How I wonder what you are! 

Song Sections

Song sections, also called environments in the ChordPro specification, are denoted by a matching pair of markup directives (start_of_sectionName, end_of_sectionName) around the lines comprising the section. A section may consist of lyrics for part of a song, such as a chorus or verse or, depending on the processing tool, be something else, such as ASCII guitar TAB notation.

The name of three section types are reserved in the specification: chorus, tab, and grid (i.e., start_of_chorus, start_of_tab, start_of_grid). [2]

A section may have any name that consists of letters, digits, or underscore. The section directive may contain an optional label value that identifies the section.  For example,

{start_of_verse Verse 1}

An example of a marked section is:

 {start_of_verse}  [C]Twinkle, twinkle, [F]little [C]star, [G7]How I wonder what you [C]are!  [G7]Up above the world so high, [G7]Like a diamond in the sky.  [C]Twinkle, twinkle, [F]little [C]star, [G7]How I wonder what you [C]are!  {end_of_verse} 

Song Metadata

Song metadata consists of information about the song and is denoted by specifying a name and value after the meta keyword all inside curly braces.

{meta: namevalue}

The use of a single lowercase word, like artist and composer, is suggested for a name, yet there is no constraint on what is considered valid.

For convenience and backward compatibility with earlier ChordPro versions, the following metadata names are considered standard. These can be defined using the meta directive or entered as standalone directives: title, sorttitle, subtitle, artist, composer, lyricist, arranger, copyright, album, year, key, time, tempo, duration and capo. [3] Multiple values can be set by using multiple metadata directives. In the example below, which is based on, [4] that the short form is used for all but the copyright meta values. Note also that multiple values are provided for copyright to distinguish the copyright status of the music and words separately.

{title:What Child Is This?}{subtitle:Traditional Christmas Song}{key:Em}{time:6/8}{lyricist:William Chatterton Dix,1837-1898}{composer:GREENSLEEVES,a 17th Century English Air}{meta: copyright Words:Public Domain}{meta: copyright Music:Public Domain}

Example

An example of a portion of a song in ChordPro format is presented below. Note the chorus section is labeled as a Refrain. Note that chords may appear in the middle or a word when the chord changes at one of its syllables (e.g., [G]char-i-[D]ot). Finally, note a comment was used as a note to repeat the refrain after the first verse.

 # A Portion of a song in ChordPro format  # A '#' character in the 1st column is a comment    {title: Swing Low Sweet Chariot}  {subtitle: African American Spiritual}  {key: D}  {year: unknown}  {composer: Wallace Willis}   {meta: copyright Public Domain}     {start_of_chorus: Refrain}  Swing [D]low, sweet [G]chari[D]ot,  Comin’ for to carry me [A7]home.  Swing [D7]low, sweet [G]chari[D]ot,  Comin’ for to [A7]carry me [D]home.  {end_of_chorus}     {start_of_verse}  I [D]looked over Jordan, and [G]what did I [D]see,  Comin’ for to carry me [A7]home.  A [D]band of angels [G]comin’ after [D]me,  Comin’ for to [A7]carry me [D]home.  {end_of_verse}     {comment: Refrain} 

History

In June 1991 Martin Leclerc and Mario Dorion conceived of a simple, text-based syntax for marking up chords and lyrics and developed the Chord program. Although the program and file format saw some adoption there was no active development of either for several years. In 2007 Johan Vromans and Adam Monsen revived the project under a new name, Chordii, and updated the ChordPro format to version 4. In 2015 Johan Vromans started a major modernization effort to implement features such as Unicode support and native PDF generation and renamed the program to ChordPro. [5] This release is still in active development and supports ChordPro format version 6. [1]

Related Research Articles

<span class="mw-page-title-main">Refrain</span> Repeated lines in music or poetry

A refrain is the line or lines that are repeated in music or in poetry — the "chorus" of a song. Poetic fixed forms that feature refrains include the villanelle, the virelay, and the sestina.

In jazz, comping is the chords, rhythms, and countermelodies that keyboard players, guitar players, or drummers use to support a musician's improvised solo or melody lines. It is also the action of accompanying, and the left-hand part of a solo pianist.

<span class="mw-page-title-main">Thirty-two-bar form</span> Song structure

The 32-bar form, also known as the AABA song form, American popular song form and the ballad form, is a song structure commonly found in Tin Pan Alley songs and other American popular music, especially in the first half of the 20th century.

Song structure is the arrangement of a song, and is a part of the songwriting process. It is typically sectional, which uses repeating forms in songs. Common forms include bar form, 32-bar form, verse–chorus form, ternary form, strophic form, and the 12-bar blues. Popular music songs traditionally use the same music for each verse or stanza of lyrics. Pop and traditional forms can be used even with songs that have structural differences in melodies. The most common format in modern popular music is introduction (intro), verse, pre-chorus, chorus, verse, pre-chorus, chorus, bridge, and chorus. In rock music styles, notably heavy metal music, there is usually one or more guitar solos in the song, often found after the middle chorus part. In pop music, there may be a guitar solo, or a solo performed with another instrument such as a synthesizer or a saxophone.

In music, especially Western popular music, a bridge is a contrasting section that prepares for the return of the original material section. In a piece in which the original material or melody is referred to as the "A" section, the bridge may be the third eight-bar phrase in a 32-bar form, or may be used more loosely in verse-chorus form, or, in a compound AABA form, used as a contrast to a full AABA section.

<span class="mw-page-title-main">The Cat Came Back</span> Comic song written by Harry S. Miller

"The Cat Came Back" is a comic song written by Harry S. Miller in Christmas 1893. It has since entered the folk tradition and been recorded under variations of the title—"But the Cat Came Back", "And the Cat Came Back", etc. It is also a popular children's song.

<span class="mw-page-title-main">Attribute (computing)</span> Metadata which defines a property

In computing, an attribute is a specification that defines a property of an object, element, or file. It may also refer to or set the specific value for a given instance of such. For clarity, attributes should more correctly be considered metadata. An attribute is frequently and generally a property of a property. However, in actual usage, the term attribute can and is often treated as equivalent to a property depending on the technology being discussed. An attribute of an object usually consists of a name and a value. For an element these can be a type and class name, while for a file these can be a name and an extension, respectively.

"All the Things You Are" is a song composed by Jerome Kern with lyrics written by Oscar Hammerstein II.

"Jane Says" is a song by American rock band Jane's Addiction. It was released as a promotional single in 1988, becoming the band's first chart entry on the Alternative Songs chart, peaking at #6.

<span class="mw-page-title-main">Comment (computer programming)</span> Explanatory note in the source code of a computer program

In computer programming, a comment is a programmer-readable explanation or annotation in the source code of a computer program. They are added with the purpose of making the source code easier for humans to understand, and are generally ignored by compilers and interpreters. The syntax of comments in various programming languages varies considerably.

The Nashville Number System is a method of transcribing music by denoting the scale degree on which a chord is built. It was developed by Neal Matthews Jr in the late 1950s as a simplified system for the Jordanaires to use in the studio and further developed by Charlie McCoy. It resembles the Roman numeral and figured bass systems traditionally used to transcribe a chord progression since the 1700s. The Nashville Number System was compiled and published in a book by Chas. Williams in 1988.

The Nashville Number System is a trick that musicians use to figure out chord progressions on the fly. It is an easy tool to use if you understand how music works. It has been around for about four hundred years, but sometime during the past fifty years [approximately 1953–2003], Nashville got the credit.

The Nashville numbering system provided us the shorthand that we needed so that we could depend on our ears rather than a written arrangement. It took far less time to jot the chords, and once you had the chart written, it applied to any key. The beauty of the system is that we don't have to read. We don't get locked into an arrangement that we may feel is not as good as one we can improvise.

In music, harmonization is the chordal accompaniment to a line or melody: "Using chords and melodies together, making harmony by stacking scale tones as triads".

<span class="mw-page-title-main">Tablature</span> Form of musical notation

Tablature is a form of musical notation indicating instrument fingering or the location of the played notes rather than musical pitches.

"Comin' Thro' the Rye" is a poem written in 1782 by Robert Burns (1759–1796). The words are put to the melody of the Scottish Minstrel "Common' Frae The Town". This is a variant of the tune to which "Auld Lang Syne" is usually sung—the melodic shape is almost identical, the difference lying in the tempo and rhythm.

<span class="mw-page-title-main">Glossary of jazz and popular music</span> List of definitions of terms and jargon used in jazz and popular music

This is a glossary of jazz and popular music terms that are likely to be encountered in printed popular music songbooks, fake books and vocal scores, big band scores, jazz, and rock concert reviews, and album liner notes. This glossary includes terms for musical instruments, playing or singing techniques, amplifiers, effects units, sound reinforcement equipment, and recording gear and techniques which are widely used in jazz and popular music. Most of the terms are in English, but in some cases, terms from other languages are encountered.

"Irma Jackson" is a song by Bakersfield, California-based outlaw country artist Merle Haggard, released on his 1972 album Let Me Tell You About a Song. The song, which was about the then-controversial topic of an interracial romance, was actually written several years prior to 1972, but not released at first because Capitol Records thought it would hurt Haggard's image at the time. Fellow country singer Tony Booth recorded a cover version of "Irma Jackson" in 1970, which was released as his first single for MGM Records. Booth's version of the song charted at #67 on the Hot Country Songs chart.

<span class="mw-page-title-main">Passing chord</span> Chord that connects the notes of two diatonic chords

In music, a passing chord is a chord that connects, or passes between, the notes of two diatonic chords. "Any chord that moves between one diatonic chord and another one nearby may be loosely termed a passing chord. A diatonic passing chord may be inserted into a pre-existing progression that moves by a major or minor third in order to create more movement." "'Inbetween chords' that help you get from one chord to another are called passing chords."

"Bullet" is a song by American rap rock band Hollywood Undead. It was recorded as the sixth single and eleventh track from their second studio album American Tragedy (2011). The song was produced by Griffin Boice. This song is one of the few songs by Hollywood Undead to feature a member other than Danny or Deuce as the clean vocalist. Charlie Scene performs the chorus of "Bullet," in addition to "Rain" from Notes from the Underground. The song has received positive reviews from critics due to its cheerful tone and uptempo beat that directly contrast its dark lyrics about suicide and self-harm.

<span class="mw-page-title-main">Solitude Is Bliss</span> 2010 single by Tame Impala

"Solitude Is Bliss" is a song by Tame Impala, released as a single in April 2010. It was recorded during the sessions for the Innerspeaker album in 2009, and released as the first single from that album. The single features artwork from Australian artist Leif Podhajsky, who also created the artwork for Innerspeaker and the follow-up Lonerism. "Solitude Is Bliss" came in at number 33 in the Triple J Hottest 100 in 2010.

"Reencuentro" (transl. "Reunion"), also known as "Patria Querida", is a song performed by Salvadoran singer-songwriter Álvaro Torres featuring Puerto Rican-Colombian band Barrio Boyzz. It was produced by Álvaro Torres and Víctor Torres, recorded in 1994 in Entourage Studios, North Hollywood, CA, and released on Torres' album Reencuentro in 1995. The song samples the traditional Central America melody of the "Torito Pinto dance". "Reencuentro" is a patriotic song, manifesting the impediment for distance and the yearning to return to the country where the subject belongs.

References

  1. 1 2 "ChordPro Release info". www.chordpro.org. Retrieved 2020-11-04.
  2. "Environment directives". www.chordpro.org. Retrieved 2023-11-07.
  3. "Directives: meta". www.chordpro.org. Retrieved 2023-11-01.
  4. "Christmas-Songs/What Child Is This.cho at master · pathawks/Christmas-Songs". GitHub. Retrieved 2023-11-11.
  5. Team, The ChordPro (2023-10-30), ChordPro , retrieved 2023-10-30