Guia de Formatação de Cifras

📋 Visão Geral

O LouvorDeck aceita importação de cifras em formato arquivo de texto (.txt). O arquivo deve seguir uma estrutura simples que o sistema lê automaticamente para:

Identificar o título e artista da música
Separar as seções (Introdução, Verso, Refrão, etc.)
Extrair os acordes das letras e exibi-los acima de cada linha
Permitir a transposição automática de tons

💡

Não é necessário usar nenhum software especial. Basta um editor de texto comum (Bloco de Notas, Notes, Google Docs exportado como .txt).

📝 Cabeçalho — Metadados da Música

O arquivo deve começar com as informações da música, antes de qualquer seção. Cada campo fica em uma linha separada no formato Campo: Valor.

Campo	Exemplo	Obrigatório?	Descrição
`Título:`	`Título: Oceanos`	✅ Sim	Nome da música
`Artista:`	`Artista: Hillsong`	✅ Sim	Nome do artista ou banda
`Tom:`	`Tom: G`	Recomendado	Tom original da música (usado na transposição)
`BPM:`	`BPM: 72`	Opcional	Andamento em batidas por minuto
`Compasso:`	`Compasso: 4/4`	Opcional	Fórmula de compasso

Título: Oceanos
Artista: Hillsong United
Tom: G
BPM: 72
Compasso: 4/4cabeçalho

ℹ️

O sistema também aceita as variantes em inglês: Title:, Artist:, Key:, Time:.

🗂️ Seções da Música

Separe o conteúdo da música em seções usando o nome da seção entre colchetes em uma linha própria. O sistema reconhece os seguintes nomes:

Tag no arquivo	Seção gerada
`[Introdução]` ou `[Intro]`	Introdução
`[Verso]` ou `[Estrofe]` ou `[Verse]`	Verso
`[Pré-Refrão]` ou `[Pre-Chorus]`	Pré-Refrão
`[Refrão]` ou `[Coro]` ou `[Chorus]`	Refrão
`[Ponte]` ou `[Bridge]`	Ponte
`[Final]` ou `[Finalização]` ou `[Outro]`	Finalização

💡

Tags Personalizadas: Se você usar uma tag que não está na tabela (como [Primeira Parte], [Solo] ou [Coda]), o LouvorDeck irá detectá-la automaticamente e classificá-la na categoria "Outro" no aplicativo, garantindo que nenhuma parte da sua música seja descartada.

⚠️

Linhas fora de uma seção (entre dois marcadores) são ignoradas pelo parser. Certifique-se de que todo o conteúdo está dentro de uma seção declarada.

🎸 Acordes Inline (Formato Recomendado)

Escreva os acordes diretamente dentro da linha da letra, entre colchetes, na posição exata onde o acorde cai:

[Verso]
[G]Tu me cha[D]mas para as [Em]águas
[C]Onde os pés po[G]dem afundaracordes inline

O LouvorDeck vai exibir os acordes automaticamente acima de cada sílaba, assim:

G          D          Em
Tu me chamas para as águas
C              G
Onde os pés podem afundarresultado no app

Exemplos de acordes válidos

O sistema reconhece qualquer acorde nos padrões: [G] [Am] [F#m7] [Bb] [C/E] [Dm7] [G#º]

📃 Formato Simples (Alternativo)

Se preferir, escreva os acordes em uma linha separada, acima da letra correspondente (cifra tradicional). O sistema detecta automaticamente este formato:

[Refrão]
G        D    Em      C
Espírito Santo eu te quero aqui
G        D       Em    C
Envolve minha vida com teu amorformato simples

💡

O sistema distingue linhas de acordes das linhas de letra automaticamente: uma linha que começa com A–G seguido de b, # ou m é tratada como linha de acordes.

📄 Exemplo Completo de Arquivo

Copie este modelo como ponto de partida para criar suas cifras:

Título: Nome da Música
Artista: Nome do Artista
Tom: G
BPM: 75
Compasso: 4/4

[Introdução]
G  D  Em  C

[Verso]
[G]Primeira linha [D]da letra aqui
[Em]Segunda linha [C]continua assim

[Pré-Refrão]
[Am]Linha do pré-re[D]frão

[Refrão]
[G]Primeira linha [D]do refrão
[Em]Segunda linha [C]do refrão

[Ponte]
[C]Texto da ponte [G]vai aqui

[Final]
[G]  [D]  [Em]  [C]  [G]modelo.txt

💡 Dicas e Avisos

✅ Boas práticas

Salve o arquivo com codificação UTF-8 para garantir que acentos (é, ã, ç) apareçam corretamente
Use nomes de seção em português — o sistema reconhece: Verso, Refrão, Ponte, Introdução, Pré-Refrão, Final
Informe sempre o campo Tom: para habilitar a transposição automática dentro do app
Uma seção pode aparecer mais de uma vez no arquivo (ex: dois [Verso]) — cada uma vira uma seção independente

❌ O que evitar

Não use PDF — apenas arquivos .txt são aceitos na importação
Não misture acordes inline e acordes em linha separada dentro da mesma seção
Não deixe conteúdo fora de uma seção declarada — ele será ignorado
Evite caracteres especiais nos nomes dos campos do cabeçalho

🎹

Dica de transposição: Após importar, o LouvorDeck permite mudar o tom da música em tempo real para todos os integrantes da escala — inclusive em cifras já existentes sem necessidade de reimportar.