Suporte ao ChordPro

ChordPro é um padrão baseado em texto simples que pode ser editado em qualquer editor de texto, em qualquer plataforma. As letras são escritas como texto normal, os acordes ficam na mesma linha da letra, entre colchetes ([ e ]), e os metadados são especificados usando “tags” entre chaves ({ e }).

Como um exemplo simples, um arquivo de música pode se parecer com isto:

{title: Amazing Grace}
{artist: John Newton}
{key: D}

{start_of_verse: Verse 1}
A[D]mazing grace! (how [G]sweet the [D]sound)
That [D]saved a wretch like [A7]me!
I [D]once was lost, but [G]now am [D]found,
Was [D]blind, but [A7]now I [D]see.

Quando exibido, o arquivo acima pode aparecer assim:

Amazing Grace renderizada a partir de ChordPro com os acordes posicionados acima da letra

O formato é usado por muitos apps de letras e acordes. Infelizmente, embora os elementos centrais do formato geralmente sejam tratados do mesmo jeito em vários apps, pode haver diferenças bem grandes na forma como algumas tags são interpretadas e usadas — especialmente em programas mais antigos. E claro: cada app pode ter suas próprias tags personalizadas, que nenhum dos outros apps entende.

O SongSheet Pro faz o máximo para dar suporte ao padrão ChordPro atualmente publicado, conforme documentado em https://www.chordpro.org/chordpro/index.html.

Você pode exportar suas músicas para este formato e importá-las também.

O SongSheet Pro importa várias tags não padronizadas para ler arquivos de apps que não seguem o padrão ChordPro. Elas estão listadas na referência de importação abaixo, e as tags que ele não reconhece são ignoradas. Se um arquivo ChordPro não for importado como você espera, envie uma solicitação de suporte com um arquivo de exemplo.

O SongSheet Pro também oferece suporte à exportação para um conjunto reduzido de tags do ChordPro que a maioria dos outros programas deve conseguir suportar. Isso é documentado na especificação ChordPro v4.6.

Importando ChordPro

A tabela abaixo lista as tags que o SongSheet Pro lê ao importar um arquivo ChordPro.

O SongSheet Pro reconhece os nomes das tags exatamente como estão escritos. Letras maiúsculas e minúsculas não importam, mas a grafia importa: uma tag com erro de grafia, como {meta: note …} (em vez de {meta: notes …}) ou {start-of-verse} (em vez de {start_of_verse}), é ignorada sem nenhuma mensagem, e a linha dela não aparece na música. Se faltar uma parte do arquivo depois de importá-lo, confira a grafia das tags. Coloque cada tag em uma linha própria. Uma tag sem a chave de fechamento } é tratada como texto da letra, então aparece na música.

Valor importado Tag preferida Também aceitas Notas
Título title t Se não houver nenhuma, o nome do arquivo é usado.
Artista artist author, subtitle, st, su subtitle, st e su só são lidas se não houver uma tag artist ou author.
Compositor composer
Letrista lyricist
Arranjador arranger
Copyright copyright
Ano year
Tom key k
Capotraste capo ca
Andamento tempo bpm, metronome Batidas por minuto, como um número inteiro.
Fórmula de compasso time
Duração duration Controla a velocidade da rolagem automática da música. Segundos (210) ou minutos e segundos (3:30).
Tags genre Uma única tag genre é dividida por vírgulas e ponto e vírgula em várias tags.
Número CCLI da música ccli
Notas da música notes keywords Tags notes repetidas viram linhas separadas. keywords só é usada se o arquivo não tiver uma tag notes, e, se houver várias, a última é usada.
Paleta de acordes chords Adiciona acordes à paleta de acordes da música. Os acordes são separados por espaços, e _ é usado para espaços dentro dos acordes.
Comentário comment c, comment_italic, ci, comment_box, cb Um comentário na primeira linha de uma seção sem nome vira o nome da seção.
Verso start_of_verse e end_of_verse start_of_part e end_of_part, sop e eop, name Cria uma estrofe com o nome informado. start_of_verse sem nome usa “Verso” por padrão, no idioma do app. As outras tags deixam a seção sem nome.
Refrão start_of_chorus e end_of_chorus soc e eoc O nome padrão é “Refrão”, no idioma do app.
Tablatura start_of_tab e end_of_tab sot e eot Cria uma tablatura. Um comentário logo antes dela, sem mais nada na seção, vira o nome e tem prioridade sobre o texto depois da tag. Caso contrário, o nome é o texto depois da tag, se houver. Uma tablatura não tem nome padrão.
Lembrete de refrão chorus Adiciona uma seção sem nome com uma linha que diz “Refrão”, no idioma do app.

Como as tags são lidas

  • Qualquer tag da tabela também pode ser escrita como {meta: name value}, então {meta: key G} e {key: G} fazem a mesma coisa. Outros apps podem aceitar essa forma apenas para informações da música, como o título ou o tom.
  • Algumas dessas tags não fazem parte do padrão ChordPro, por exemplo ca, name, genre, ccli, start_of_part e sop. O SongSheet Pro as aceita para que arquivos de outros apps, e as próprias exportações dele, sejam importados por completo.
  • Se um arquivo tiver várias tags artist, composer, lyricist ou arranger, todas são importadas e separadas por ;. Para title e capo, a última tag é usada. Para key e duration, a primeira tag é usada. Para time e tempo, a primeira tag válida é usada.

Seções

  • A tag de fechamento de uma seção de verso, refrão ou tablatura é opcional, porque uma linha em branco também encerra a seção.
  • start_of_part e sop tratam os textos em minúsculas chords_like, repeat e guitar_only de forma especial: o texto antes do primeiro deles é o nome da seção, e essa palavra e tudo o que vem depois dela viram um comentário no início da seção. Todas as outras tags de seção usam o texto inteiro como nome.
  • O SongSheet Pro não tem um tipo de seção de refrão separado. Um refrão é uma seção do tipo verso cujo nome padrão é “Refrão” (no idioma do app), então {start_of_chorus} e {start_of_verse: Chorus} são importadas como o mesmo tipo de seção.

Arquivos de setlist

Uma setlist exportada para ChordPro não pode ser importada de volta como setlist: ela entra como uma única música que reúne, uma vez cada, todas as músicas da setlist e recebe o nome da última música. O resumo no início do arquivo vira letra, as tags {new_song} entre as músicas são ignoradas e os sets não são restaurados. Para levar uma setlist entre usuários do SongSheet Pro, use o formato SongSheet.

Tags não suportadas

O SongSheet Pro não suporta todos os recursos do ChordPro, especialmente as diretivas de formatação. O SongSheet Pro tem seu próprio sistema de diagramação e temas, então não oferece suporte às tags para definir fontes, cores, quebras de página, quebras de coluna ou imagens.

Além disso, como o SongSheet Pro (ainda) não oferece suporte a diagramas de acordes, ele não oferece suporte às grades de acordes (chord grids) nem às tags que definem diagramas/dedilhados.

Por fim, todas as variações de diretivas de “comentário” são tratadas como um único tipo de comentário.

O SongSheet Pro não tem um campo de álbum, então uma tag {album: …} é ignorada. Linhas que começam com # são comentários do ChordPro e são ignoradas. Qualquer outra tag que não esteja na tabela acima também é ignorada sem nenhuma mensagem, e a linha dela não aparece na música.

Exportando ChordPro a partir do SongSheet Pro

O SongSheet Pro pode gerar conteúdo no formato ChordPro para uso em outros apps. Cada tag que ele grava ao exportar uma música pode ser lida de novo ao importá-la, mas apenas as tags listadas abaixo são gravadas, então a exportação para ChordPro tem perdas. Não a use para enviar músicas a outros usuários do SongSheet Pro nem para fazer backup ou arquivar suas músicas: use o formato SongSheet. Uma setlist exportada para ChordPro também não pode ser importada de volta como setlist (veja Arquivos de setlist).

Exportar música para ChordPro

  1. Na visualização da música, abra o menu de compartilhamento e selecione Exportar Como.
  2. Escolha o formato: ChordPro v4.6 (apps antigos podem não reconhecer os formatos mais novos de tags) ou ChordPro v5.0.
  3. Envie a música via AirDrop, escolha um app para abrir o arquivo ChordPro, copie para a área de transferência ou salve em Arquivos.

O ChordPro não é oferecido para uma música importada de um arquivo PDF, RTF ou Word.

Exportação ChordPro v5.0

Esta é a versão mais completa do formato que o SongSheet Pro exporta. Uma tag só é gravada quando a música tem esse valor.

Conteúdo da música Tag gravada
Título {title: Amazing Grace}
Artista {artist: John Newton}
Compositor {composer: Mozart}
Letrista {lyricist: Charles Wesley}
Arranjador {arranger: Jane Smith}
Copyright {copyright: © 2020 Example Music}
Ano {year: 1999}
Tom {key: C}
Capotraste {meta: capo 3}
Andamento {tempo: 135}
Fórmula de compasso {time: 4/4}
Duração {duration: 210}
Tags {meta: genre Blues, Slow}
Número CCLI da música {meta: ccli 123456}
Notas da música {meta: notes Play softly}, uma tag por linha de notas
Comentário {c: Play softly}
Verso {start_of_verse: Verse 1} e {end_of_verse}
Refrão {start_of_chorus: Chorus} e {end_of_chorus}
Tablatura {start_of_tab: Riff} e {end_of_tab}

Um nome só é gravado quando a seção tem um. Uma seção cujo nome começa com “Chorus”, como “Chorus 2”, é gravada como refrão, e o nome é mantido. Os nomes de refrão são reconhecidos apenas em inglês, sem diferenciar maiúsculas de minúsculas, então uma seção chamada “Refrão” é gravada como um verso chamado “Refrão”.

Os arquivos ChordPro v5.0 são salvos em UTF-8.

Exportação ChordPro v4.6

Esta é a versão de compatibilidade, com menos tags para que apps mais antigos consigam lê-la. O SongSheet Pro grava apenas as tags da tabela abaixo. Outras tags, como o tom e o capotraste, não são gravadas.

Conteúdo da música Tag gravada
Título {title: Amazing Grace}
Artista, ou o compositor se não houver artista {subtitle: John Newton}
Comentário {c: Play softly}
Verso Uma linha com o nome, por exemplo {c: Verse 1}
Refrão {start_of_chorus} e {end_of_chorus}, sem nome
Tablatura {start_of_tab} e {end_of_tab}, com o nome, se houver, gravado em uma linha {c: …} antes delas

Uma seção só é exportada como refrão quando se chama exatamente “Chorus”, sem diferenciar maiúsculas de minúsculas. Qualquer outra seção de verso com nome, inclusive uma cujo nome seja “chorus” traduzido para outro idioma, é gravada como verso, com o nome em uma linha {c: …}.

Os arquivos ChordPro v4.6 são salvos no conjunto de caracteres ISO Latin-2. Caracteres que ele não consegue representar, como ã, õ, aspas curvas e escritas não latinas, são substituídos por ?. Use o ChordPro v5.0 para músicas com esses caracteres.

Exportação de setlist

Exportar setlist para ChordPro

  1. Na visualização da setlist, abra o menu de compartilhamento e selecione Exportar Como.
  2. Escolha exportar a setlist no formato ChordPro.
  3. Envie a setlist via AirDrop, escolha um app para abrir o arquivo ChordPro, copie para a área de transferência ou salve em Arquivos.

O arquivo começa com um resumo, seguido das músicas:

  • Duas linhas de comentário: o nome da setlist e uma linha informando que o arquivo foi criado com o SongSheet, com o endereço do site. O texto da segunda segue o idioma do app.
  • Uma tag {title: …} com o nome da setlist.
  • Uma lista por set, com uma linha {c: …} com o nome do set (omitida quando a setlist tem um único set com o nome padrão) e depois uma linha Título (Artista) para cada música.
  • Cada música uma vez, mesmo que apareça em vários sets, no formato ChordPro v5.0 e começando com uma tag {new_song}.

O SongSheet Pro não consegue importar esse formato de volta como setlist (veja Arquivos de setlist).

Atualizado em: 9 de novembro de 2026