Augustinus

Augustinus é uma ferramenta poderosa para gerar notação de canto gregoriano no formato .gabc. Ele recebe texto e um modelo como entrada e produz um arquivo GABC contendo a partitura gregoriana completa.

Este projeto é um monorepo que contém a lógica principal, uma interface de linha de comando (CLI) e um frontend baseado na web.

Acesse a documentação e guia de uso aqui

Acesse a interface do programa aqui: augustinus.liturgiacantada.com.br

Funcionalidades

• Geração de GABC: Converte texto em notação GABC com base em modelos predefinidos ou personalizados.
• Separação de Sílabas: Posiciona corretamente as notas nas sílabas usando a biblioteca separador-silabas.
• Múltiplas Interfaces: Use-o através da web, CLI.
• Modelos Personalizáveis: Defina seus próprios modelos musicais em formato JSON.

Pacotes

Este monorepo está organizado nos seguintes pacotes:

@augustinus/core

O coração do projeto, este pacote contém a lógica principal para gerar GABC. É responsável por analisar o texto, aplicar modelos e produzir a saída final do GABC.

@augustinus/cli

Uma interface de linha de comando para usar a funcionalidade de geração de GABC. É perfeito para processamento em lote ou integração com scripts.

@augustinus/frontend

Uma interface web amigável para o Augustinus. Permite que você insira texto, selecione um modelo e veja o GABC gerado e sua renderização SVG em tempo real.

Começando

Uso comum

Acesse a interface do programa aqui: augustinus.liturgiacantada.com.br

Desenvolvimento / CLI

Para começar a desenvolver o Augustinus, você precisará ter o Bun instalado.

1. Clone o repositório:

   git clone https://github.com/gigiodelchiaro/Augustinus.git
   cd Augustinus

2. Instale as dependências:

   bun install

Uso

Frontend

Para iniciar o servidor de desenvolvimento do frontend:

bun run start:frontend

Isso abrirá a interface da web em seu navegador, onde você pode começar a gerar GABC.

CLI

A CLI fornece uma maneira poderosa de usar o Augustinus a partir do seu terminal.

Uso Básico:

bun run start:cli -- -t "Seu texto aqui" -m "Oração tom solene"

Opções:

• -t, --text: Texto de entrada para converter em GABC.
• -i, --input: Caminho do arquivo de entrada.
• -o, --output: Caminho do arquivo de saída.
• -m, --model: Nome do modelo a ser usado.
• --addOptionalStart: Adicionar início opcional.
• --addOptionalEnd: Adicionar final opcional.
• --removeNumbers: Remover números da entrada.
• --removeParenthesis: Remover parênteses e seu conteúdo da entrada.
• --separator: Separador entre frases.
• --removeSeparator: Se for falso, o caractere separador será usado para unir as linhas GABC.

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um pull request ou abrir uma issue.

Agradecimentos

• Danillo Del Chiaro: por patrocinar o projeto.
• Prof. Dr. Clayton Dias: pela revisão e direcionamento intelectual do projeto.

Um agradecimento especial à Neumz e às pessoas que tornaram o Scribio (nosso renderizador de SVG) possível:

• Andrew Hinkley, Dominique Crochu e John Anderson do time Neumz.

• Joshua Guenther: desenvolvedor do Scrib.io.

• Matthias Bry: por escrever a especificação e depurar o Scrib.io.

E, claro, a todos os contribuidores do projeto Gregorio.

Licença

Este projeto está licenciado sob a Licença MIT. Veja o arquivo LICENSE para detalhes.