ChordPro to format tekstowy dla piosenek z akordami osadzonymi bezpośrednio w tekście. Jeden plik działa w dowolnym edytorze, importuje się czysto do aplikacji do śpiewników i eksportuje do gotowych do sceny plików PDF — bez walki z wyrównaniem w edytorze tekstu.
Główna idea
Akordy umieszczone są w nawiasach kwadratowych przed sylabą, do której należą. Dyrektywy w nawiasach klamrowych dodają metadane, etykiety sekcji, komentarze, siatki taktów i układ wydruku. Songbook Buddy czyta to samo źródło dla podglądu na żywo, trybu teatralnego i eksportu PDF.
[G]Hello darkness, my old [C]friend
Podstawowe dyrektywy
To są dyrektywy, do których muzycy sięgają najczęściej w Songbook Buddy. Krótkie aliasy (jak {t:} dla {title:}) również działają — zobacz pełny spis referencji podany poniżej.
Składnia
Co to robi
{title: …} / {t:}
Song title — shown in the preview header and PDF title block.
{artist: …} / {a:}
Artist or band name in the header.
{key: …} / {k:}
Musical key — appears as a meta chip; transposes with the song.
{capo: N}
Capo fret — pairs with the capo slider; shapes reflect capo position.
{tempo: N} · {time: 4/4}
BPM and time signature — meta chips for rehearsal and print.
{comment: …} / {c:}
Performance note or instruction block (normal weight).
{comment_italic: …} / {ci:}
Italic comment — cues like “slow build” or “repeat 2×”.
{start_of_verse} … {end_of_verse}
Verse section — optional label; short forms {sov} / {eov}.
{start_of_chorus: Label} … {end_of_chorus}
Chorus section — custom label after the colon; {soc} / {eoc}.
[Chord]
Inline chord placed on the next word or syllable — core ChordPro syntax.
[(Chord)]
Optional chord — visible cue, transposes like a normal chord.
{start_of_grid} … {end_of_grid}
Bar grid for rhythm charts — | Am | G | . | cells per measure.
{np} · {cb}
Page break and column break — take effect in PDF export, not on-screen scroll.
{chord: Am}
Inline chord diagram drawn in the lyric flow at that spot.
ChordPro przykłady źródłowe
Te przykłady pokazują tylko przenośne źródło ChordPro. Rzeczywisty ekran Songbook Buddy i wyjście PDF różnią się w zależności od układu aplikacji, czcionki, strony i ustawień eksportu.
Przykład 1 — Zwrotka i refren z metadanymi
Typowy wykres piosenkarza-autora: tytuł i tonacja w nagłówku, komentarz dotyczący wykonania, następnie sekcje zwrotek i refrenu z wbudowanymi [akordami].
ChordPro źródło
{title: Morning Light}
{artist: Jane Doe}
{key: G}
{capo: 2}
{comment: Fingerpicking — capo shapes shown below.}
{start_of_verse}
[G]Walking by the [C]riverside at [G]dawn
[Em]Coffee in my [Am]hand, the [D]night is [G]gone
{end_of_verse}
{start_of_chorus: Chorus}
[C]Morning [G]light on [Em]open [Am]water
[C]Carry [G]me through [D]one more [G]day
{end_of_chorus}
Przykład 2 — Wykres zespołowy z siatką i podziałem strony
Wykres prób dla całego zespołu: tempo i metrum, siatka akordów do intro, tekst refrenu, a następnie {np} jako przenośna dyrektywa podziału strony.
ChordPro źródło
{title: Band Chart — 4/4 Groove}
{key: Am}
{tempo: 92}
{time: 4/4}
{comment_italic: Intro — drums build 4 bars}
{start_of_grid}
| Am | G | F | E |
| Am | . | . | . |
{end_of_grid}
{chorus}
[Am]Hold the [G]line, don't [F]let it [E]fade
[Am]We play it [G]live — no [F]masquer[E]ade
{np}
{start_of_block: Outro vamp}
[Am] [G] [F] [E]
{end_of_block}
Dlaczego muzycy używają ChordPro
Zwykły tekst — edytuj wszędzie, przyjazny dla kontroli wersji, bez zamknięcia w systemie
Akordy ustawiają się automatycznie nad odpowiednimi sylabami
Sekcje, komentarze i siatki pasków strukturyzują złożone układy
Jeden plik importuje do Songbook Buddy, OnSong i innych aplikacji
Transponuj, zakładka i drukuj/PDF z tego samego źródła
Edytuj ChordPro po lewej; sformatowane akordy i teksty pojawiają się po prawej w miarę pisania.
Używanie ChordPro z Songbook Buddy
Importuj istniejące pliki lub foldery .cho / .chopro, edytuj z podglądem na żywo w podzielonym oknie, transponuj do swojego głosu i eksportuj PDF-y na występ. Wbudowany katalog wstawiania dodaje sekcje i dyrektywy bez konieczności zapamiętywania składni.
