Skip to main content
Zurück zur Startseite
Alle Anleitungen

ChordPro-Format

Die vollständige Referenz zum ChordPro-Format, wie SONGUIDE es unterstützt, von Akkorden und Metadaten bis zu Abschnitten, Kommentaren und Transponieren.

ChordPro ist ein Klartextformat für Songblätter. Es existiert seit Jahrzehnten, funktioniert in unzähligen Apps und ist selbst als reiner Text gut lesbar. SONGUIDE speichert jeden Song als ChordPro und unterstützt den Grossteil der offiziellen ChordPro-Spezifikation.

Du musst diese Seite nicht komplett lesen, um SONGUIDE zu nutzen. Der Text-Editor schreibt ChordPro für dich. Diese Referenz ist für alle, die den Quelltext direkt bearbeiten, Dateien von anderswo importieren oder genau verstehen wollen, was eine Direktive tut.

Akkorde

Akkorde stehen in eckigen Klammern, direkt vor der Silbe, zu der sie gehören:

ChordPro

A[G]mazing [G7]grace, how [C]sweet the [G]sound

Gerendert

 AGmazing G7grace, how Csweet the Gsound

Auf dem Songblatt wird jeder Akkord über genau dieser Silbe dargestellt. SONGUIDE akzeptiert alle gängigen Schreibweisen:

StilBeispiele
Einfach[G], [Am], [F#], [Bb]
Slash-Akkord[G/B], [A/C#]
Sus- und Add-Akkorde[Gsus], [Dsus4], [Cadd9], [C2]
Erweitert[Am7], [Cmaj9], [E7#9]
Erweiterung in Klammern[D(4)]
Vermindert und übermässig[Bdim7], [E#°], [Caug]
Kein Akkord[N.C.]
Ghost- oder optionaler Akkord[(G)]
Kommentar[*Coda], [*Rit.]
Taktstrichsenkrechte Striche als Taktlinien

Unbekannte Akkordformen werden nie abgelehnt. Was zwischen den Klammern steht, bleibt erhalten und wird dargestellt. Kommentare mit * am Anfang sehen auf dem Songblatt aus wie Akkorde, werden aber nie transponiert.

Erweiterungen werden hochgestellt dargestellt, wie in professionellen Songblättern: Grundton und Qualität bleiben auf der Grundlinie, die Erweiterung ist erhöht, zum Beispiel die 7 in Am7.

Cues im Songtext

Eingeklammerte Performance-Hinweise im Songtext werden erkannt und kursiv auf die Akkordzeile gehoben:

MusterBeispiele
Zu einem Abschnitt(To Chorus), (To Vs. / Tag)
Wiederholung(REPEAT), (x2), (x3)
Nummerierter Schluss(1.), (2.)

Anderer eingeklammerter Text, wie (oh yeah), bleibt als normaler Text im Songtext.

Metadaten-Direktiven

Direktiven sind Anweisungen in geschweiften Klammern, eine pro Zeile. Diese tragen die Metadaten des Songs:

DirektiveKurzformBedeutung
{title: ...}{t: ...}Songtitel
{artist: ...}{a: ...}Künstler, mehrere durch Kommas getrennt
{key: ...}{k: ...}Aktuelle Tonart, zum Beispiel Bb oder F#m
{tempo: ...}Tempo in BPM
{time: ...}Taktart, zum Beispiel 4/4
{original_key: ...}Die veröffentlichte Tonart, eine SONGUIDE-Ergänzung
{subtitle: ...}{st: ...}Untertitel oder Aufnahme-Infos
{copyright: ...}Copyright-Inhaber und Jahr
{ccli: ...}CCLI-Songnummer
{footer: ...}{f: ...}Fusszeilentext

Titel, Künstler, Tonart, Tempo, Taktart und Original-Tonart erscheinen auch im Tab Song Info und in deinen Bibliothekslisten. Lange und kurze Direktivennamen sind austauschbar, und weitere Metadaten-Direktiven wie {composer}, {album} oder {year} bleiben unangetastet in der Datei.

ChordPro

{title: Amazing Grace}
{artist: John Newton}
{key: G}
{tempo: 63}
{time: 3/4}

Gerendert

Amazing Grace

John Newton

G3/463bpm

Abschnitte

SONGUIDE erkennt zwei Arten, Abschnitte zu markieren. Beide werden gleich dargestellt.

Empfohlen: Comment-Überschriften

Eine {comment: ...}-Direktive (kurz {c: ...}) beginnt einen neuen Abschnitt mit dieser Beschriftung. Diesen Stil verwenden SongSelect und viele Community-Dateien, und er ist der empfohlene Stil, weil eine einzige Direktive jede Überschrift abdeckt, die du je brauchen wirst:

ChordPro

{comment: Verse 1}
A[G]mazing [G7]grace, how [C]sweet the [G]sound

{comment: Chorus}
My [G]chains are [D]gone, I've been set [G]free

{comment: Guitar Solo 2x}
[G] [C] [G] [D]

Gerendert

 AGmazing G7grace, how Csweet the Gsound
Verse 1
 My Gchains are Dgone, I've been set Gfree
Chorus
G C G D
Guitar Solo 2x

Jede Beschriftung funktioniert. Beginnt sie mit einem bekannten Abschnittsnamen, bekommt der Abschnitt diesen Typ und seine Farbe. Alles andere wird in einer neutralen grauen Box dargestellt, die Beschriftung bleibt dabei sichtbar.

Environment-Direktiven

Der offizielle paarweise Stil wird ebenfalls vollständig unterstützt:

ChordPro

{start_of_verse: Verse 1}
A[G]mazing [G7]grace, how [C]sweet the [G]sound
{end_of_verse}

Gerendert

 AGmazing G7grace, how Csweet the Gsound
Verse 1

Unterstützte Paare sind {start_of_verse}, {start_of_chorus}, {start_of_bridge} und {start_of_tab}, mit den Kurzformen {sov}, {soc}, {sob} und {sot} sowie den passenden End-Direktiven. Für Intro, Outro, Pre-Chorus und andere Abschnittstypen gibt es kein Paar, darum sind Comment-Überschriften die flexiblere Wahl.

Abschnittsfarben

Auf dem Songblatt ist jeder Abschnitt eine umrandete Box mit seiner Beschriftung in einem Chip. Vier Abschnittstypen haben eine eigene Farbe, alle anderen teilen sich ein neutrales Grau:

AbschnittFarbe
VerseTürkis
ChorusRot
Pre-ChorusGold
BridgeViolett
Intro, Outro, Tag, Solo, Interlude, Instrumental und alle anderenGrau

Abschnittsnamen auf Deutsch und in anderen Sprachen

Du kannst Abschnitte auch auf Deutsch beschriften. Beschriftungen in mehreren Sprachen werden dem richtigen Typ und der richtigen Farbe zugeordnet, während der Chip den Originaltext behält. Strophe 2 wird zum Beispiel als Verse dargestellt und Refrain als Chorus. Erkannte Namen sind unter anderem Vers, Strophe, Couplet, Verso (Verse), Coro, Refrain, Estribillo, Ritornello (Chorus), Pre-Coro (Pre-Chorus), Puente, Pont, Ponte (Bridge), Vorspiel (Intro), Nachspiel (Outro) und Zwischenspiel (Interlude).

Englische Beschriftungen sind trotzdem die sicherere Wahl, denn andere Apps erkennen Abschnittsnamen in anderen Sprachen möglicherweise nicht.

Abschnittswechsel und Abschnittsverweise

Ein leeres {comment:} schliesst den aktuellen Abschnitt und beginnt einen neuen ohne Beschriftung, ein rein visueller Umbruch.

Ein beschrifteter Abschnitt ohne Inhalt ist ein Abschnittsverweis: ein kompakter Trenner, der den Performern sagt, diesen Abschnitt noch einmal zu spielen. So musst du wiederholte Refrains nicht mehrfach ausschreiben:

ChordPro

{comment: Bridge}
[Em]My chains are gone...

{comment: Chorus}
{comment: Chorus 2x}

Gerendert

EmMy chains are gone...
Bridge
Chorus
Chorus 2x

Beide Chorus-Zeilen oben werden als schmale beschriftete Trenner dargestellt statt als volle Boxen.

Performance-Notizen

{comment_box: ...} (kurz {cb: ...}) ist eine Notiz an die Performer. Sie erscheint im aktuellen Abschnitt goldig und klar vom Songtext getrennt:

ChordPro

{comment: Intro}
{comment_box: Keys pad only, drums enter on verse 2}
[G] [C] [G] [D]

Gerendert

Keys pad only, drums enter on verse 2

G C G D
Intro

Genau das schreibt SONGUIDE, wenn du im Text-Editor eine Kommentarbox-Zeile hinzufügst. Da es eine Standard-ChordPro-Direktive ist, überleben deine Notizen auch das Öffnen der Datei in anderen Apps.

Capo

Der Capo ist persönlich und gehört nicht zum Song. SONGUIDE speichert den Capo-Bund darum pro Benutzer und pro Song, ausserhalb der ChordPro-Datei.

Setze den Capo über das Capo-Rad in der Songansicht. Mit aktiviertem Show Capo werden die Akkorde für deine Griffbilder transponiert angezeigt, während das geschriebene Songblatt unverändert bleibt.

Show Capo gilt für alle Songs auf einmal und blendet die Capo-Ansicht nur ein oder aus. Deine Capo-Einstellungen pro Song bleiben dabei immer erhalten. Spielst du Gitarre, lässt du Show Capo an und siehst überall deine Griffbilder. Wechselst du an den Bass, schaltest du Show Capo aus und liest überall die geschriebenen Akkorde, ohne dass ein einziger Capo-Bund verloren geht.

Eine {capo: ...}-Direktive in einer importierten Datei bleibt im Quelltext erhalten, hat aber keine Wirkung. Setze den Capo stattdessen in der App.

Gitarrentabulatur

Zwischen {start_of_tab} und {end_of_tab} wird nichts als Akkorde interpretiert, und die Zeilen bleiben in deiner Datei unangetastet. Die Darstellung von Tabs wird noch nicht vollständig unterstützt.

Kommentarzeilen und Copyright-Fusszeilen

Zeilen, die mit # beginnen, sind Quelltext-Kommentare gemäss ChordPro-Spezifikation. Sie bleiben in der Datei, werden aber nie dargestellt.

Copyright- und CCLI-Fusszeilen in reinem Text, wie SongSelect sie exportiert, werden erkannt und auf dem Songblatt ausgeblendet: eine Zeile mit einer CCLI-Songnummer, eine ©-Jahreszeile oder SongSelect-Nutzungsbedingungen markieren den Beginn der Fusszeile, und alles ab dort wird nicht dargestellt. Der Text bleibt in deiner Datei, es geht also nichts verloren.

Transponieren und Tonarten

Transponieren über das Transponier-Rad schreibt die Akkorde im Song selbst um und aktualisiert {key: ...}. Die Schreibweise stimmt dabei: B-Tonarten bekommen Bs, Kreuz-Tonarten Kreuze, und Moll-Tonarten werden über ihre parallele Durtonart geschrieben. Tab-Blöcke, Kommentare mit *, [N.C.] und Taktstriche bleiben unangetastet.

{original_key: ...} wird beim Transponieren nie verändert. Die Direktive merkt sich die veröffentlichte Tonart des Songs, egal in welcher Tonart du ihn spielst, und sie wird im Song-Header angezeigt.

Unterstützte und nicht unterstützte Direktiven

Alle bisher beschriebenen Direktiven werden unterstützt. Die folgenden Direktiven werden nicht unterstützt. SONGUIDE löscht sie aber nie. Sie bleiben im Quelltext erhalten und haben einfach keine sichtbare Wirkung:

KategorieNicht unterstützte Direktiven
Schriften, Grössen, Farben{textfont}, {chordsize}, alle Styling-Direktiven
Seitenlayout{new_page}, {column_break}, {columns}, {pagetype}
Bilder{image}
Akkorddiagramme{define}, {chord}, {diagrams}
Transposition{transpose}, nutze stattdessen das Transponieren in der App
Grids und delegierte Inhalte{start_of_grid}, {start_of_abc}, {start_of_ly}, {start_of_svg}, {start_of_textblock}
Bedingte DirektivenInstrument-Selektoren wie {comment-guitar: ...}

Weil unbekannte Direktiven erhalten bleiben, überstehen Dateien aus anderen ChordPro-Apps den Weg durch SONGUIDE unbeschadet.

Importverhalten in Kürze

  • Lange und kurze Direktivennamen werden beide akzeptiert, und Leerzeichen werden entfernt.
  • Erscheint eine Metadaten-Direktive doppelt, zählt für den extrahierten Wert die letzte, aber alle Vorkommen bleiben in der Datei.
  • Leerzeilen innerhalb eines Abschnitts bleiben erhalten und erzeugen sichtbaren Abstand auf dem dargestellten Songblatt. Leerzeilen direkt vor einer Abschnittsüberschrift oder ganz am Anfang der Datei werden entfernt, damit der Abstand zwischen Abschnitten einheitlich bleibt.
  • Zeilen, die mit einer oder mehreren Direktiven beginnen und dann Songtext enthalten, werden aufgeteilt und beide Teile verarbeitet. Das repariert Dateien, in denen eine Direktive mit der ersten Textzeile zusammengezogen ist.

Für Dateitypen, Grössenlimits und den Import und Export selbst siehe Import und Export.