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 aparecem inline com a 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:
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 todas as suas músicas para este formato, e importar qualquer música que esteja neste formato também.
Além disso, como muitos apps mais antigos ainda não suportam a versão mais nova do padrão, o SongSheet Pro fará o melhor para interpretar quaisquer tags não padronizadas usadas por esses programas. Se você encontrar um arquivo ChordPro que o SongSheet Pro não consiga analisar corretamente, me avise!
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.
Começo rápido do ChordPro
Consulte a Especificação completa do formato ChordPro. Aqui está um resumo breve das principais tags que você normalmente vai usar:
Nome/título da música
{title: Song Title}
Alternativas aceitas ao importar:
{t: Song Title}
Subtítulo (artista)
Isso preenche o campo de metadados de artista no SongSheet Pro.
{subtitle: Artist Name}
Alternativas aceitas ao importar:
{st: Artist Name}
{su: Artist Name}
{artist: Artist Name}
{author: Artist Name}
Compositor
{composer: Composer Name}
Letrista
{lyricist: Lyricist Name}
Arranjador
{arranger: Arranger Name}
Informações de copyright
{copyright: 1999 Some Organization, Inc.}
Ano
{year: 1999}
Tom
{key: C}
Alternativas:
{k: C}
Capotraste
{capo: 3}
Alternativas:
{ca: 3}
{meta: capo 3}
Andamento
O andamento é medido como número de batidas por minuto e deve ser um valor numérico (inteiro):
{tempo: 123}
Alternativas:
{bpm: 123}
{metronome: 123}
Fórmula de compasso
{time: 4/4}
Duração
A duração é usada no SongSheet Pro para controlar a velocidade da rolagem automática. O tempo é especificado em um dos dois formatos: como mm:ss para minutos e segundos (por exemplo, 4:00) ou como um número (por exemplo, 240, representando 240 segundos, ou 4 minutos).
{duration: 3:30}
Alternativas:
{duration: 210}
Gênero
Observação: esta é uma tag não padronizada do ChordPro suportada pelo SongSheet Pro. Ao exportar, ele usará a forma alternativa abaixo para se manter em conformidade com a especificação do ChordPro.
{genre: Blues}
Alternativas:
{meta: genre Blues}
Número CCLI da música
Observação: esta é uma tag não padronizada do ChordPro suportada pelo SongSheet Pro. Ao exportar, ele usará a forma alternativa abaixo para se manter em conformidade com a especificação do ChordPro.
{ccli: 123456}
Alternativas:
{meta: ccli 123456}
Acordes da música
Usado no cabeçalho do arquivo da música (antes da primeira estrofe) para listar todos os acordes usados na música. Se você estiver criando seu próprio arquivo manualmente, isso é totalmente opcional, pois o SongSheet Pro faz essa análise por você e exibe os acordes na paleta de acordes (acessório do teclado).
{chords: C, D, E}
Nome da estrofe
Usado antes da primeira linha de uma estrofe, para dar um nome (por exemplo: Refrão, Verso 1, Ponte, etc.).
{start_of_verse: Verse 1}
Alternativas:
{name: Verse 1}
Observe que alguns apps usam c / comment para nomes de estrofes; outros usam para anotações da música. Se o SongSheet Pro encontrar uma tag de comentário como a primeira linha de uma estrofe que, de outra forma, não tem nome, ele assumirá que ela representa o nome da estrofe:
{c: Verse 1}
{comment: Verse 1}
Refrão
Para marcar o início de um refrão:
{start_of_chorus}
Alternativas:
{soc}
{chorus}
Para marcar o fim de um refrão (opcional; o SongSheet Pro encerra uma estrofe quando há uma linha em branco entre linhas de letra):
{end_of_chorus}
Alternativas:
{eoc}
Tablatura
Para marcar o início de uma seção de tablatura:
{start_of_tab}
Alternativas:
{sot}
Para marcar o fim de uma seção de tablatura (opcional; o SongSheet Pro reconhece o fim da tablatura quando há uma linha em branco):
{end_of_tab}
Alternativas:
{eot}
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.
Exportando ChordPro a partir do SongSheet Pro
O SongSheet Pro pode gerar conteúdo no formato ChordPro para uso em outros apps.
Exportar música para ChordPro
- Na visualização da música, abra a menu de compartilhamento e selecione Exportar como.
- Escolha o formato: ChordPro v4.6 (apps antigos podem não reconhecer os formatos mais novos de tags) ou ChordPro v5.0.
- 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.
Exportar setlist para ChordPro
- Na visualização da setlist, abra o menu de compartilhamento e selecione Exportar como.
- Escolha exportar a setlist no formato ChordPro. (Isso exporta em ChordPro v5.0)
- 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.