Arquivos de texto simples
Uma música em texto simples costuma ser um arquivo .txt em que os acordes ficam em uma linha própria acima da letra. A maioria das cifras da internet é escrita nesse formato, e o texto que você arrasta de uma página da web para o SongSheet Pro é lido da mesma forma. Se um arquivo marca os acordes dentro da letra com colchetes, como A[D]mazing, ele é um arquivo ChordPro, que pode guardar mais detalhes do que o texto simples.
O SongSheet Pro lê um arquivo de texto simples uma linha de cada vez e monta a música a partir do resultado. Esta página explica como ele identifica cada tipo de linha, para que você possa escrever ou ajeitar um arquivo que seja importado do jeito que você quer. Para importar um arquivo, veja Adicionando músicas. Depois, revise a importação para conferir se o arquivo foi lido corretamente.
Um exemplo simples
Para escrever uma música em texto simples, basta uma estrutura básica. Este arquivo tem um título, um artista e uma estrofe:
Amazing Grace
John Newton
Verse 1:
D G D
Amazing grace! (how sweet the sound)
As duas primeiras linhas são o título e o artista. Verse 1: dá nome à estrofe, a linha seguinte contém os acordes e a linha abaixo dela contém a letra. Cada acorde é colocado acima do trecho da letra em que ele deve ser tocado.
O resto desta página trata dos detalhes extras que você pode acrescentar e das regras exatas que o SongSheet Pro usa para reconhecer cada tipo de linha.
Como o SongSheet Pro lê um arquivo
O SongSheet Pro olha para cada linha e atribui a ela um tipo: título, artista, tom, capotraste, andamento, fórmula de compasso, copyright, nome de estrofe, linha de letra, acordes ou linha em branco.
A maioria dos detalhes da música é reconhecida por um rótulo em inglês, como Key ou Capo. O rótulo não diferencia maiúsculas de minúsculas. Um rótulo em outro idioma, por exemplo Capotraste, é lido como letra, não como capotraste.
Um arquivo de texto simples costuma ter o título e o artista no início, seguidos de outros detalhes da música, como o tom. Depois vem o conteúdo da música, dividido em estrofes que contêm acordes e linhas de letra. A linha de copyright costuma ficar no fim do arquivo.
Detalhes da música
Coloque cada detalhe da música em uma linha própria. Eles podem aparecer em qualquer lugar do arquivo, mas normalmente você coloca o título e o artista primeiro, seguidos de outros detalhes da música, como o tom ou a fórmula de compasso. Se o mesmo detalhe aparecer mais de uma vez, vale somente o último.
Alguns detalhes da música são reconhecidos sem rótulo, como 4/4 ou © 2023 Some Music. As seções abaixo mostram as formas que o SongSheet Pro reconhece. Cada forma deve ocupar a linha inteira: palavras extras depois de um tom, capotraste, andamento ou fórmula de compasso fazem a linha virar letra. O SongSheet Pro só lê os detalhes da música descritos aqui: se quiser importar compositor, letrista, arranjador, número CCLI, ano, duração, tags ou notas, use um arquivo ChordPro.
Título e artista
Identifique o título e o artista usando os rótulos Title e Artist. Estas são as formas aceitas:
- Título:
Title: Amazing GraceouTitle Amazing Grace - Artista:
Artist: John Newton,Artist John NewtonouBy: John Newton(By:precisa dos dois-pontos)
Essa é a forma mais confiável. Se você não der rótulos, o SongSheet Pro os deduz a partir das duas primeiras linhas de texto, ignorando as linhas em branco. Uma dedução errada pode ser corrigida ao revisar a importação.
Estes são os formatos comuns e o que o SongSheet Pro faz com cada um:
| O arquivo começa com | Título | Artista |
|---|---|---|
Amazing GraceJohn Newtonlinha em branco |
Amazing Grace | John Newton |
Amazing GraceBy John Newton |
Amazing Grace | John Newton |
Amazing GraceKey: D |
Amazing Grace | Nenhum |
Amazing Gracelinha em branco John NewtonVerse 1: |
Amazing Grace | John Newton |
Quando a primeira linha é identificada como letra, aplicam-se as seguintes regras para deduzir o título e o artista:
- Se a segunda linha for
Byseguido de uma a três palavras que começam com letra maiúscula, comoBy John Newton, a primeira linha vira o título e o nome vira o artista. Uma linha comoBy your side, ou uma em que a primeira palavra depois deByseja uma palavra comum em inglês, como My ou All, não conta como uma linhaBy, mas as regras abaixo ainda podem transformá-la no artista. - Se a segunda linha não for letra, por exemplo um tom, capotraste, andamento ou fórmula de compasso, um nome de estrofe ou acordes, a primeira linha vira o título.
- Se as duas primeiras linhas forem letra, estiverem uma logo após a outra e forem seguidas por uma linha em branco ou qualquer outra linha que não seja letra, elas viram o título e o artista.
- Se uma linha em branco separar as duas primeiras linhas, a primeira linha vira o título quando a segunda for seguida por mais letra, e as duas viram o título e o artista quando a segunda for seguida por uma linha que não seja letra nem esteja em branco. Quando a segunda linha for seguida por outra linha em branco, nenhum dos dois é deduzido.
Quando a primeira linha é uma linha Title, a segunda linha vira o artista se for letra e for uma linha By como a descrita acima ou for seguida por uma linha em branco ou qualquer outra linha que não seja letra. Quando a primeira linha é qualquer outra coisa, como acordes ou um nome de estrofe, nada é deduzido. Se nenhum título for encontrado, o nome do arquivo é usado.
Tom
Escreva Key e depois a nota, separados por um espaço, dois-pontos, um sinal de igual, of ou of:. A nota vai de A a G, opcionalmente seguida de #, ♯, b ou ♭ e, depois, opcionalmente de m, min, minor, maj ou major, com ou sem espaço antes.
Key: G · key a · Key of Am · Key of: B♭ maj · Key = Bb minor · Key=G · Key C major · Key: F♯m
Não são reconhecidos: Am (sem rótulo) e Key: Am7 (extensões).
Capotraste
Escreva Capo, dois-pontos opcionais e depois um número de -1 a 11.
Capo 2 · Capo: 2 · Capo:2 · Capo -1
Não são reconhecidos: Capo2 e Capo=2.
Andamento
Escreva um número inteiro com bpm depois dele, ou coloque Tempo ou bpm antes dele, com dois-pontos ou sinal de igual opcional. Também é possível usar os dois, como em Tempo 120 bpm.
120 bpm · 120BPM · Tempo 120 · Tempo: 120 · Tempo=120 · Tempo 120 bpm · bpm 120 · BPM: 120 · bpm=120
Não são reconhecidos: um número sozinho, um número decimal e Tempo120.
Fórmula de compasso
Escreva dois números inteiros separados por uma barra, e nada mais na linha.
4/4 · 6/8 · 5/16 · 7/4
Não são reconhecidos: Time: 3/4 e 3 / 4. Uma linha de letra que seja somente 1/2 também é lida como fórmula de compasso. Se isso acontecer, mude-a para Letra ao revisar a importação.
Copyright
Comece a linha com Copyright e um espaço ou dois-pontos, com © ou com (c) e um espaço. A linha inteira é mantida, incluindo a palavra Copyright.
Copyright 2023 Some Music · Copyright: 2023 Some Music · © 2023 Some Music · ©2023 Some Music · (c) 2023 Some Music (o (c) é importado como ©)
Não são reconhecidos: (c)2023 e Copyright sozinho.
Conteúdo da música
Uma música contém estrofes, que contêm linhas reconhecidas como letra ou acordes.
Nomes de estrofes
Um nome de estrofe é uma linha própria que inicia uma nova estrofe. O SongSheet Pro o mostra com inicial maiúscula e sem os dois-pontos, os colchetes ou os parênteses, então VERSE 1: vira Verse 1. Um nome é reconhecido em qualquer uma destas formas:
| Forma | Exemplos | Resultado |
|---|---|---|
Qualquer nome de uma ou duas palavras, seguido de dois-pontos ou de um colchete de fechamento (]). Este é o caso geral |
Solo:Tag 2:[Interlude] |
Solo Tag 2 Interlude |
verse, chorus, refrain, bridge, intro ou outro, com um número opcional. Dois-pontos e colchetes não são necessários, mas dois-pontos, colchetes e parênteses são aceitos |
Verse 1ChorusVerse 2:(Bridge) |
Verse 1 Chorus Verse 2 Bridge |
As abreviações desses nomes: v, ch, ref, br, in ou out, com um número opcional e as mesmas opções de dois-pontos, colchetes ou parênteses |
V1Ch 2[Ref]Out: |
Verse 1 Chorus 2 Refrain Outro |
Um nome que não se encaixa nessas formas é lido como letra. Isso inclui um nome sem dois-pontos (Solo), com três ou mais palavras, com hífen ou outra pontuação (Pre-Chorus:, Verse 1 (repeat):) e com texto extra depois do nome (Chorus x2). Parênteses só funcionam com as palavras das duas últimas linhas: (Solo) é lido como letra. Como as formas abreviadas são reconhecidas, uma linha de letra que seja somente In, Out ou V também é lida como nome de estrofe, em qualquer lugar em que apareça, e inicia uma nova estrofe. Se isso acontecer, mude a linha para Letra ao revisar a importação.
Uma estrofe não precisa de nome. Uma linha em branco encerra a estrofe, e a próxima linha de letra inicia uma nova estrofe sem nome, a menos que um nome de estrofe venha primeiro.
Acordes
Os acordes ficam em uma linha própria, e não dentro da letra. Em geral ficam logo acima da linha de letra a que pertencem, mas uma linha de acordes também pode ficar sozinha, como um trecho instrumental sem letra.
O SongSheet Pro é exigente quanto ao que conta como linha de acordes. Se uma linha não for detectada como acordes, confira se:
- Todos os itens da linha são acordes ou símbolos de acordes.
D,Gmin,Asus4,F#m7eC/Gsão acordes.%,N.C.e os separadores|,-e/também são permitidos, então| G | C |eG - Csão linhas de acordes. Uma palavra que não seja acorde, comox2ou uma anotação sua, faz a linha inteira virar letra. Coloque anotações assim em uma linha própria. - Os nomes das notas são letras maiúsculas. Use as letras de A a G, em maiúsculas, para indicar as notas dos acordes.
Depois que uma linha é lida como acordes:
- O espaçamento define a posição. Cada acorde é colocado sobre o caractere da letra que está na mesma coluna, então use espaços para alinhar cada acorde com a letra. Tabulações são convertidas em espaços antes.
- Uma linha de acordes sem letra embaixo continua sendo uma linha de acordes. É assim que uma linha instrumental é mantida. Isso acontece quando a linha seguinte é uma linha em branco, um nome de estrofe, outra linha de acordes ou uma linha de detalhe da música, ou quando os acordes estão no fim do arquivo.
O contrário também pode acontecer: uma linha de letra que contém somente A, Am, Em ou A D é lida como acordes, porque o SongSheet Pro não consegue notar a diferença. Ao revisar a importação, mude a linha para Letra.
Acordes entre colchetes pertencem a outro formato. Se um arquivo contém um acorde entre colchetes, como [Am] ou [G7], ou começa com { como o primeiro caractere do arquivo, o SongSheet Pro o trata como ChordPro em vez de texto simples. Nomes de estrofes entre colchetes, como [Chorus] e [Verse 1], não têm esse efeito.
Linhas de letra
Toda linha que não seja de um dos tipos acima é letra, inclusive uma linha que começa com #. O texto simples não tem comentários, então todas as linhas são importadas.
Tipos de arquivo
O SongSheet Pro abre arquivos de texto simples que terminam em .txt ou .text. Cada arquivo de texto simples é importado como uma única música.
Exemplo completo
Este é um arquivo mais longo, com as duas primeiras estrofes do mesmo hino, que usa todos os tipos de linha. Ele mostra como as peças das seções acima se encaixam:
Title: Amazing Grace
Artist: John Newton
Key: D
Capo: 2
Tempo: 90
3/4
Verse 1:
D D7 G D
Amazing grace! (how sweet the sound)
E A
That saved a wretch like me!
D D7 G D
I once was lost, but now am found;
Bm A D
Was blind, but now I see.
Verse 2:
'Twas grace that taught my heart to fear,
And grace my fears relieved;
How precious did that grace appear
The hour I first believed.
Copyright: Public domain
Title:eArtist:dão rótulo ao título e ao artista.Key: D,Capo: 2,Tempo: 90,3/4e a linha de copyright são detalhes da música.Verse 1:eVerse 2:são nomes de estrofes, e a linha em branco antes deVerse 2:encerra a primeira estrofe.- As linhas como
D D7 G Dcontêm os acordes. Cada acorde fica sobre o caractere da letra que está na mesma coluna, então o primeiroDestá sobre omdeAmazing. - As demais linhas que não estão em branco são letra.
Para experimentar a importação de texto simples, arraste e solte o exemplo completo no SongSheet Pro e depois revise a importação.
Revisando a importação
Quando você importa um único arquivo, ou solta um texto na sua biblioteca, o SongSheet Pro exibe uma pré-visualização na tela Importar Música antes de adicionar a música. Procure na pré-visualização linhas lidas com o tipo errado, como um nome de estrofe mostrado como letra ou um título que, na verdade, é uma linha da letra. Se você selecionar ou arrastar vários arquivos de uma vez, não há pré-visualização de cada música. O SongSheet Pro abre, então, uma única janela de importação para todos eles, em que você escolhe o que fazer com as músicas que já estão na biblioteca, e ignora qualquer arquivo que não consiga ler. Veja Adicionando músicas.

Se uma linha estiver errada, você pode mudá-la para o tipo que ela deveria ter, por exemplo de acordes para letra. Para alterar o tipo de uma linha:
- Toque em Tipos de Linha ou deslize para a esquerda.
- Toque na linha e então escolha o tipo na lista à direita. Para remover a linha da música, escolha Ignorar esta linha.
- Toque em Pré-visualizar para voltar à pré-visualização da música.

A lista tem três grupos:
- Metadados da Música: Título da música, Artista, Tom, Capotraste, Fórmula de compasso, Andamento e Copyright.
- Conteúdo da Música: Nome da estrofe, Acordes e Letra.
- Outro: Linha em branco e Ignorar esta linha.
Só podem ser escolhidos os tipos que fazem sentido para a linha, e as opções dependem do tipo que o SongSheet Pro detectou. Para desfazer uma alteração, escolha de novo o tipo original da linha. Uma linha de letra não pode ser mudada à mão para tom, capotraste, andamento ou fórmula de compasso: escreva-a em uma das formas de Detalhes da música e importe o arquivo de novo.
As alterações valem somente para a música que você está importando, e o arquivo não é alterado. Ao escolher Título da música, Artista, Copyright ou Nome da estrofe, a linha inteira é mantida, inclusive um rótulo como Title:. Em um nome de estrofe, apenas os espaços no início e no fim são removidos; por isso, os dois-pontos permanecem no nome. Se você mudar uma linha para Acordes, o SongSheet Pro coloca esses acordes sobre a linha de letra abaixo, por coluna, e não verifica se são acordes de verdade.
Quando estiver satisfeito com a importação, toque em Importar no canto superior direito para adicionar a música à sua biblioteca. Toque em Cancelar no canto superior esquerdo para fechar a tela de importação sem importar a música.
SongSheet Pro