ChordPro specifikace
Obsah písně se ukládá v ChordPro formátu doslova tak, jak ho napíšeš. Aplikace z něj metadata vyčte, ale text nepřepisuje ani nečistí.
Základní syntaxe
| Prvek | Zápis | Poznámka |
|---|---|---|
| Akord | [G], [Am7], [C/E] | Umístěný přímo v místě, kde má znít |
| Direktiva | {key: G} | Musí být sama na řádku a mít hodnotu |
| Komentář / sekce | {c: Refrén} | Vykreslí se jako nadpis sekce |
text
[G]Ahoj [D]světe, tohle je [Em]píseň
ℹ
Direktiva se rozpozná jen tehdy, když stojí sama na vlastním řádku a má hodnotu za dvojtečkou. Direktiva uprostřed textu se bere jako obyčejný text.
Direktivy metadat
Tyhle direktivy aplikace čte při importu a vyplní z nich pole písně:
| Direktiva | Zkratka | Vyplní pole |
|---|---|---|
{title: …} | {t: …} | Název |
{artist: …} | {a: …} | Interpret |
{subtitle: …} | {st: …} | Varianta (ne interpret) |
{key: …} | {k: …} | Tónina |
{tempo: …} | {bpm: …} | BPM — přečtou se jen číslice |
{time: …} | {meter: …} | Taktové označení |
{duration: …} | — | Délka, ve formátu mm:ss nebo v sekundách |
{capo: …} | — | Capo — přečtou se jen číslice |
{tags: …} | — | Tagy oddělené čárkou |
⚠
Pozor na
{subtitle} — v Eutepiu neplní podtitulek ani interpreta, ale variantu písně. Varianta je součást identity písně, takže „Hallelujah / akustická" a „Hallelujah / koncertní" jsou dvě samostatné písně.Direktivy, které aplikace nezná, se nezahazují — zůstávají v uloženém obsahu písně. Při vykreslení na pódiu se ale neukážou.
Sekce písně
V živém režimu se ze sekčních direktiv vykreslují nadpisy:
| Zápis | Nadpis |
|---|---|
{soc}, {chorus} | REFRÉN |
{sov} | SLOKA |
{sob} | BRIDGE |
Pružnější je
{c: …} / {comment: …}, kde se hodnota přeloží podle tabulky (nezáleží na velikosti písmen):| Hodnota | Nadpis |
|---|---|
verse, sloka | SLOKA |
chorus, refrén, refren, refrain | REFRÉN |
bridge | BRIDGE |
intro | INTRO |
outro, dohra | DOHRA |
solo | SOLO |
break, interlude, mezihra | MEZIHRA |
| cokoli jiného | Text velkými písmeny |
Díky poslední řádce si můžeš pojmenovat sekci jakkoli:
{c: druhý refrén} vykreslí DRUHÝ REFRÉN.Metadatové direktivy (
{title}, {artist}, {key}, {tempo}, {time}, {duration}, {tags}, {subtitle}) se z těla písně při vykreslení tiše vynechají — jsou už zobrazené v hlavičce.Transpozice
| Vlastnost | Hodnota |
|---|---|
| Rozsah | −24 až +24 půltónů (dvě oktávy oběma směry) |
| Volba křížků a béček | Automaticky podle vstupu, nebo ručně vynuceně |
| Slash akordy | Základ i bas se transponují nezávisle |
| Neznámý akord | Projde beze změny |
Křížky nebo béčka
Ve výchozím stavu platí: co přijde s béčkem, odejde s béčkem. Rozhodnutí umí aplikace odvodit i z cílové tóniny podle kvintového kruhu — transpozice do tóniny s béčky vyprodukuje béčka. V nastavení se dá volba vynutit natvrdo jedním nebo druhým směrem.
Enharmonika
Aplikace zvládá i zápisy, které leží mimo běžnou dvanáctku:
B#, E#, Fb a Cb se převedou správně.Český a německý zápis
V Nastavení → Transpozice → Pojmenování not přepneš mezi:
| Režim | Význam |
|---|---|
| Anglický | B = H, Bb = B |
| Český / německý | H = H, samotné B = B (tedy Bb) |
Volba platí pro transpozici i pro zobrazení akordů na pódiu.
Slash akordy
Bas za lomítkem se transponuje samostatně a nezáleží na velikosti písmen —
C/e se zpracuje jako C/E.Hmaty
Akordy v textu nejsou jen popisky — klepnutím se otevře hmat pro kytaru, ukulele, baskytaru nebo klavír. Viz Živý režim.
Capo
{capo: 2} se uloží do písně a při exportu se zase zapíše zpátky.⚠
Hodnota capo se ukládá k písni, ale sama o sobě nepřepisuje text akordů — ten zůstane zapsaný tak, jak jsi ho zadal. Pro posun znějících akordů použij transpozici.
Příklad
text
{title: Ukázková píseň}
{artist: Kapela}
{subtitle: akustická}
{key: G}
{tempo: 120}
{time: 4/4}
{capo: 2}
{duration: 3:45}
{tags: rock, koncert}
{c: Intro}
[G] [D] [Em] [C]
{c: Sloka}
[G]Ráno jsem [D]vstal a šel jsem [Em]ven,
[C]slunce mi [G]svítilo do [D]očí.
{soc}
[C]Tohle je [G]refrén,
[D]zpívej ho se [Em]mnou.
{c: Mezihra}
[Am] [F] [C] [G]