O Girador est un séquenceur rythmique interactif développé pour explorer, composer et transmettre le Maracatu de Baque Virado, une tradition percussive centenaire originaire de l'État du Pernambouc au Brésil. L'application est conçue pour simuler les interactions sonores et spatiales d'un bloco (groupe) de maracatu complet.

La philosophie d'O Girador repose sur la rencontre entre la tradition et l'audio numérique moderne (Web Audio API et Tone.js). Son identité visuelle est profondément inspirée de la littérature de Cordel et des Xilografias (gravures sur bois) traditionnelles du Nordeste brésilien, caractérisées par leurs traits noirs épais, leur papier vieilli et leurs contrastes marqués.

O Girador é um sequenciador rítmico interativo desenvolvido para explorar, compor e transmitir o Maracatu de Baque Virado, uma tradição percussiva centenária originária de Pernambuco, Brasil. O aplicativo foi projetado para simular as interações sonoras e espaciais de um bloco de maracatu completo.

A filosofia do O Girador baseia-se no encontro entre a tradição e o áudio digital moderno (Web Audio API e Tone.js). Sua identidade visual é profundamente inspirada na literatura de Cordel e nas Xilogravuras tradicionais do Nordeste brasileiro, caracterizadas por traços pretos grossos, papel envelhecido e contrastes marcantes.

La **Roda** est le cœur interactif et visuel de l'application. Elle remplace la grille de défilement linéaire standard par un format circulaire de cercles concentriques. Cela permet d'avoir une vision globale et holistique du rythme en cours, à la manière des percussionnistes réunis en cercle dans la tradition.

A **Roda** é o coração interativo e visual do aplicativo. Ela substitui a grade de rolagem linear padrão por um formato circular de círculos concêntricos. Isso permite uma visão global do ritmo em andamento, imitando a disposição dos percussionistas em uma roda tradicional.

La console de mixage permet de sculpter l'espace acoustique global de votre bloc de maracatu en ajustant les niveaux, la réverbération et le panoramique stéréo de chaque instrument.

O console mixer permite esculpir o espaço acústico global do seu bloco de maracatu, ajustando os volumes, efeitos e a distribuição estéreo de cada instrumento.

L'éditeur détaillé (✏️) vous donne un accès chirurgical au comportement acoustique de chaque frappe individuelle. Cliquez sur un pas actif pour ouvrir la boîte de sculpture :

O editor detalhado (✏️) oferece acesso cirúrgico ao comportamento acústico de cada batida individual. Clique em um passo ativo para abrir o painel de escultura:

Le séquenceur linéaire (🎞️) permet d'agencer de multiples patterns sur la durée pour construire une structure de chanson complexe (intro, couplet, refrain, breaks).

O sequenciador linear (🎞️) permite organizar múltiplos padrões ao longo do tempo para construir uma estrutura musical completa (introdução, estrofe, refrão, quebras).

Contrairement aux séquenceurs classiques limités à une seule métrique globale, O Girador vous permet de changer la Signature Rythmique à chaque mesure individuelle.

• Sélection : Sur la règle supérieure, cliquez sur l'indicateur de signature (ex: 4/4) au sommet d'un compasso.
• Choix Disponibles : Vous pouvez choisir parmi 4/4, 3/4, 2/4, 6/8 ou 12/8.
• Adaptation Automatique : La grille des pas se redivise instantanément à l'écran. Le métronome ajuste dynamiquement son accentuation (pulsation forte sur le premier temps de la mesure) lors de la lecture en temps réel.

Ao contrário dos sequenciadores clássicos limitados a uma única métrica global, o O Girador permite alterar a Assinatura Rítmica a cada compasso individualmente.

• Seleção : Na régua superior, clique no indicador de assinatura (ex: 4/4) no topo de um compasso.
• Métricas Disponíveis : Você pode escolher entre 4/4, 3/4, 2/4, 6/8 ou 12/8.
• Adaptação Automática : A grade de passos se reorganiza instantaneamente na tela. O metrônomo ajusta automaticamente sua acentuação (pulso forte no primeiro tempo do compasso) durante a reprodução.

Le maracatu est une musique vivante caractérisée par des variations de vitesse (l'aceleração à la fin d'un morceau, ou le freinage du rythme - arrasto). O Girador vous permet de programmer précisément ces variations :

• BPM par Mesure : Saisissez le tempo désiré dans le champ de saisie numérique BPM disponible en haut de chaque mesure sur la timeline.
• Type de Transition : Cliquez sur l'icône de transition à côté du BPM pour basculer entre :
  • Transition Immédiate (→) : Le tempo change brusquement dès la première note de la mesure cible.
  • Rampe Progressive (↗) : Le tempo accélère ou ralentit de façon linéaire et continue tout au long de la mesure en cours, partant du tempo de la mesure précédente pour atteindre exactement le BPM cible à la fin de la mesure.

O maracatu é uma música viva caracterizada por variações de velocidade (a aceleração no final de uma música, ou o arrasto). O Girador permite programar essas variações de forma muito precisa:

• BPM por Compasso : Digite o tempo desejado no campo BPM disponível no topo de cada compasso na linha do tempo.
• Tipo de Transição : Clique no ícone de transição ao lado do BPM para alternar entre:
  • Transição Imediata (→) : O tempo muda bruscamente na entrada do compasso alvo.
  • Rampa Progressiva (↗) : O tempo acelera ou desacelera linearmente ao longo do compasso, partindo do tempo do compasso anterior para atingir o tempo alvo exatamente no final do compasso.

Pour structurer l'intensité dramatique de votre morceau ou créer des transitions de fondu enchaîné, vous pouvez programmer des variations de volume global par mesure :

• Volume par Mesure : Réglez le pourcentage de volume (de 0% à 100%) souhaité pour chaque mesure dans le champ VOL situé dans la règle supérieure.
• Type de Transition de Volume : Cliquez sur l'icône de transition de volume pour choisir :
  • Transition Immédiate (→) : Le volume général s'ajuste instantanément au début de la mesure.
  • Rampe de Volume / Fade (↗) : Effectue une transition progressive (Fade In ou Fade Out) tout au long de la mesure. Idéal pour faire apparaître doucement le groupe au début d'un arrangement (ex: de 0% à 100% sur 2 mesures) ou pour effectuer une baisse progressive de volume jusqu'au silence complet à la fin du morceau (Fade Out de 100% à 0%).

Para estruturar a intensidade dramática da sua música ou criar transições suaves, você pode programar variações de volume global por compasso:

• Volume por Compasso : Defina a porcentagem de volume (de 0% a 100%) desejada para cada compasso no campo VOL localizado na régua superior.
• Tipo de Transição de Volume : Clique no ícone de transição de volume para escolher:
  • Transição Imediata (→) : O volume geral se ajusta instantaneamente no início do compasso.
  • Rampa de Volume / Fade (↗) : Faz uma transição progressiva (Fade In ou Fade Out) ao longo do compasso. Ideal para introduzir o bloco gradualmente (ex: de 0% a 100% em 2 compassos) ou terminar a música em silêncio (Fade Out de 100% a 0%).

La Toada désigne le chant traditionnel qui accompagne le maracatu. O Girador intègre un moteur de synthèse vocale syllabique unique couplé à un affichage de paroles de style Karaoké.

Comment configurer et chanter la Toada :

1. Ajoutez une piste de type Voz / Coro dans le mixeur à l'aide du bouton ➕ Ajouter instrument.
2. Ouvrez l'éditeur détaillé (✏️) de cette piste.
3. Pour chaque pas actif, choisissez s'il s'agit d'un chant principal solo (PUX - Puxador, s'affiche en orange) ou d'un chant collectif (CORO - Chœur, s'affiche en cian/bleu clair).
4. Saisissez la syllabe correspondante dans le champ de texte du pas (ex: "Va", "di", "ar").
5. Réglez la note musicale voulue (ex: Do, Ré, Mi / C4, D4, E4...) pour faire chanter le synthétiseur vocal.
6. Ouvrez le panneau de droite sur l'onglet TOADA et cliquez sur 🔄 Extraire du mixeur. Les paroles sont générées.
7. Appuyez sur ▶ Play : les syllabes s'illuminent en temps réel en suivant le rythme exact de la lecture audio !

Règles d'écriture des syllabes (Liaisons) :

• Tiret final (-) : Si vous ajoutez un tiret à la fin d'une syllabe (ex: Va- puis di- puis ar), l'application comprend qu'il s'agit du même mot et colle les syllabes visuellement à l'écran : Vadiar.
• Sans tiret : Indique la fin d'un mot et ajoute automatiquement un espace après la syllabe dans le texte de la Toada.

A Toada refere-se ao canto tradicional que acompanha o maracatu. O Girador integra um motor de síntese de voz silábica exclusivo acoplado a uma exibição de letras no estilo Karaokê.

Como configurar e cantar a Toada:

1. Adicione uma pista do tipo Voz / Coro no mixer usando o botão ➕ Adicionar Instrumento.
2. Abra o editor avançado (✏️) desta pista.
3. Para cada passo ativo, selecione se é o canto do puxador (PUX - laranja) ou do coro (CORO - ciano).
4. Digite a sílaba correspondente no campo de texto do passo (ex: "Va", "di", "ar").
5. Defina a nota musical desejada (ex: Dó, Ré, Mi / C4, D4, E4...) para fazer o sintetizador de voz cantar.
6. Abra o painel direito na aba TOADA e clique em 🔄 Extrair do mixador para gerar as letras.
7. Pressione ▶ Play : as sílabas acendem em tempo real seguindo o andamento da música!

Regras de escrita das sílabas (Ligações):

• Hífen final (-) : Se você adicionar um hífen ao final de uma sílaba (ex: Va- depois di- depois ar), o aplicativo une as sílabas formando uma única palavra na tela: Vadiar.
• Sem hífen : Indica o fim de uma palavra e adiciona automaticamente um espaço após a sílaba na Toada.

Le maracatu n'est pas une musique rigide ou mathématiquement calée sur une grille temporelle parfaite. Son balancement ("gingado" ou "suingue") caractéristique provient de micro-décalages temporels constants dans la manière de frapper les instruments, en particulier la Caixa.

En activant le bouton ≈ Swing (situé dans la barre de contrôle), O Girador applique un décalage de micro-timing dynamique et mathématique sur chaque groupe de 4 doubles croches (16e de note) :

Pas du cycle (de 4)	Ajustement Temporel	Effet Acoustique
Premier Pas (Le Temps)	Sur le temps strict (0% de décalage)	Assure l'assise rythmique stable du groupe.
Deuxième Pas	Retardé de +15%	Crée une sensation de retenue, de lourdeur traditionnelle.
Troisième Pas (Le Contretemps)	Sur le contretemps strict (0% de décalage)	Maintient la pulsation de soutien.
Quatrième Pas	Anticipé de -10%	Relance l'élan vers le temps fort suivant.

Ce décalage interne propre à la tradition permet de redonner vie et authenticité aux banques de sons de l'application.

O maracatu não é uma música rígida ou matematicamente alinhada em uma grade perfeita. O seu balanço ("gingado" ou "suingue") tradicional provém de micro-desvios temporais constantes na execução dos instrumentos, em especial a Caixa.

Ao ativar o botão ≈ Swing (localizado na barra de controle), o O Girador aplica um desvio de tempo dinâmico a cada grupo de 4 semicolcheias:

Passo no ciclo (de 4)	Ajuste Temporal	Efeito Acústico
Primeiro Passo (O Tempo)	No tempo estrito (0% de desvio)	Garante a base rítmica firme do grupo.
Segundo Passo	Atrasado em +15%	Cria uma sensação de retenção, a "pesantez" típica do baque.
Terceiro Passo (Contratempo)	No contratempo estrito (0% de desvio)	Mantém a pulsação de suporte.
Quarto Passo	Adiantado em -10%	Empurra o ritmo em direção à próxima batida forte.

Este algoritmo interno permite reproduzir de maneira fiel o suingue orgânico das nações de maracatu de Pernambuco.

Pour composer rapidement sur la grille des pas de l'éditeur détaillé (✏️), vous pouvez utiliser votre clavier d'ordinateur. Lorsque vous appuyez sur une touche correspondant à une frappe, la note est insérée sur le pas en surbrillance, et le curseur avance automatiquement au pas suivant.

Touches de Navigation :

• → ou Tab : Déplace la surbrillance vers le pas suivant.
• ← : Déplace la surbrillance vers le pas précédent.
• Entrée : Confirme et passe au pas suivant.
• Retour arrière (Backspace) : Efface le contenu du pas actuel et revient au pas précédent.

Para compor rapidamente na grade de passos do editor detalhado (✏️), você pode usar o teclado do seu computador. Ao pressionar uma tecla correspondente a um toque, a nota é inserida no passo selecionado e o cursor avança automaticamente para o próximo passo.

Teclas de Navegação:

• → ou Tab : Move a seleção para o próximo passo.
• ← : Move a seleção para o passo anterior.
• Enter : Confirma e avança para o próximo passo.
• Backspace : Apaga o conteúdo do passo atual e volta ao passo anterior.

O Girador vous donne un contrôle total sur vos créations pour les sauvegarder, les partager et les exporter dans différents formats :

• 📂 Charger & 💾 Sauvegarder (Menu Projet) : Permet de télécharger un fichier .json contenant l'ensemble de votre projet (les instruments, les volumes, les panoramiques, les notes de chaque motif et le séquencement complet). Vous pouvez ensuite réimporter ce fichier pour reprendre votre travail.
• Exporter Tablature 📄 : Génère un fichier texte (.txt) formaté contenant une tablature rythmique lisible et universelle de votre composition, idéale pour l'impression ou l'étude visuelle.
• 🎙️ Enregistreur Audio Direct (Bouton ⏺️) : En cliquant sur le bouton d'enregistrement rouge situé dans la barre inférieure, l'application capture directement le flux audio généré par le moteur Tone.js. À la fin de l'enregistrement, un fichier audio au format compressé de haute qualité .webm (ou WAV) est généré instantanément pour le téléchargement.
• Bibliothèque de Presets 📚 : Découvrez et étudiez les classiques du Maracatu (ex: Luanda, Imalê, Vou Vadiar) préchargés dans le menu de sélection des presets en haut de la page.

O Girador oferece controle completo para salvar, compartilhar e exportar suas criações em múltiplos formatos:

• 📂 Carregar & 💾 Salvar (Menu Projeto) : Baixe um arquivo .json contendo toda a configuração do seu projeto (instrumentos, volumes, pans, notas dos padrões e arranjo). Você pode importar este arquivo depois para continuar compondo.
• Exportar Tablatura 📄 : Gera um arquivo de texto (.txt) contendo uma partitura/tablatura rítmica estruturada da sua composição, pronta para estudo ou impressão.
• 🎙️ Gravador de Áudio (Botão ⏺️) : Ao clicar no botão de gravação na barra inferior, o aplicativo captura o fluxo de áudio direto do Tone.js. Quando você parar, um arquivo de áudio de alta fidelidade .webm (ou WAV) será gerado para download automático.
• Biblioteca de Presets 📚 : Experimente e estude baques clássicos do maracatu (como Luanda, Imalê, Vou Vadiar) integrados no menu superior de Presets.

L'utilisation de la Web Audio API et les animations en temps réel (la rotation de la baguette et la pulsation de la Roda) peuvent être gourmandes en ressources processeur sur les ordinateurs anciens, les tablettes ou les smartphones.

Pour assurer une reproduction audio parfaitement stable et éviter les craquements ou désynchronisations sonores, O Girador intègre plusieurs systèmes d'optimisation :

• 🌱 Mode Éco (On/Off) : Cette option, disponible dans le menu principal, désactive l'ensemble des animations lourdes de l'interface (dont la rotation fluide de la baguette et les rebonds visuels des pistes). Le processeur est ainsi soulagé et entièrement dédié au rendu sonore. Fortement recommandé sur tablette et mobile.
• Isolation du Thread Audio : Les calculs de synthèse vocale et les timers rythmiques s'exécutent au sein d'un composant de synchronisation audio dédié (Web Audio Worklet) pour ne jamais être perturbés par l'affichage ou les actions de l'utilisateur sur la page.

O uso da Web Audio API e as animações em tempo real (a rotação da baguete e os pulsares da Roda) podem consumir muitos recursos do processador em computadores antigos, tablets ou celulares.

Para garantir que a música toque sem estalos ou travamentos, o O Girador possui opções de otimização:

• 🌱 Modo Eco (On/Off) : Esta opção, no menu principal, desativa todas as animações pesadas (como a rotação contínua da baguete). Isso alivia o processador, focando os recursos no áudio. Muito recomendado para celulares e tablets antigos.
• Isolamento do Thread de Áudio : O motor de som e os relógios do sequenciador rodam em processos paralelos (Audio Worklet) para garantir estabilidade e sincronia constante, independente do que acontece na tela.