Application web pour créer, écouter et travailler des tablatures d'harmonica diatonique 10 trous. Un seul fichier, aucune installation, aucune connexion : ouvrez harmonica-trainer.html dans votre navigateur. L'interface existe en sept langues (drapeaux du pied de page de l'appli, choix mémorisé — ce manuel suit le même réglage).

💡 Ce manuel est organisé module par module, dans l'ordre où ils apparaissent dans l'appli. Chaque section explique à quoi sert le module, comment s'en servir, et propose au moins un cas pratique pour le prendre en main tout de suite.

1. Premiers pas

En haut de page, un bandeau défilant présente les contenus d'apprendrelharmonica.com ; il se met en pause au survol, un clic ouvre la page. Le logo du site, en bas de page, signe aussi les impressions de tablatures.

Les quatre réflexes à connaître dès le départ

• Cliquer une note joue et écrit en même temps. Chaque clic sur l'harmonica virtuel joue la note et l'ajoute à la tablature — inutile de chercher un bouton « ajouter ».
• ▶ (ou Espace) écoute ce qui est écrit. Tablature vide ? Le bouton « Essayer : … » propose un lick de blues d'une mesure, différent à chaque affichage — pratique pour tester le son sans rien construire.
• 💾 Rien à sauvegarder à la main. L'appli enregistre automatiquement dans le navigateur : fermez, revenez demain, votre session est restaurée telle quelle.
• 📂 Les modules se plient et se déplient d'un clic sur leur titre, pour ne garder à l'écran que ce dont vous avez besoin. Le schéma d'harmonica et « Ma tablature » restent, eux, toujours visibles.

🎯 Cas pratique — Vous ouvrez l'appli pour la première fois : cliquez quelques trous de l'harmonica virtuel pour entendre le son, appuyez sur Espace pour écouter ce que vous venez de composer, puis fermez l'onglet sans rien enregistrer. Rouvrez l'appli : votre petite mélodie est toujours là.

1 bis. Mise en page personnalisée 🔀

Par défaut, les modules s'empilent dans un ordre standard. Si vous utilisez surtout deux ou trois outils (par exemple le générateur de mélodie et l'atelier rythme), vous pouvez les rapprocher pour éviter de faire défiler la page à chaque fois.

• Glissez chaque carte par sa poignée ⠿ : elle s'aimante sur les colonnes de la page.
• La barre « Mise en page » enregistre plusieurs dispositions nommées et les rappelle depuis un menu.
• ↺ revient à la disposition d'origine ; 💾 exporte vos mises en page en fichier réimportable.

Tout est gardé dans le navigateur, propre à cet appareil — si vous changez d'ordinateur, exportez votre mise en page pour la retrouver ailleurs.

2. La notation

La tablature de l'appli se lit comme une tablature papier classique, avec quelques signes en plus pour les altérations et les overnotes.

Écriture	Signification
+4 / -4	Souffler / aspirer dans le trou 4
-3', -3'', -3'''	Altération aspirée de 1, 2, 3 demi-tons
+8'	Altération soufflée (trous 8–10)
+6° / -7°	Overblow / overdraw
z	Silence (à l'import texte)

Le même code couleur revient partout dans l'appli — sur la tablature, l'harmonica virtuel, le tracé du jeu en direct : soufflé · aspiré · altération · overblow · overdraw. Une fois ce code intégré, vous lisez la couleur avant même de lire le chiffre.

3. L'harmonica virtuel

C'est le cœur de l'appli : un harmonica complet, dans la tonalité affichée au-dessus du schéma. Chaque colonne aligne, de haut en bas : overblows, altérations soufflées, note soufflée, note aspirée, altérations aspirées, overdraws.

• Cliquer un numéro de trou ajoute la note soufflée du trou correspondant.
• Survoler une colonne l'éclaire, pour repérer visuellement toutes les techniques disponibles sur ce trou.
• Les noms de notes affichés suivent la tonalité et l'octave choisies — changez la tonalité, les noms changent, mais l'emplacement physique des sons reste le même.

3 bis. Keyfinder 🔑

Le Keyfinder répond à une question que tout harmoniciste se pose tôt ou tard : « quel harmonica je prends pour ce morceau ? » — ou l'inverse, « qu'est-ce que je peux jouer avec l'harmonica que j'ai en main ? ». Il affiche aussi les notes essentielles de la position choisie (tonique, tierces, quinte, septièmes) et où les jouer sur l'harmonica.

Cas pratique 1 : je pars de la tonalité du morceau

1. Onglet « Trouver l'Harmonica » : choisissez la tonalité du morceau (ex. Do).
2. Choisissez la position dans laquelle vous souhaitez jouer (ex. 2ème position).
3. Le Keyfinder indique quel harmonica prendre et affiche les notes clés : tonique, tierce majeure, tierce mineure, quinte juste, septième mineure, septième majeure — avec leur emplacement sur l'harmonica.

Exemple : pour un morceau en Do joué en seconde position, le Keyfinder recommande l'harmonica en Fa et montre immédiatement où se trouvent la tonique, les tierces, la quinte et les septièmes.

Cas pratique 2 : je pars de l'harmonica que j'ai en main

1. Onglet « Trouver la Tonalité » : sélectionnez la tonalité de votre harmonica (ex. Mi) — plusieurs harmonicas possibles à la fois.
2. L'outil affiche les 12 tonalités jouables avec les positions correspondantes.
3. Choisissez la position adaptée au style du morceau, puis repérez les notes essentielles sur l'instrument.

Exemple : avec un harmonica accordé en Mi, vous jouez en Mi en 1ère position, en Si en 2ème position, en Fa# en 3ème position, etc.

Les notes mises en évidence — et pourquoi elles comptent

Note	Rôle
Tonique	Note de repère principale de la tonalité
Tierce majeure	Donne la couleur majeure
Tierce mineure	Donne la couleur mineure / blues
Quinte juste	Note d'appui stable
Septième mineure	Couleur blues / dominante
Septième majeure	Couleur jazz / majeure

En résumé : que vous partiez de la tonalité du morceau ou de l'instrument, le Keyfinder vous guide en quelques clics — vous gagnez du temps et vous jouez plus juste, plus vite.

4. La barre d'outils

La barre d'outils regroupe cinq familles de commandes. Elles reviennent tout le temps, autant les connaître par cœur dès le début.

🎵 Lecture

• ▶/⏹ (Espace) : lit ou arrête la tablature. ⏸ Pause (touche P) met en pause et retient la note en cours — un second clic (ou P) reprend exactement là, tandis que ⏹ arrête franchement et oublie la position.
• Départ n'importe où : cliquez une note de la tablature, ▶ démarre à cet endroit (sans sélection, la lecture repart du début). Une reprise en cours de morceau saute la levée et le décompte, et cale la grille d'accords sur la mesure jouée.
• ⟳ boucle sans coupure — le champ ×N à côté fixe un nombre de boucles (joue N fois puis s'arrête ; vide = infini).
• 🎹 Accords plaqués : à côté du champ de boucles, joue les accords du constructeur en bloc (piano) au lieu de leurs arpèges.
• ⏱0 Décompte : le métronome ne bat que pendant l'anacrouse (mesure 0), puis se tait pour le reste de la lecture.
• Tempo 40–240, 🔊 Volume, ⏱ Métronome (temps fort selon la mesure : toutes les 4 ou 3 pulsations).
• TAP : cliquez en rythme (souris) pour fixer le tempo — moyenne des derniers clics, appliquée au tempo général ; RESET efface les clics.

🎯 Cas pratique — Vous ne connaissez pas le tempo exact d'un morceau que vous voulez travailler : tapez-le au clic (TAP) en écoutant l'original sur votre téléphone, l'appli en déduit le BPM et le règle directement.

Pendant la lecture, la note en cours s'illumine dans la tablature et sur l'harmonica — un repère visuel utile pour suivre sans se perdre.

🏋️ Exercices

• 🎼 Générateur de mélodies (détaillé au § 7).
• 🎶 Constructeur d'accords et ♬ Progressions d'accords (détaillés au § 7 bis).
• 🧩 Structure du morceau (détaillé au § 7 ter).
• 🎙︎ Capteur micro (test) (détaillé au § 8 quinquies) et 👂 Relevé à l'oreille (détaillé au § 8 ter).
• 🔀 Mélange de la tablature (une fois par clic, Ctrl+Z pour revenir).
• ⇅ montant puis descendant.
• SWING (croches ternaires : toute attaque tombant sur le « et » du temps est retardée aux deux tiers du temps).
• 🎲 Durées aléatoires.
• +BPM tempo progressif (détaillé au § 6).

Ces modes se cumulent : vous pouvez, par exemple, mélanger une mélodie et activer le swing et le tempo progressif, tout en même temps.

🎼 Tablature (affichage)

• TAB / Notes / Do Ré Mi : bascule entre la tablature, les noms anglo-saxons (C4, Bb3…) ou latins (Do4, Sib3…).
• Tonalité (12 harmonicas) : noms et hauteur s'adaptent, la tablature reste identique — c'est un changement d'affichage, pas de contenu.
• ▾8 / ▴8 : transpose d'une octave les notes sélectionnées (ou toute la tablature si rien n'est sélectionné ; trous équivalents). Si une note n'a pas d'équivalent, rien ne bouge et l'appli les liste. Sélection : Maj+clic une plage, Ctrl/Cmd+clic une note à la carte, ⇄ Inverser échange sélectionnées et non sélectionnées.
• 1·3b·5 Degrés : affiche sous chaque note son degré dans la gamme de référence — le bouton 🎼 voisin ouvre le générateur pour choisir la gamme, et l'affichage s'aligne automatiquement dessus. Les notes hors gamme sont grisées ; les arpèges du constructeur d'accords affichent les intervalles de l'accord (1, 3b, 5, 7b…).

📁 Fichier

• 📚 Bibliothèque : tablatures nommées, stockées dans ce navigateur — charger, renommer, supprimer ; ⬇ Tout exporter en .json réimportable. Les fenêtres se déplacent à la souris.
• 💾 / 📂 : fichier .json complet ; 📂 ouvre aussi les .mid (conversion en tablature : durées quantifiées, silences reconstruits, tempo appliqué, notes injouables listées, meilleure tonalité suggérée) et les .xml/.musicxml.
• 📋 Importer une tablature texte (détaillé au § 5) · 🎹 MIDI (instrument GM Harmonica) · XML MusicXML : partition exacte — figures et durées coïncident toujours, mesures pleines, liaisons écrites ; MuseScore ne réécrit rien. · TXT : export en texte brut avec les effets (bends, overnotes…), pratique à coller dans un message.
• 🖨 Imprimer : mise en page propre, fond blanc, logo, 12 notes par ligne (PDF via « Imprimer en PDF »).

🎯 Cas pratique — Vous préparez un support de cours pour un élève : composez la tablature, cliquez 🖨 Imprimer, puis « Imprimer en PDF » depuis la boîte de dialogue du navigateur. Le PDF garde votre logo et reste lisible même imprimé en noir et blanc.

✏️ Édition & ♩ Durées

↶/↷ (Ctrl+Z / Ctrl+Y), 🗑 tout effacer, ? aide, ! réinitialise l'affichage des fenêtres ouvertes (utile en cas de fenêtre bloquée ou mal placée hors de l'écran).

Neuf valeurs rythmiques sont disponibles : ronde, blanche, noire, croche, double-croche, triolet, point (+50 %), et trois silences (1, ½, ¼ temps). La durée choisie s'applique aux prochaines notes que vous saisissez ; sur une sélection existante, elle la modifie directement.

Notes à cheval sur une mesure : divisées à l'affichage et reliées par ‿ (partie liée en pointillés) — la note reste une seule note, jouée d'un souffle ; l'export MusicXML écrit la liaison.

‿ Liaison : lie les notes sélectionnées — le signe ‿ s'affiche entre elles. Deux notes liées de même hauteur s'enchaînent d'un seul souffle, sans réattaque, et l'export MusicXML écrit la liaison de phrasé. Le bouton ‿ de l'éditeur (double-clic sur une note) fait de même, note par note.

5. Importer une tablature texte 📋

Utile pour récupérer une tablature trouvée sur un forum, dans un livre, ou envoyée par un élève en message texte — sans tout retaper à la main.

Collez vos tablatures (notes séparées par espaces ; virgules, retours, | acceptés) : +4 -4 +5 -5 +6 -6' -6 z +6 -5 +5 -4 +4. Le + est facultatif, z insère un silence, les éléments invalides sont ignorés et listés, l'import s'ajoute à la suite de ce qui existe déjà.

6. Travailler un passage

Deux outils pour progresser sur un point précis sans devoir rejouer tout le morceau à chaque essai.

Boucle partielle

Cliquez la première note, Maj+clic la dernière : la plage se surligne, ▶ ne joue qu'elle, ⟳ la boucle. Un clic sans Maj en sort. La plage sert aussi à changer toutes les durées ou supprimer d'un coup.

🎯 Cas pratique — Une phrase de deux mesures vous résiste dans un solo plus long : sélectionnez-la (Maj+clic), activez ⟳, et laissez-la tourner en boucle pendant que vous la travaillez, sans jamais rejouer le reste du morceau.

Tempo progressif (+BPM)

Réglez le pas (1–20 BPM par passage) et le maximum : à chaque tour de boucle le tempo monte et s'affiche. Fonctionne aussi sur une plage sélectionnée : le tempo monte à chaque tour de la sélection, y compris quand l'accompagnement 🎹 est actif.

Exemple classique : 4 notes difficiles, départ à 60 BPM, pas de 4, maximum 120 — vous démarrez lentement et l'appli accélère automatiquement à chaque passage réussi, sans que vous ayez à toucher au tempo vous-même.

7. Générateur de mélodie 🎼

Le générateur compose des mélodies cohérentes, pas de simples suites de notes au hasard : les gammes sont regroupées par position — majeure & pentatonique majeure (1^re) ; blues, mixolydien, pentatonique (2^e) ; pentatonique mineure, blues, dorien (3^e) ; mineure naturelle, pentatonique mineure (4^e) ; phrygien, pentatonique mineure, mineure naturelle avec altérations (5^e) ; lydien, majeure avec altérations (12^e). Quatre niveaux (Débutant trous 4–8 → Expert avec overblows), sur 1, 2 ou 4 mesures. La mélodie finit toujours sur la tonique, sauf si vous cochez « Ne pas finir sur la tonique ».

La fenêtre reste ouverte pendant que vous travaillez : régénérez en boucle (🎼), écoutez, ajustez, sans perdre la main sur le reste de l'appli. Fermez-la par ✕ ou Annuler ; Ctrl+Z restaure la tablature précédente si le résultat ne vous convient pas.

Mes réglages — juste sous « Surprends-moi », enregistrez sous un nom la configuration entière de la fenêtre et rappelez-la d'un clic : gamme, niveau, étendue, longueur, phrasé, mesure, notes par mesure, durées cochées, suivi de la progression et les deux curseurs d'injection. 💾 enregistre (réutiliser un nom existant remplace l'ancien réglage au lieu d'en créer un double), 🗑 supprime le réglage sélectionné, ⬇ exporte tous vos réglages en .json et 📂 les réimporte. Par ailleurs, les réglages de votre dernière génération sont retenus tout seuls : au prochain lancement de l'appli, la fenêtre s'ouvre telle que vous l'aviez laissée.

En un clic, pour aller vite

En haut du générateur, le bouton Surprends-moi règle les menus à votre place (vous les voyez bouger) et génère aussitôt : un clic, une mélodie. Recliquez pour un nouveau tirage. Les réglages détaillés restent dessous pour qui veut choisir gamme, position et niveau précisément.

🎯 Cas pratique — Vous avez 5 minutes avant un cours et voulez un exemple rapide à montrer à un élève débutant : cliquez « Surprends-moi » plusieurs fois de suite jusqu'à obtenir quelque chose de simple et chantant, sans toucher à aucun réglage.

Lire et jouer ce qui vient d'être généré

Le rappel de notation « 📖 Comment lire la tablature ? » (soufflé, aspiré, altérations, code couleur) est disponible dans l'aide ? du menu Édition. Dès qu'il y a des notes, une rangée d'icônes apparaît sous la tablature : ▶ (rouge) lit la tablature, ⏹ (vert) arrête, l'icône micro (bleu) lance le mode 🎯 (vous jouez au micro, l'appli valide note à note) et + ajoute ou insère une note — après la note sélectionnée, sinon à la fin — en ouvrant l'éditeur ; recliquez pour en ajouter d'autres, les barres de mesure se recalculent.

Phrasé : donner une forme à la mélodie

Au-delà d'une mélodie « au fil des notes », vous pouvez imposer un type de phrasé : Question – Réponse (deux membres qui se répondent), Arche (montée puis descente), Vallée (descente puis remontée), Vague (ondulations successives), Montée continue ou Descente continue (la phrase traverse le registre dans un seul sens), Jazz léger (approches chromatiques de certaines notes) ou Bebop complet (enclosures, croches). « Aucun » laisse l'appli libre.

Montée et Descente donnent une direction d'ensemble — ce n'est pas une gamme : la ligne va du grave vers l'aigu (ou l'inverse) en s'autorisant de petits retours en arrière, ce qui la garde musicale. Les deux menus note grave → note aiguë décident de la portion d'harmonica traversée. La dernière note se posant sur la tonique, elle peut revenir un peu en arrière : cochez « Ne pas finir sur la tonique » pour une direction franche jusqu'au bout.

Vallée est l'arche à l'envers : la phrase part dans l'aigu, creuse, puis remonte. Vague enchaîne les changements de direction — une ondulation toutes les deux mesures — c'est le phrasé qui fait travailler les demi-tours, là où beaucoup d'élèves se laissent emporter dans un seul sens.

Blues AAB — la forme chantée, sur votre grille

Le phrasé Blues AAB écrit un chorus de blues comme on le chante : la phrase A occupe les mesures 1 à 4, A' la répète mesures 5 à 8 sans bouger pendant que la grille passe au IV — c'est de ce décalage que vient la tension —, puis B répond et conclut sur les mesures 9 à 12. Chaque groupe de quatre se termine par une respiration : la phrase se pose sur un appui en mesure 4 et en mesure 8, puis laisse la place, comme un chanteur laisse répondre l'instrument. B est plus dense que l'énoncé, et les dernières notes descendent vers la tonique.

Ce phrasé demande une grille de 12 mesures et l'option « Suivre Ma progression » cochée : c'est la forme elle-même qui l'exige. Si l'une des deux manque, l'appli vous le dit au lieu de générer autre chose. Une seule note est retouchée dans A' : la 7e majeure tombée sur un accord de septième (le mi sur un F7, en do) descend d'un demi-ton — les blue notes, elles, sont conservées telles quelles.

🎯 Cas pratique — Chargez le preset Blues 12 mesures depuis « Progressions d'accords », envoyez-le vers « Ma progression », cochez « Suivre Ma progression », choisissez Blues AAB : vous obtenez un chorus complet et structuré, à faire lire ou relever par un élève.

Question – Réponse fonctionne désormais sur 2 mesures autant que sur 4 : la deuxième mesure reprend le rythme et le début de la première, et la question se suspend sur la dominante. De quoi obtenir un lick court et carré, sans passer par 4 mesures.

🎯 Cas pratique — Faire travailler l'étendue à un élève : Descente continue, 4 mesures, niveau Intermédiaire, étendue réduite aux trous 4 à 8 — il obtient une phrase qui redescend tout le registre choisi sans être une simple gamme descendante.

Mesure, durées et étendue

Choisissez la signature — 4/4, 3/4 (valse), 6/8 ou 12/8 : toute l'appli suit (barres de mesure, métronome, exports MIDI et MusicXML). Longueur : 1, 2 ou 4 mesures.

Restreignez les durées de notes employées en cochant uniquement les valeurs voulues — ronde, blanche, noire, noire pointée, croche, double-croche, triolet ou triolet de noires.

Exemple : ronde seule pour une note par mesure, ou blanche seule pour deux notes par mesure — idéal pour un phrasé très simple ou un tout premier niveau. Tout coché = libre.

Si le nombre de notes demandé ne suffit pas à remplir la mesure — 4 croches en 4/4, par exemple — l'appli complète en silences plutôt que de refuser : ils sont répartis dans la mesure, pas entassés à la fin, pour laisser la mélodie respirer.

Deux menus note grave → note aiguë limitent la mélodie générée à la portion d'harmonica de votre choix, parmi les notes disponibles pour la gamme et le niveau sélectionnés — pratique pour rester sur une zone précise de l'instrument. Ils se repeuplent automatiquement au changement de gamme ou de niveau.

Nombre de notes par mesure. Fixez un maximum : à 6, l'appli utilise jusqu'à 6 notes, pas forcément 6. Cochez « exactement ce nombre » pour en imposer le compte exact.

Générer sur une progression d'accords

Si vous cochez « Suivre Ma progression », la gamme choisie s'applique sur les accords de votre progression (module « Ma progression »), quelle que soit leur tonalité — de quoi tester des sonorités inattendues (attention aux dissonances). Chaque accord garde sa durée propre (mesure pleine, demi-mesure…) : la mélodie générée s'y ajuste automatiquement, sans réglage supplémentaire. Les curseurs d'injection ajoutent alors un pourcentage de notes hors gamme et de silences (respirations de fin de phrase).

Le menu « Notes utilisées sur la progression » arbitre entre gamme et accords. Libre mélange les deux, piloté par l'injection — c'est le comportement d'origine, qui peut faire entendre des notes hors gamme (la tierce majeure d'un accord de blues, par exemple). Gamme stricte et Notes communes uniquement restent toutes deux strictement dans la gamme choisie, sans aucune exception — leur différence se joue sur la manière de choisir la note, pas sur l'étendue disponible. En Gamme stricte, l'accord du moment n'a aucune influence : la mélodie suit la gamme sans en tenir compte. En Notes communes uniquement, quand une note de la gamme se trouve être aussi une note de l'accord, l'appli a la possibilité de la choisir en priorité — surtout en début de temps — sans que ce soit systématique ni obligatoire : c'est un choix parmi d'autres, pas une contrainte. Les deux options désactivent le curseur d'injection, qui n'a alors plus d'utilité.

🎯 Cas pratique — Gamme Blues en 2ème position sur une grille de blues : en Libre, des notes de la tierce majeure de l'accord s'invitent dans la mélodie ; passez en Gamme stricte pour rester dans la couleur blues du début à la fin, quel que soit l'accord.

Mes modes 🧬 : créer vos propres gammes

Module repliable pour créer vos propres modes — nom, position (1ère à 12ème), degrés cochés parmi les 12 demi-tons — mémorisés dans le navigateur et disponibles (★) dans les sélecteurs de gammes du générateur, des degrés 1·3b·5 et du Swing-mètre. ✎ modifie un mode, 🗑 le supprime.

Dans la fenêtre du générateur, à côté du sélecteur de gammes : 🗑 retire la gamme affichée de la liste (choix mémorisé), ↺ réaffiche toutes les gammes ; ⬇ exporte vos modes en fichier .json et 📂 les réimporte.

7 bis. Accords & progressions 🎶

Trois modules complémentaires pour travailler avec des accords plutôt qu'avec des notes seules : construire un accord isolé, enchaîner une grille toute prête, et jouer/exporter la grille en cours.

🎶 Constructeur d'accords

Groupe Exercices : choisissez la fondamentale, la qualité (des triades aux 13^e), d'éventuelles altérations/tensions (b5, #5, b9, #9, #11, b13 — actives selon la qualité), une note de basse optionnelle (accord « slash », ex. C/E) et la forme de l'arpège (montée, ou montée-descente).

Le sélecteur Mesure (4/4, 3/4, 6/8, 12/8) fixe la métrique avant de construire — il est partagé avec le générateur de mélodies et les progressions ; si la tablature contient déjà des notes, une confirmation est demandée, car les barres de mesure se redécoupent. Choisissez directement la durée de l'accord, en temps — 1, 2 ou 4 en 4/4 ; 1 ou 3 en 3/4 ; 1½ ou 3 en 6/8 ; 3 ou 6 en 12/8 — le même sélecteur que dans « Progressions d'accords » et dans « Structure du morceau ».

Valider insère l'accord en arpège à la suite de la tablature — position la plus grave jouable, overblows/overdraws compris — et la fenêtre reste ouverte pour enchaîner plusieurs accords à la suite ; Supprimer le dernier retire le dernier ajouté. Le nom de l'accord s'affiche en badge au début de sa ligne, et 🔀 comme 🎲 agissent à l'intérieur de chaque accord sans casser ses mesures. À la lecture, 🎹 (groupe Lecture) bascule en accords plaqués : chaque accord sonne en bloc, au son piano, au lieu de l'arpège.

♬ Progressions d'accords (presets)

Fenêtre déplaçable du groupe Exercices : une vingtaine de progressions classiques (pop, jazz, blues 12 mesures, cadences mineures…), transposables dans les 12 tonalités et en majeur/mineur — cochez « Armure seule » pour ne changer que l'armure affichée sans transposer les accords.

La progression est éditable avant insertion : cliquez un accord pour changer sa fondamentale, sa qualité, ses tensions, sa note de basse, et sa durée propre (1, 2 ou 4 temps selon la mesure) — chaque accord garde sa durée, vous pouvez donc mélanger une mesure pleine et deux demi-mesures dans la même grille. Le sélecteur Mesure de la fenêtre fixe la métrique, dont découle la durée d'une mesure pleine : 4 temps en 4/4, 3 en 3/4, 6 en 12/8. ◀ ▶ déplacent un accord, ✕ le retire, + en ajoute un. Bascule d'affichage Noms / Degrés (chiffres romains).

💾 enregistre votre progression dans la liste des presets (★, 🗑 pour la supprimer), ⬇ exporte vos progressions en .json et 📂 les réimporte. → Ma progression envoie la grille construite vers le module ci-dessous, sans passer par la tablature. Vos structures de morceau enregistrées (module 🧩, § 7 ter) apparaissent aussi dans cette liste, préfixées 🧩 : les sélectionner aplatit toute la structure dans la grille, durées et tonalités par partie conservées.

♬ Ma progression

Ce module affiche la grille reçue : chaque puce indique le nom de l'accord, avec sa durée entre parenthèses si elle diffère d'une mesure pleine (ex. G7 (2)). Les durées sont reconnues et respectées automatiquement, quelle que soit leur origine — presets, constructeur (via la tablature), ou renvoi de la tablature vers ce module — sans aucun réglage manuel à faire.

• ♬ Accompagner la lecture : la grille joue au piano pendant la lecture de la tablature, chaque accord à sa position et sa durée réelles.
• 🪟 Accord courant : ouvre une petite fenêtre déplaçable, toujours au premier plan, qui affiche en grand l'accord en cours et le suivant — pratique pour suivre la grille sans quitter des yeux votre harmonica.
• → Tablature : convertit la grille en arpèges dans la tablature, un groupe par accord, chacun sur sa propre durée.
• 💾 🎹 XML TXT : exportent la grille seule — JSON, MIDI (accords plaqués), MusicXML (accords et symboles écrits au-dessus de la portée, jamais comme des notes), texte (noms d'accords).
• 🗑 : vide la progression.

🎯 Cas pratique — Vous enseignez une grille de blues à un élève en visio : envoyez un preset de blues 12 mesures vers « Ma progression », ouvrez 🪟 Accord courant, et laissez la fenêtre visible pendant que l'élève joue par-dessus — il voit toujours où il en est, sans avoir à lire toute la grille.

Dans l'en-tête de « Ma tablature », le bouton → Ma progression fait le chemin inverse : il relit les arpèges d'accords présents dans la tablature (construits via 🎶) et reconstitue la grille dans « Ma progression », durées comprises. Les icônes 💾 🎹 XML TXT juste à côté sont des raccourcis vers les exports de la mélodie complète — les mêmes que ceux de la barre d'outils principale.

7 ter. Structure du morceau 🧩

Ce module sert à construire la grille d'accords complète d'un morceau, partie par partie, plutôt qu'une seule grille homogène — utile dès qu'un morceau a un couplet et un refrain avec des accords différents.

Fenêtre déplaçable (bouton 🧩, groupe Exercices) : Intro, Couplet, Refrain, Pont, Solo, Break, Transition, Fin, ou une partie Personnalisée — chaque type a sa propre couleur, reprise en liseré sur la carte. Ajouter une partie crée une carte et la sélectionne aussitôt ; son nom est éditable, sa tonalité et son mode se règlent dans l'éditeur ci-dessous et transposent d'un coup tous ses accords.

Construire la grille d'une partie

La grille de chaque partie se construit avec le même constructeur d'accords que 🎶 (§ 7 bis) : + ouvre le constructeur, Valider ajoute l'accord à la partie et la fenêtre reste ouverte pour enchaîner. Ensuite, cliquer une puce d'accord rouvre le constructeur pré-rempli avec cet accord pour le modifier (fondamentale, qualité, durée…) sans toucher au reste de la grille ; la petite ✕ à droite de la puce le retire ; et les + discrets entre les puces insèrent un accord oublié à cet endroit précis — insertions successives enchaînées dans l'ordre où vous les tapez.

Réorganiser et gérer les parties

• ◀ ▶ déplacent une partie d'un cran, ou saisissez sa poignée ⠿ pour la glisser-déposer où vous voulez (un liseré bleu indique l'insertion avant ou après la ligne survolée).
• ⧉ duplique une partie, 📋 la copie et 📥 Coller l'ajoute en fin de structure, 🗑 la supprime (confirmation demandée).
• ↺ Vider toutes les parties en un clic (confirmation demandée) : vos structures enregistrées ne sont pas touchées.

💾 Enregistrer une structure sous un nom : elle rejoint la liste déroulante (recharger une structure demande confirmation si une autre est déjà en cours), 🗑 juste à côté la supprime de la liste. ⬇ exporte toutes vos structures enregistrées en .json, 📂 les réimporte. Vos structures enregistrées apparaissent aussi, préfixées 🧩, dans la liste de « Progressions d'accords » (§ 7 bis) : les y sélectionner aplatit toute la grille, durées et tonalités par partie conservées.

Générer une mélodie sur une partie précise

🎲 Générer une mélodie sur une partie (si elle contient des accords) : le générateur de mélodie 🎼 compose sur sa grille, dans sa tonalité, avec les réglages actuels du générateur (niveau, gamme, phrasé…), et insère le résultat exactement à la place de cette partie dans « Ma tablature » — le reste de la tablature n'est pas touché ; régénérer une partie la remplace, elle ne s'ajoute pas.

🎯 Cas pratique — Vous construisez un morceau avec Intro / Couplet / Refrain / Solo : générez une mélodie tranquille sur l'Intro, puis une mélodie plus technique uniquement sur le Solo, sans jamais toucher aux deux autres parties.

→ Ma progression aplatit la structure entière, dans l'ordre des parties, vers le module § 7 bis — même chemin que les presets.

Exports dédiés : TXT produit une grille imprimable, parties nommées, mesures alignées en colonnes ; XML produit un MusicXML où chaque partie démarre sur une nouvelle ligne (repère de partie et armure), avec les symboles d'accords en notation internationale au-dessus de la portée — la portée reste vide (silences masqués) si « Ma tablature » est vide, ou reprend sa mélodie si elle en contient.

8. Édition fine

Une fois une mélodie posée — générée, importée, ou saisie note à note — voici comment la retoucher précisément.

Vue d'ensemble du bandeau de commandes

De haut en bas, voici à quoi sert chaque commande du bandeau :

• ⠿ déplace le module dans la page.
• Ma tablature : titre du module ; 18 éléments · 4 mesures : compteur de notes/silences et de mesures, mis à jour en temps réel.
• ▼8 / ▲8 : abaisse / monte toute la sélection d'une octave (toute la tablature si rien n'est sélectionné).
• Anacrouse : déclare la première mesure comme anacrouse.
• ▶ rouge en haut à droite : ouvre la vidéo tutoriel du module.
• 💡 bandeau d'astuce : rappelle le double-clic pour éditer une note.
• ▶ / ■ / 🎤 / + : lecture, stop, mode micro, ajouter une note.
• ⇄ Inverser : inverse la sélection (aspiré ⇄ soufflé).
• ✕ Note : efface la dernière note entrée (et actions liées à la note sélectionnée).
• 🗑 Tout : supprime toute la tablature.
• ⇅ Suivre : active/désactive le défilement automatique pendant la lecture.
• ♫ Arpèges : bascule le mode arpèges.
• Muet : coupe le son de lecture.
• → Ma progression : bascule vers le module de progression d'accords lié.
• 💾 / 🎹 / XML / TXT : enregistre la tablature, exporte en MIDI, en MusicXML, en texte.
• ⚠ Compléter la mesure : signale une mesure incomplète à corriger.
• Numéro de mesure (colonne de gauche) : repère la mesure dans la grille.
• Case de note : trou, durée et chiffre du trou — double-clic pour l'éditer (hauteur, durée, silence).

Sélection et suppression

Clic = sélection (les nouvelles notes s'insèrent après) ; ⌫/Suppr supprime ; ←/→ déplace la sélection. Barres de mesure automatiques numérotées (4/4 ou 3/4 selon la signature choisie au générateur) ; le compteur indique éléments et mesures.

L'éditeur de note (double-clic)

Double-clic sur une note ouvre un éditeur complet : changer le trou (1–10), la technique (seules les notes réellement jouables sur ce trou sont proposées, avec leur couleur), la durée et le point, convertir la note en silence (et inversement), ou la supprimer.

Compléter, dupliquer, effacer une mesure

⚠ Compléter la mesure : quand la dernière mesure est incomplète, ce bouton apparaît au-dessus de la tablature. L'appli propose trois fins possibles dans la gamme courante — choisissez-en une, les notes s'ajoutent et la mesure tombe juste.

Dupliquer ou effacer une mesure. Chaque ligne de la tablature correspond à une mesure. Les deux petits boutons en fin de ligne permettent de la dupliquer (une copie s'insère juste après) ou de l'effacer d'un clic.

Transposer d'octave

Octaves ±8. Si les hauteurs le permettent, ▾8 / ▴8 descendent ou montent la sélection (ou toute la tablature) d'une ou deux octaves ; une note sans équivalent n'est pas transposée.

Suivre les accords pendant la lecture

⇅ Suivre et 🎵 Arpèges. Quand une progression est présente dans « Ma progression », ses arpèges d'accords peuvent s'entourer d'un liseré vert pendant la lecture : ⇅ Suivre fait défiler la tablature sur eux (désactivez-le pour faire défiler vous-même), 🎵 Arpèges les fait entendre avec leur accord (désactivez pour ne garder que le piano).

D'où viennent les notes de la tablature ?

S'y affichent les notes issues de : vos clics sur le schéma, le micro (module Reconnaissance de notes ou Capteur micro), le générateur de mélodie, la bibliothèque, le bouton « Tablature » de « Ma progression », le bouton + du module, et le bouton « Essayer ».

Armure de tonalité (pour les exports)

L'armure des exports est automatique : elle suit la tonique de la mélodie générée selon sa position, en majeur ou mineur — ainsi une pentatonique mineure en 3ème position sur un harmonica en C donne Ré mineur (un bémol), et non l'armure de l'harmonica. Sans mélodie générée, c'est la tonalité majeure de l'harmonica. Elle apparaît dans la première mesure du MusicXML (avec le mode) et dans le MIDI — MuseScore affiche une partition propre.

Anacrouse (levée)

Saisissez votre levée au début de la tablature, silences de calage compris — par exemple deux soupirs puis deux croches — et cliquez Anacrouse dans l'en-tête du module : la première mesure devient la mesure 0, marquée d'un liseré pointillé. Recliquez pour annuler. Ses notes s'éditent comme toutes les autres (durée, double-clic, glisser-déposer). À la lecture, la mesure 0 se joue une seule fois en tête : la boucle ⟳ ne répète que le corps, et l'accompagnement de « Ma progression » n'attaque qu'à la mesure 1. Métronome activé, les temps vides précédant la levée sont décomptés — et sans anacrouse, vous bénéficiez d'un décompte d'une mesure complète au départ. L'export MusicXML écrit une vraie levée (mesure 0 écourtée, silences de tête retirés) ; le MIDI conserve le calage exact. Une note à cheval sur la barre reste dans le corps.

8 bis. Dictée musicale 🎧 (bêta)

À utiliser pour travailler l'oreille pure : l'appli joue quelque chose, vous devez le reconnaître et le rejouer sans le voir écrit.

Comment ça se joue

Sous l'accordeur : choisissez 1 à 6 notes et le niveau — Débutant (trous 4–6), Intermédiaire (notes naturelles), Avancé (altérations, sans overnotes), Expert (tout inclus). 🎲 joue une phrase chantable (intervalles ≤ quinte, pas de répétition), dans la tonalité courante. ▶ Réécouter à volonté ; 🎤 Répondre au micro : chaque note juste remplit sa case, une fausse clignote en rouge et compte une erreur. Révéler affiche la solution. N'écrit jamais dans votre tablature.

Score, statistiques et badges

Chaque dictée réussie donne un score = notes × niveau × 100, moins 20 par erreur et 5 par réécoute au-delà de la première. Sous le module : dictées jouées, sans-faute, record, cumul et série en cours (réinitialisables par ↺). Sept badges à débloquer — Oreille de bronze/argent/or (10/50/100 dictées), Sans accroc et Oreille absolue (5 et 10 sans faute d'affilée), Virtuose (une dictée Expert sans faute), Maître du souffle (plus de 1000 points). Tout est gardé dans le navigateur, hors ligne.

🎯 Cas pratique — 5 minutes avant de dormir, sans harmonica sous la main pour lire une partition : lancez une dictée niveau Débutant, jouez au micro sur votre harmonica de chevet, et voyez votre série de sans-faute grandir soir après soir.

8 ter. Relevé à l'oreille 👂 (bêta)

Proche de la Dictée musicale, mais orienté gamme et position plutôt que notes isolées — utile pour habituer l'oreille à une couleur de gamme précise.

Comment ça se joue

Bouton 👂 (groupe Exercices) : l'appli joue quelques notes d'une gamme/position de votre choix (vos modes ★ compris) sans les montrer. Réglez le niveau et le nombre de notes (2–16), réécoutez à volonté, puis reconstituez la phrase dans la fenêtre : 🎤 au micro — chaque note jouée devient une pastille — ou à la main (syntaxe +4 -4 -3' +6° ; clic sur une pastille pour la retirer, ⌫ pour tout effacer). Valider affiche la solution en dessous, vert/rouge note à note : est juste ce qui sonne juste (-2 ≡ +3). Ne touche jamais à votre tablature.

Points et badges

Score = notes justes × niveau × 100, −20 par erreur, −5 par réécoute au-delà de la première, compté à la première validation du tirage. Un niveau tous les 1000 points ; cinq badges (premier sans-faute, 10 et 50 relevés, 5 sans-faute d'affilée, sans-faute en Expert) ; remise à zéro ↺. Conservé dans le navigateur, hors ligne.

8 quater. Atelier rythme 🥁 (bêta)

Travaille le rythme indépendamment de la justesse — parfait pour les élèves qui jouent juste mais « à côté » du temps, ou l'inverse.

Comment ça se joue

Bouton 🥁 (groupe Durées) : l'appli génère un rythme d'une mesure 4/4 selon le niveau — jusqu'aux figures ♪♬♬ et ♬♬♪, à la syncope ♬♪♬, aux silences, triolets et grandes syncopes — et le joue au métronome sur la fondamentale (tempo plafonné 60-100). Après un décompte d'une mesure, reproduisez-le : 🎤 au micro (mélodie ou une seule note, en détachant bien les attaques) ou 👆 en tapant (barre espace ou bouton). Correction figure par figure (vert/rouge), attaques en trop signalées ; la latence est compensée automatiquement — seul le placement rythmique compte.

Points et badges

Justes × niveau × 100, −20 par figure manquée, −10 par attaque en trop, −5 par réécoute au-delà de la première ; un niveau tous les 1000 points, douze récompenses, remise à zéro ↺. Elles portent sur le nombre de rythmes joués (1, 3, 10), les sans-faute (1, 3, 10), les sans-faute d'affilée (2, 5), ceux obtenus dès la première écoute (3) et ceux obtenus à chaque niveau — Intermédiaire, Avancé et Expert, 3 chacun, sans jamais se cumuler d'un niveau à l'autre. Le mode de réponse n'entre pas en compte : micro et tapotement valent exactement pareil. Conservé dans le navigateur, hors ligne.

🎯 Cas pratique — Un élève a tendance à jouer les croches trop en avance : réglez le niveau sur Débutant, laissez-le taper (👆) plutôt que jouer au micro dans un premier temps, pour isoler le problème rythmique sans que la justesse des notes n'interfère.

8 quinquies. Capteur micro (test) 🎙︎

Bouton 🎙︎? (barre d'outils) : une étape de vérification avant d'écrire quoi que ce soit dans la tablature. Rien n'est modifié tant que vous n'avez pas validé.

🎤 Armer le capteur, lancez la lecture (▶) et jouez par-dessus l'accompagnement : chaque attaque détectée s'affiche dans la liste avec sa position jouée, la case visée, la note, le trou en tablature et l'écart en millisecondes. La Grille (noire, croche ou double-croche) fixe la précision de quantification visée.

Calibrer la latence

Entre le moment où le son sort de l'harmonica et celui où le micro le fait parvenir à l'appli, il y a toujours un petit délai : la latence. Non corrigée, elle fausse tout ce qui touche au rythme — l'Atelier rythme ou le mode 🎯 « Jouer la tablature » peuvent juger « en retard » une note pourtant jouée pile à l'heure, et l'écriture automatique via ✍ Écrire dans la tablature… place notes et durées légèrement à côté. Le Swing-mètre peut lui aussi en souffrir un peu, puisqu'il se base sur les écarts de temps entre vos notes. Tant que vous ne vous servez pas d'un exercice chronométré ou de l'écriture automatique, la latence n'a aucune importance.

⏱ Test de latence (le plus simple, à faire en premier) :

1. Cliquez sur ⏱ Test de latence.
2. Après un court décompte, le métronome joue 8 clics tout seul, sans mélodie.
3. Jouez une seule note nette et détachée sur chaque clic — peu importe le trou, l'important est un son propre, pile en place.
4. Une fois les 8 clics passés, l'appli compare chacune de vos attaques au clic correspondant et calcule l'écart médian.

Le résultat s'affiche (ex. « 8 attaques · latence médiane 42 ms ») et le champ Latence (ms) se remplit automatiquement — rien d'autre à faire. Réglage mémorisé pour tout l'appli.

⌁ Calibrer (pour affiner, dans des conditions réelles) :

1. 🎤 Armez le capteur, lancez une lecture réelle (▶) et jouez normalement par-dessus.
2. Chaque note jouée s'ajoute à la liste, avec son écart individuel.
3. Cliquez sur ⌁ Calibrer : l'appli reprend l'écart médian de cette prise et l'ajoute à la latence déjà réglée.

Répétez l'opération dans différentes conditions (casque ou non, autre micro, autre pièce) pour affiner encore.

Swing (position du « et ») : réglable à la main, ou ◱ Mesurer le swing le déduit de ce que vous venez de jouer. Sans rapport avec la latence — la Grille et le Swing ne font que régler la précision de découpage et le feeling ternaire visés.

Enregistrer une mélodie ou une improvisation en tablature

Le capteur ne mesure vos attaques que par rapport à l'horloge de la lecture ▶ de l'appli : pour qu'il capte quoi que ce soit, une lecture doit tourner pendant que vous jouez — même si elle ne contient que des silences.

Cas 1 : en solo, au métronome

1. Choisissez la tonalité de votre harmonica dans le schéma de l'harmonica.
2. Ouvrez le Capteur micro et armez-le (🎤 Armer le capteur).
3. Remplissez « Ma tablature » de mesures vides (uniquement des silences), au tempo souhaité — autant de mesures que nécessaire.
4. Lancez la lecture ▶ de ces mesures silencieuses : c'est elle qui fait tourner le métronome et donne son repère de temps au capteur.
5. Jouez votre mélodie par-dessus, en vous calant sur le clic.
6. Cliquez sur ✍ Écrire dans la tablature… (détail ci-dessous).

Cas 2 : en même temps qu'une vidéo YouTube

Même déroulé que le cas 1, avec une contrainte en plus : à l'étape de lecture, lancez la vidéo YouTube et la lecture des mesures silencieuses en même temps, à la main, le plus près possible l'un de l'autre. Vous jouez ensuite en vous calant sur la vidéo — le métronome de l'appli ne sert plus qu'à faire tourner l'horloge interne du capteur.

Cette synchronisation manuelle fonctionne très bien à tempo lent : un temps dure plus longtemps, donc un petit décalage de synchro ne représente qu'une fraction infime du temps et la note tombe quand même dans la bonne case. À tempo rapide, le même décalage pèse beaucoup plus lourd et le risque que la note bascule dans la case voisine augmente.

✍ Écrire dans la tablature… ouvre « Valider la prise » : comparaison mesure par mesure, ✓ garde votre prise ou ✕ garde la tablature d'origine (raccourcis Tout garder / Tout rejeter). Rien n'est écrit avant Appliquer — et un seul Ctrl+Z revient en arrière.

9. Raccourcis clavier

Touches	Action
1–0	Note soufflée, trous 1 à 10
Maj+1–0	Note aspirée
Espace	Lecture / Stop
P	Pause / Reprendre à la note en cours
← / →	Sélection précédente / suivante
Suppr	Supprimer la sélection (ou la dernière note)
Maj+clic	Sélection d'une plage
Ctrl+Z / Y	Annuler / Rétablir

Claviers AZERTY et QWERTY.

10. Enregistrement audio 🎙 (bêta)

Pour garder une trace sonore de votre jeu, sans que ça se transforme en tablature — juste un fichier audio à réécouter ou à envoyer.

Nommez le fichier, choisissez le micro (système par défaut), ⏺ puis ⏹ : un lecteur apparaît, ⬇ télécharge, 🗑 Effacer efface l'enregistrement. Format webm/opus mono (≈ 1 Mo/min), lisible partout.

🎯 Cas pratique — Lancez la lecture en boucle d'un exercice, démarrez l'enregistrement, jouez par-dessus deux ou trois fois, arrêtez, puis réécoutez-vous en comparant à l'original : un excellent moyen de repérer ses propres défauts sans professeur à côté.

10 bis. Exercices d'après une vidéo 🎯 (bêta)

Le module inverse du précédent : plutôt que de partir d'une gamme pour générer un exercice, vous partez d'un backing track et l'appli propose les positions à travailler par-dessus.

Choisissez un de vos morceaux dans la liste déroulante (vos vidéos d'abord, puis la bibliothèque) — tonalité, mode, style et tempo se remplissent seuls et la vidéo s'affiche. Dès que vous touchez Tonalité ou Mode, la liste se réduit aux backing tracks de cette tonalité dans ce mode et son libellé affiche le compte ; ✕ Tout afficher revient à la liste complète. Ou, pour une vidéo quelconque, collez son lien YouTube et indiquez à la main sa tonalité, son mode, son style et son tempo ; l'appli propose alors deux de vos backing tracks correspondants.

Pour chaque position listée (harpe + gamme), un bouton charge l'harmonica et génère aussitôt un exercice dans cette position et cette tonalité. Choisir un backing track pré-règle le générateur 🎼 sur la première position, en 1 mesure.

11. Reconnaissance de notes 🎤 (bêta)

Le module le plus polyvalent des outils micro de l'appli : il sert aussi bien à vérifier votre justesse en direct qu'à transcrire automatiquement une mélodie que vous jouez, sans rien avoir préparé au préalable.

Écoute simple

🎤 Démarrer l'écoute, jouez une note tenue : l'appli affiche la note, le trou en tablature (couleur de sa technique, selon la tonalité sélectionnée) et votre justesse (±50 cents).

Écrire les notes dans la tablature en direct

« Écrire les notes dans la tablature » : transcription automatique avec la valeur rythmique réelle, mesurée d'attaque à attaque — une noire détachée reste une noire (trou d'articulation absorbé sous ~40 % de l'intervalle ; au-delà, vrai silence noté ; au-delà de 4 temps, respiration, rien). Dernière note relâchée tôt : arrondie à la valeur pleine supérieure. En fin d'écoute, le rythme est recalé automatiquement : tempo réel estimé, durées requantifiées, Tempo réglé. Métronome optionnel calé sur la grille. Un seul Ctrl+Z annule la session.

🎯 Cas pratique — Une mélodie vous trotte dans la tête sans rien d'écrit : cochez « Écrire les notes dans la tablature », décochez le Métronome si vous voulez jouer totalement librement, cliquez « 🎤 Démarrer l'écoute » et jouez. À l'arrêt, votre mélodie est déjà dans « Ma tablature », prête à être corrigée si besoin. Ça marche aussi par-dessus un backing track externe (YouTube, CD...) : décochez simplement le métronome pour ne pas qu'il se superpose au son du morceau.

Autres usages : vérifier un bend sur la jauge, confirmer un overblow, relever un riff qui s'écrit tout seul.

📈 Tracé du jeu en direct

Se déplie avec l'accordeur (pliable au clic sur son titre, 🗑 pour effacer). En haut, la portée (clé de sol) : chaque note posée à l'instant exact où elle a été jouée, alignée avec le graphe ; un clic sur le tracé (portée ou courbe) envoie la lecture de ce point dans l'accordeur (aiguille, note, tablature, fréquence, cents). En bas, le graphe défilant (8 s) : votre hauteur en pointillés, colorée comme le cadran — vert à ±5 cents, orange jusqu'à ±15, rouge au-delà. Les lignes horizontales colorées sont vos notes cibles (tablature en marge). L'échelle verticale est fixe : l'écartement des lignes reste constant, le cadre se recentre simplement sur la note jouée.

Navigation : clic = focus, ←/→ ±1 s (Maj : 5 s), molette, cliquer-glisser ; le défilement se fige au survol (badge ⏸), curseur vertical avec lecture précise (tablature, note, cents) ; Fin/Échap reviennent au direct. Le bouton ⏸ Figer stoppe le défilement de façon stable pour examiner la courbe sans garder la souris dessus ; ▶ Reprendre revient au direct. ~5 minutes d'historique.

🎚 Accordeur chromatique

Cadran ±50 cents : zone verte ±5 (juste), orange jusqu'à ±15, rouge au-delà. Aiguille lissée, pastille de note qui prend la couleur de la zone visée (verte/orange), tablature équivalente, fréquence. Le mot JUSTE ✓ n'apparaît que dans la zone verte. À l'arrêt, l'affichage se fige (🗑 pour remettre à zéro) et le module se replie avec le tracé. Borné à la tessiture de l'harmonica sélectionné.

🎯 Mode entraînement : utile pour travailler une altération précise. Cochez le mode et choisissez une note cible dans la liste — uniquement les altérations, overblows et overdraws (les notes à travailler). L'aiguille continue d'indiquer la note la plus proche (elle ne se bloque jamais en butée), tandis que le verdict en toutes lettres se mesure par rapport à la cible : « PAS ASSEZ BAS ↓ », « TROP HAUT ↓ », et « JUSTE ✓ » quand vous l'atteignez. Le verdict n'existe qu'en mode entraînement, et « JUSTE » suppose aussi l'aiguille dans la zone verte.

Calibrage du La (440 Hz, ▲▼, 415–466) : beaucoup d'harmonicas sont à 442–443 Hz. Réglage global et mémorisé : accordeur, reconnaissance et lecture au même diapason. Calibrez d'abord le La.

🎯 Jouer la tablature — travail validé

La note attendue clignote en bleu ; jouez-la au micro à votre rythme : juste → vert, suivante ; fausse → rouge, on rejoue. Bilan final : notes validées, fausses notes, justesse moyenne en cents. Fonctionne avec toute tablature — combiné au générateur : un nouvel exercice corrigé à chaque session.

Limites de la bêta

• Une note à la fois (pas d'accords ni d'octaves splittées).
• Notes franches ; tenue minimale adaptée au tempo ; validation à ±40 cents (un bend trop approximatif n'est pas transcrit).
• Deux fois la même note : détachez-les nettement. Les silences entre notes ne sont pas transcrits.
• Réglez la tonalité de l'appli sur celle de votre harmonica ; environnement calme conseillé.

11 bis. Swing-mètre 🎵 (bêta)

Le Swing-mètre mesure votre ratio de swing au micro pendant que vous jouez des croches : 50 % = binaire (droit), 66,7 % = ternaire (swing). Il se fonde sur les intervalles entre vos attaques, ce qui le rend insensible à la latence audio — pas besoin de calibrer quoi que ce soit avant de l'utiliser.

Une jauge et un verdict en clair — PLACEMENT OK pour une cible droite, SWING OK pour une cible triolet — indiquent en direct si vous êtes dans la cible, et le message reste affiché quand vous vous arrêtez. Choisissez la cible (Droit 50 % ou Triolet 66,7 %), réglez le tempo (synchronisé avec la barre d'outils), et laissez éventuellement le module générer un exercice de croches (2, 4, 6 ou 8) dans la gamme choisie — ou « libre » pour jouer ce que vous voulez. 🗑 remet le module à zéro.

12. Exports

Quatre formats, chacun pour un usage différent.

Export	Contenu	Usage
.json 💾	Tout : notes, durées, tempo, tonalité, modes	Sauvegarde fiable, échange, archivage
.mid 🎹	Notes et durées, son harmonica GM	MuseScore, DAW, backing tracks
.xml	Partition exacte : mesures pleines, liaisons, triolets, pointées — et symboles d'accords au-dessus de la portée si « Ma progression » contient une grille	MuseScore, Guitar Pro, Sibelius
🖨	Tablature 12 notes/ligne, tonalité, tempo, date, logo	Supports de cours, PDF

🎯 Cas pratique — Vous voulez qu'un élève retravaille chez lui exactement la même version que celle vue en cours, modifiable : exportez en .json. Vous voulez juste qu'il l'écoute sur son téléphone ou dans une app de musique : exportez en .mid. Vous voulez lui donner une vraie partition à lire : exportez en .xml et ouvrez-le dans MuseScore.

13. Questions fréquentes

• Pas de son au premier clic (iPhone/iPad) : les navigateurs débloquent l'audio au premier geste — cliquez une note.
• Changer de tonalité change mes notes ? La tablature ne change jamais ; seuls les noms et la hauteur suivent — comme changer d'harmonica.
• Session disparue : la sauvegarde est propre à ce navigateur (navigation privée et nettoyage l'effacent) — exportez en .json pour durer.
• Hors connexion ? Oui, entièrement : fichier autonome.
• MIDI importé incomplet : les notes injouables dans la tonalité choisie sont listées ; l'appli suggère la meilleure tonalité.
• Overblows refusés à l'import : seuls les overblows 1, 4, 5, 6 et overdraws 7, 9, 10 existent sur un Richter standard.
• « Hors harmonica » : la note détectée n'existe pas dans la tonalité sélectionnée — vérifiez le réglage.
• ⟳ vs boucle partielle : ⟳ répète ce qui est joué ; avec une plage (Maj+clic), uniquement le passage.

14. Signes d'effets et export texte

✨ Signes d'effets sur une note

Dans l'éditeur de note (double-clic sur une note), vous pouvez ajouter des signes d'effets qui n'ont aucune incidence sur le rythme ou la durée : ils ne servent qu'à noter une intention de jeu.

Choisissez d'abord la Position (Avant ou Après la note), puis cliquez le ou les Signes voulus. Une même note peut porter plusieurs effets, avant et/ou après ; chacun reste indépendant.

Signe	Effet
/	Attaque par en dessous (léger bend d'attaque)
\	Note « pleureuse » : léger bend en fin de note
vib	Vibrato
Wa	Effet « whawha » avec les mains
DS	Double stop (deux notes ensemble)
TBS	Tongue blocking « slapping »
TBO	Tongue blocking « à l'octave »
→	Glissando vers la note suivante
↔	Trille entre deux notes

Le glissando et la trille ne sont pas reproduits par le son de l'appli. Les signes apparaissent dans la tablature (en orange, autour de la note).

À l'export : en texte (.txt), chaque signe est un élément séparé (ex. DS TBS +4 vib Wa) ; en MusicXML, chaque effet devient un lyric indépendant affiché sous la note dans MuseScore.

📝 Export texte (.txt)

Le bouton TXT (groupe Fichier) télécharge la tablature en texte brut, avec les signes d'effets, sous le nom de la tablature.

Web app to create, listen to and work on tabs for the 10-hole diatonic harmonica. A single file, no installation, no connection needed: open harmonica-trainer.html in your browser. The interface is available in seven languages (flags in the app's footer, choice remembered — this manual follows the same setting).

💡 This manual is organized module by module, in the order they appear in the app. Each section explains what the module is for, how to use it, and offers at least one practical example to get you started right away.

1. First steps

At the top of the page, a scrolling banner showcases content from apprendrelharmonica.com; it pauses on hover, a click opens the page. The site logo, at the bottom of the page, also signs tab printouts.

Four reflexes to know from the start

• Clicking a note plays and writes at the same time. Each click on the virtual harmonica plays the note and adds it to the tab — no need to look for an "add" button.
• ▶ (or Space) plays what's written. Empty tab? The "Try: …" button offers a one-bar blues lick, different each time it's shown.
• 💾 Nothing to save by hand. The app auto-saves in the browser: close it, come back tomorrow, your session is restored as is.
• 📂 Modules fold and unfold with a click on their title, so only what you need stays on screen. The harmonica diagram and "My tab" always stay open.

🎯 Practical example — You open the app for the first time: click a few holes on the virtual harmonica to hear the sound, press Space to hear what you just composed, then close the tab without saving anything. Reopen the app: your little melody is still there.

1 bis. Custom layout 🔀

By default, modules stack in a standard order. If you mainly use two or three tools (say, the melody generator and the rhythm workshop), you can move them closer together to avoid scrolling every time.

• Drag each card by its handle ⠿: it snaps to the page's columns.
• The "Layout" bar saves several named layouts and recalls them from a menu.
• ↺ returns to the original layout; 💾 exports your layouts to a re-importable file.

Everything is kept in the browser, specific to this device — if you switch computers, export your layout to find it again elsewhere.

2. Notation

The app's tab notation reads like a classic paper tab, with a few extra symbols for bends and overnotes.

Notation	Meaning
+4 / -4	Blow / draw in hole 4
-3', -3'', -3'''	Draw bend of 1, 2, 3 semitones
+8'	Blow bend (holes 8–10)
+6° / -7°	Overblow / overdraw
z	Rest (for text import)

The same color code recurs everywhere in the app — in the tab, on the virtual harmonica, in the live playing trace: blow · draw · bend · overblow · overdraw. Once this code sinks in, you read the color before the number.

3. The virtual harmonica

This is the heart of the app: a full harmonica, in the key shown above the diagram. Each column lines up, top to bottom: overblows, blow bends, blow note, draw note, draw bends, overdraws.

• Clicking a hole number adds the blow note of the matching hole.
• Hovering a column lights it up, to spot every technique available on that hole at a glance.
• The note names displayed follow the chosen key and octave — change the key, the names change, but the physical location of the sounds stays the same.

3 bis. Keyfinder 🔑

The Keyfinder answers a question every harmonica player faces sooner or later: "which harmonica do I pick for this song?" — or the reverse, "what can I play with the harmonica I already have?". It also shows the essential notes of the chosen position (root, thirds, fifth, sevenths) and where to play them on the harmonica.

Practical example 1: I start from the song's key

1. "Find the Harmonica" tab: pick the song's key (e.g. C).
2. Pick the position you want to play in (e.g. 2nd position).
3. The Keyfinder tells you which harmonica to pick and shows the key notes: root, major third, minor third, perfect fifth, minor seventh, major seventh — with their location on the harmonica.

Example: for a song in C played in second position, the Keyfinder recommends an F harmonica and immediately shows where the root, thirds, fifth and sevenths sit.

Practical example 2: I start from the harmonica I have

1. "Find the Key" tab: select your harmonica's key (e.g. E) — several harmonicas can be selected at once.
2. The tool shows the 12 playable keys with their matching positions.
3. Pick the position that fits the song's style, then locate the essential notes on the instrument.

Example: with a harmonica tuned in E, you play in E in 1st position, in B in 2nd position, in F# in 3rd position, and so on.

The highlighted notes — and why they matter

Note	Role
Root	Main reference note of the key
Major third	Gives the major color
Minor third	Gives the minor / blues color
Perfect fifth	Stable anchor note
Minor seventh	Blues / dominant color
Major seventh	Jazz / major color

In short: whether you start from the song's key or from the instrument, the Keyfinder guides you in a few clicks — you save time and play more accurately, faster.

4. The toolbar

The toolbar groups five families of commands. They come up constantly, so it's worth knowing them by heart early on.

🎵 Playback

• ▶/⏹ (Space): plays or stops the tab. ⏸ Pause (key P) pauses and remembers the current note — a second click (or P) resumes exactly there, while ⏹ stops outright and forgets the position.
• Start anywhere: click a note in the tab, ▶ starts from there (with no selection, playback starts from the beginning). Resuming mid-song skips the count-in and lead-in, and syncs the chord grid to the bar being played.
• ⟳ loops without a gap — the ×N field next to it sets a loop count (plays N times then stops; empty = infinite).
• 🎹 Block chords: next to the loop-count field, plays the chord-builder chords as one hit instead of arpeggios.
• ⏱0 Count-in: the metronome only beats during the pickup (bar 0), then goes silent for the rest of playback.
• Tempo 40–240, 🔊 Volume, ⏱ Metronome (downbeat depending on time signature: every 4 or 3 beats).
• TAP: click in rhythm (mouse) to set the tempo — average of the last clicks, applied to the overall tempo; RESET clears the clicks.

🎯 Practical example — You don't know the exact tempo of a song you want to work on: tap it (TAP) while listening to the original on your phone, the app derives the BPM and sets it directly.

During playback, the current note lights up in the tab and on the harmonica — a useful visual anchor to follow along without getting lost.

🏋️ Exercises

• 🎼 Generator for melodies (detailed in section 7).
• 🎶 Chord builder and ♬ Chord progressions (detailed in section 7 bis).
• 🧩 Song structure (detailed in section 7 ter).
• 🎙︎ Mic sensor (test) (detailed in section 8 quinquies) and 👂 Ear transcription (detailed in section 8 ter).
• 🔀 Shuffle the tab (once per click, Ctrl+Z to undo).
• ⇅ ascending then descending.
• SWING (ternary eighths: any attack landing on the "and" of the beat is delayed to two-thirds of the beat).
• 🎲 Random durations.
• +BPM progressive tempo (detailed in section 6).

These modes stack: you can, for instance, shuffle a melody and turn on swing and progressive tempo, all at once.

🎼 Tab (display)

• TAB / Notes / Do Re Mi: switches between the tab, Anglo-Saxon names (C4, Bb3…) or solfège names (Do4, Sib3…).
• Key (12 harmonicas): names and pitch adapt, the tab stays identical — this is a display change, not a content change.
• ▾8 / ▴8: transposes the selected notes by an octave (or the whole tab if nothing is selected; matching holes). If a note has no equivalent, it doesn't move and the app lists it. Selection: Shift+click a range, Ctrl/Cmd+click a single note, ⇄ Invert swaps selected and unselected.
• 1·3b·5 Degrees: shows each note's degree in the reference scale underneath it — the neighboring 🎼 button opens the generator to pick the scale, and the display lines up on it automatically. Notes outside the scale are greyed out; chord-builder arpeggios show the chord's intervals (1, 3b, 5, 7b…) instead.

📁 File

• 📚 Library: named tabs, stored in this browser — load, rename, delete; ⬇ Export all as a re-importable .json. Windows can be dragged around with the mouse.
• 💾 / 📂: complete .json file; 📂 also opens .mid files (converted to tab: quantized durations, rebuilt rests, tempo applied, unplayable notes listed, best key suggested) and .xml/.musicxml files.
• 📋 Import a text tab (detailed in section 5) · 🎹 MIDI (GM Harmonica instrument) · XML MusicXML: exact score — figures and durations always match, full bars, written ties; MuseScore doesn't rewrite anything. · TXT: plain-text export with the effects (bends, overnotes…), handy for pasting into a message.
• 🖨 Print: clean layout, white background, logo, 12 notes per line (PDF via "Print to PDF").

🎯 Practical example — You're preparing a lesson handout for a student: build the tab, click 🖨 Print, then "Print to PDF" from the browser's dialog. The PDF keeps your logo and stays readable even printed in black and white.

✏️ Editing & ♩ Durations

↶/↷ (Ctrl+Z / Ctrl+Y), 🗑 clear all, ? help, ! resets the display of open windows (useful if a window is stuck or positioned off-screen).

Nine rhythmic values are available: whole, half, quarter, eighth, sixteenth, triplet, dot (+50%), and three rests (1, ½, ¼ beat). The chosen duration applies to the next notes you enter; on an existing selection, it changes it directly.

Notes straddling a bar: split for display and linked by ‿ (dotted linked portion) — the note remains a single note, played in one breath; MusicXML export writes the tie.

‿ Tie: links the selected notes — the ‿ sign is shown between them. Two tied notes of the same pitch flow into one breath, with no re-attack, and MusicXML export writes the phrasing slur. The ‿ button in the note editor (double-click on a note) does the same, note by note.

5. Importing a text tab 📋

Handy for recovering a tab found on a forum, in a book, or sent by a student as a text message — without retyping everything by hand.

Paste your tabs (notes separated by spaces; commas, line breaks, | accepted): +4 -4 +5 -5 +6 -6' -6 z +6 -5 +5 -4 +4. The + is optional, z inserts a rest, invalid items are ignored and listed, the import is added after what already exists.

6. Working on a passage

Two tools for progressing on a specific spot without having to replay the whole piece each time.

Partial loop

Click the first note, Shift+click the last one: the range is highlighted, ▶ plays only it, ⟳ loops it. A click without Shift exits it. The range also lets you change all durations or delete at once.

🎯 Practical example — A two-bar phrase gives you trouble in a longer solo: select it (Shift+click), turn on ⟳, and let it loop while you work on it, without ever replaying the rest of the piece.

Progressive tempo (+BPM)

Set the step (1–20 BPM per pass) and the maximum: each time the loop cycles, the tempo goes up and is displayed. Also works on a selected range: the tempo goes up on each pass of the selection, including when the 🎹 accompaniment is active.

Classic example: 4 tricky notes, starting at 60 BPM, step of 4, maximum 120 — you start slowly and the app speeds up automatically after every successful pass, without you having to touch the tempo yourself.

7. Melody generator 🎼

The generator composes coherent melodies, not just random note sequences: scales are grouped by position — major & major pentatonic (1st); blues, mixolydian, pentatonic (2nd); minor pentatonic, blues, dorian (3rd); natural minor, minor pentatonic (4th); phrygian, minor pentatonic, natural minor with bends (5th); lydian, major with bends (12th). Four levels (Beginner, holes 4–8 → Expert with overblows), over 1, 2 or 4 bars. The melody always ends on the root, unless you check "Don't end on the root".

The window stays open while you work: keep regenerating (🎼), listen, adjust, without losing control of the rest of the app. Close it with ✕ or Cancel; Ctrl+Z restores the previous tab if the result doesn't suit you.

My settings — right under "Surprise me", save the window's whole configuration under a name and recall it in one click: scale, level, range, length, phrasing, time signature, notes per bar, checked durations, progression following and both injection sliders. 💾 saves (reusing an existing name replaces that setting instead of creating a duplicate), 🗑 deletes the selected setting, ⬇ exports all your settings as .json and 📂 imports them back. The settings of your last generation are also remembered on their own: next time you launch the app, the window opens just as you left it.

One click, to move fast

At the top of the generator, the Surprise me button sets the menus for you (you see them move) and generates right away: one click, one melody. Click again for a new draw. The detailed settings stay below for anyone who wants to pick the scale, position and level precisely.

🎯 Practical example — You have 5 minutes before a lesson and want a quick example to show a beginner: click "Surprise me" a few times in a row until you get something simple and singable, without touching any setting.

Reading and playing what was just generated

The notation reminder "📖 How to read the tab?" (blow, draw, bends, color code) is available in the ? help under the Editing menu. As soon as notes exist, a row of icons appears under the tab: ▶ (red) plays the tab, ⏹ (green) stops, the mic icon (blue) launches 🎯 mode (you play on the mic, the app validates note by note) and + adds or inserts a note — after the selected note, otherwise at the end — opening the editor; click again to add more, bar lines recalculate.

Phrasing: giving the melody a shape

Beyond a "note-by-note" melody, you can impose a phrasing type: Question – Answer (two parts that answer each other), Arch (rise then fall), Valley (fall then rise), Wave (successive undulations), Continuous rise or Continuous fall (the phrase crosses the register in a single direction), Light jazz (chromatic approaches to certain notes) or Full bebop (enclosures, eighths). "None" leaves the app free.

Rise and Fall set an overall direction — this is not a scale: the line travels from low to high (or the reverse) while allowing small steps back, which keeps it musical. The two lowest → highest note menus decide which part of the harmonica is crossed. Since the last note lands on the tonic, it may step back a little: tick "Don't end on the tonic" for a clean direction all the way through.

Valley is the arch upside down: the phrase starts high, digs down, then climbs back. Wave strings direction changes together — one undulation every two bars — the phrasing that drills turnarounds, where many students get carried away in a single direction.

AAB blues — the sung form, over your chart

The AAB blues phrasing writes a blues chorus the way it is sung: phrase A fills bars 1 to 4, A' repeats it over bars 5 to 8 without moving while the chart goes to the IV — that mismatch is where the tension comes from — then B answers and concludes over bars 9 to 12. Each group of four ends on a breath: the phrase lands on one accent in bar 4 and bar 8, then makes room, the way a singer lets the instrument answer. B is denser than the statement, and the closing notes step down to the tonic.

This phrasing needs a 12-bar chart and "Follow My progression" ticked: the form itself requires it. If either is missing, the app tells you instead of generating something else. Only one note is retouched in A': a major 7th landing on a dominant chord (the E over an F7, in C) drops a half step — blue notes are kept as they are.

🎯 Practical example — Load the 12-bar blues preset from "Chord progressions", send it to "My progression", tick "Follow My progression", pick AAB blues: you get a full, structured chorus for a student to read or transcribe.

Question – Answer now works over 2 bars as well as 4: the second bar takes up the rhythm and the opening of the first, and the question hangs on the dominant. A short, square lick without going through 4 bars.

🎯 Practical example — Working on range with a student: Continuous fall, 4 bars, Intermediate level, range narrowed to holes 4 to 8 — they get a phrase that walks back down the whole chosen register without being a plain descending scale.

Meter, durations and range

Pick the time signature — 4/4, 3/4 (waltz), 6/8 or 12/8: the whole app follows (bar lines, metronome, MIDI and MusicXML exports). Length: 1, 2 or 4 bars.

Restrict the note durations used by checking only the values you want — whole, half, quarter, dotted quarter, eighth, sixteenth, triplet or quarter-note triplet.

Example: whole note only for one note per bar, or half note only for two notes per bar — ideal for a very simple phrasing or a first level. Everything checked = free.

If the requested number of notes isn't enough to fill the bar — 4 eighths in 4/4, for instance — the app fills in with rests rather than refusing: they're spread through the bar, not piled at the end, so the melody can breathe.

Two menus lowest note → highest note restrict the generated melody to the portion of the harmonica you choose, among the notes available for the selected scale and level — handy for staying on a specific zone of the instrument. They repopulate automatically when the scale or level changes.

Number of notes per bar. Set a maximum: at 6, the app uses up to 6 notes, not necessarily 6. Check "exactly this number" to force the exact count.

Generating over a chord progression

If you check "Follow My progression", the chosen scale applies to the chords in your progression (the "My progression" module), regardless of their key — good for testing unexpected sounds (watch out for dissonances). Each chord keeps its own duration (full bar, half bar…): the generated melody adjusts to it automatically, with no extra setting needed. The injection sliders then add a percentage of out-of-scale notes and rests (end-of-phrase breaths).

The "Notes used over the progression" menu arbitrates between scale and chords. Free blends both, driven by injection — the original behaviour, which can let out-of-scale notes through (a blues chord's major third, for instance). Strict scale and Common notes only both stay strictly within the chosen scale, with no exception — their difference lies in how the note gets picked, not in what's available. In Strict scale, the current chord has no influence at all: the melody follows the scale regardless of it. In Common notes only, whenever a scale note also happens to be a chord tone, the app has the option to favour it — mainly on downbeats — without this being systematic or mandatory: it's one possible choice among others, not a constraint. Both options disable the injection slider, which no longer serves a purpose.

🎯 Practical example — Blues scale, 2nd position, over a blues chart: in Free mode, notes from the chord's major third creep into the melody; switch to Strict scale to stay in the blues colour from start to finish, whatever the chord.

My modes 🧬: creating your own scales

Collapsible module for creating your own modes — name, position (1st to 12th), degrees checked among the 12 semitones — remembered in the browser and available (★) in the scale selectors of the generator, the 1·3b·5 degrees, and the Swing meter. ✎ edits a mode, 🗑 deletes it.

In the generator window, next to the scale selector: 🗑 removes the shown scale from the list (choice remembered), ↺ shows all scales again; ⬇ exports your modes to a .json file and 📂 re-imports them.

7 bis. Chords & progressions 🎶

Three complementary modules for working with chords rather than single notes: build one chord in isolation, chain a ready-made grid, and play/export the current grid.

🎶 Chord builder

Exercises group: choose the root, the quality (from triads to 13ths), any alterations/tensions (b5, #5, b9, #9, #11, b13 — active depending on quality), an optional bass note (slash chord, e.g. C/E) and the arpeggio shape (ascending, or ascending-descending).

The Meter selector (4/4, 3/4, 6/8, 12/8) sets the time signature before building — it's shared with the melody generator and the progressions; if the tab already has notes, a confirmation is asked, since bar lines get recut. Pick the chord's duration directly, in beats — 1, 2 or 4 in 4/4; 1 or 3 in 3/4; 1½ or 3 in 6/8; 3 or 6 in 12/8 — the same selector as in "Chord progressions" and "Song structure".

Confirm inserts the chord as an arpeggio after the tab — lowest playable position, overblows/overdraws included — and the window stays open to chain several chords in a row; Delete last removes the last one added. The chord's name appears as a badge at the start of its line, and 🔀 and 🎲 act inside each chord without breaking its bars. During playback, 🎹 (Playback group) switches to block chords: each chord sounds as a block, with a piano sound, instead of the arpeggio.

♬ Chord progressions (presets)

Draggable window in the Exercises group: about twenty classic progressions (pop, jazz, 12-bar blues, minor cadences…), transposable across the 12 keys and in major/minor — check "Key signature only" to change only the displayed key signature without transposing the chords.

The progression is editable before insertion: click a chord to change its root, quality, tensions, bass note, and its own duration (1, 2 or 4 beats depending on the meter) — each chord keeps its duration, so you can mix a full bar and two half bars in the same grid. The window's Meter selector sets the time signature, from which the duration of a full bar follows: 4 beats in 4/4, 3 in 3/4, 6 in 12/8. ◀ ▶ move a chord, ✕ removes it, + adds one. Display toggle Names / Degrees (roman numerals).

💾 saves your progression to the preset list (★, 🗑 to delete it), ⬇ exports your progressions to .json and 📂 re-imports them. → My progression sends the built grid to the module below, without going through the tab. Your saved song structures (🧩 module, section 7 ter) also appear in this list, prefixed 🧩: selecting them flattens the whole structure into the grid, with each part's durations and keys kept.

♬ My progression

This module displays the received grid: each chip shows the chord's name, with its duration in parentheses if it differs from a full bar (e.g. G7 (2)). Durations are recognized and honored automatically, whatever their origin — presets, chord builder (via the tab), or sending the tab to this module — with no manual setting needed.

• ♬ Accompany playback: the grid plays on piano during tab playback, each chord at its real position and duration.
• 🪟 Current chord: opens a small draggable window, always on top, showing the current chord in large type along with the next one — handy for following the grid without taking your eyes off your harmonica.
• → Tab: converts the grid into arpeggios in the tab, one group per chord, each on its own duration.
• 💾 🎹 XML TXT: export the grid alone — JSON, MIDI (block chords), MusicXML (chords and symbols written above the staff, never as notes), text (chord names).
• 🗑: clears the progression.

🎯 Practical example — You're teaching a blues grid to a student over video call: send a 12-bar blues preset to "My progression", open 🪟 Current chord, and keep the window visible while the student plays over it — they always see where they are, without having to read the whole grid.

In the header of "My tab", the → My progression button does the reverse: it reads the chord arpeggios present in the tab (built via 🎶) and rebuilds the grid in "My progression", durations included. The 💾 🎹 XML TXT icons right next to it are shortcuts to the full melody's exports — the same ones as in the main toolbar.

7 ter. Song structure 🧩

This module is for building a song's entire chord grid, part by part, rather than a single uniform grid — useful as soon as a song has a verse and a chorus with different chords.

Draggable window (🧩 button, Exercises group): Intro, Verse, Chorus, Bridge, Solo, Break, Transition, Outro, or a Custom part — each type has its own color, echoed as a border on the card. Add a part creates a card and selects it right away; its name is editable, its key and mode are set in the editor below and transpose all its chords at once.

Building a part's grid

Each part's grid is built with the same chord builder as 🎶 (section 7 bis): + opens the builder, Confirm adds the chord to the part and the window stays open to chain more. Then, clicking a chord chip reopens the builder pre-filled with that chord to edit it (root, quality, duration…) without touching the rest of the grid; the small ✕ to the right of the chip removes it; and the discreet + marks between chips insert a forgotten chord at that exact spot — successive insertions chained in the order you type them.

Reorganizing and managing parts

• ◀ ▶ move a part one step, or grab its handle ⠿ to drag and drop it wherever you want (a blue border shows insertion before or after the hovered row).
• ⧉ duplicates a part, 📋 copies it and 📥 Paste adds it at the end of the structure, 🗑 deletes it (confirmation asked).
• ↺ Clear all parts in one click (confirmation asked): your saved structures aren't affected.

💾 Save a structure under a name: it joins the dropdown list (reloading a structure asks for confirmation if another one is already in progress), 🗑 right next to it removes it from the list. ⬇ exports all your saved structures to .json, 📂 re-imports them. Your saved structures also appear, prefixed 🧩, in the "Chord progressions" list (section 7 bis): selecting them there flattens the whole grid, with each part's durations and keys kept.

Generating a melody on a specific part

🎲 Generate a melody on a part (if it contains chords): the melody generator 🎼 composes over its grid, in its key, with the generator's current settings (level, scale, phrasing…), and inserts the result exactly where that part is in "My tab" — the rest of the tab isn't touched; regenerating a part replaces it, it doesn't add to it.

🎯 Practical example — You're building a song with Intro / Verse / Chorus / Solo: generate a calm melody over the Intro, then a more technical melody just for the Solo, without ever touching the other two parts.

→ My progression flattens the whole structure, in part order, to the section 7 bis module — same path as the presets.

Dedicated exports: TXT produces a printable grid, named parts, bars aligned in columns; XML produces a MusicXML file where each part starts on a new line (part marker and key signature), with chord symbols in international notation above the staff — the staff stays empty (rests hidden) if "My tab" is empty, or carries its melody if it has one.

8. Fine editing

Once a melody is in place — generated, imported, or entered note by note — here's how to fine-tune it precisely.

Overview of the toolbar

From top to bottom, here's what each control in the header does:

• ⠿ moves the module within the page.
• Ma tablature: the module's title; 18 elements · 4 bars: note/rest and bar counter, updated live.
• ▼8 / ▲8: transposes the whole selection down/up one octave (the whole tab if nothing is selected).
• Anacrouse: declares the first bar as a pickup.
• ▶ red icon, top right: opens the module's tutorial video.
• 💡 tip banner: reminds you to double-click a note to edit it.
• ▶ / ■ / 🎤 / +: play, stop, mic mode, add a note.
• ⇄ Reverse: inverts the selection (draw ⇄ blow).
• ✕ Note: deletes the last note entered (and other actions on the selected note).
• 🗑 All: deletes the whole tab.
• ⇅ Follow: toggles auto-scrolling during playback.
• ♫ Arpeggios: toggles arpeggio mode.
• Mute: mutes playback sound.
• → My progression: switches to the linked chord-progression module.
• 💾 / 🎹 / XML / TXT: saves the tab, exports to MIDI, to MusicXML, to text.
• ⚠ Complete the bar: flags an incomplete bar to fix.
• Bar number (left column): marks the bar in the grid.
• Note cell: hole, duration and hole number — double-click to edit it (pitch, duration, rest).

Selection and deletion

Click = selection (new notes are inserted after it); ⌫/Delete removes; ←/→ moves the selection. Automatic numbered bar lines (4/4 or 3/4 depending on the signature chosen in the generator); the counter shows elements and bars.

The note editor (double-click)

Double-click on a note opens a full editor: change the hole (1–10), the technique (only notes actually playable on that hole are offered, with their color), the duration and dot, convert the note to a rest (and back), or delete it.

Completing, duplicating, clearing a bar

⚠ Complete the bar: when the last bar is incomplete, this button appears above the tab. The app suggests three possible endings within the current scale — pick one, the notes are added and the bar comes out right.

Duplicating or clearing a bar. Each tab line corresponds to a bar. The two small buttons at the end of the line let you duplicate it (a copy is inserted right after) or clear it with one click.

Transposing by octave

Octaves ±8. If the pitches allow it, ▾8 / ▴8 lower or raise the selection (or the whole tab) by one or two octaves; a note with no equivalent isn't transposed.

Following chords during playback

⇅ Follow and 🎵 Arpeggios. When a progression is present in "My progression", its chord arpeggios can be outlined in green during playback: ⇅ Follow scrolls the tab onto them (turn it off to scroll yourself), 🎵 Arpeggios makes them audible along with their chord (turn it off to keep only the piano).

Where do the tab's notes come from?

The tab shows notes coming from: your clicks on the diagram, the mic (Pitch recognition module or Mic sensor), the melody generator, the library, the "Tab" button in "My progression", the module's + button, and the "Try" button.

Key signature (for exports)

The key signature in exports is automatic: it follows the tonic of the generated melody according to its position, in major or minor — so a minor pentatonic in 3rd position on a C harmonica gives D minor (one flat), not the harmonica's own key signature. With no generated melody, it's the harmonica's major key. It appears in the first bar of the MusicXML (with the mode) and in the MIDI — MuseScore shows a clean score.

Pickup (anacrusis)

Enter your pickup at the start of the tab, including any lead-in rests — for example two rests then two eighths — and click Pickup in the module's header: the first bar becomes bar 0, marked with a dotted border. Click again to cancel. Its notes are edited like any others (duration, double-click, drag and drop). During playback, bar 0 plays only once at the start: the ⟳ loop only repeats the body, and "My progression"'s accompaniment only kicks in at bar 1. With the metronome on, the empty beats before the pickup are counted in — and without a pickup, you get a full bar of count-in at the start. MusicXML export writes a real pickup (shortened bar 0, leading rests removed); MIDI keeps the exact timing. A note straddling the bar line stays in the body.

8 bis. Ear training dictation 🎧 (beta)

Use this to train pure listening: the app plays something, you have to recognize it and play it back without seeing it written.

How it works

Below the tuner: choose 1 to 6 notes and the level — Beginner (holes 4–6), Intermediate (natural notes), Advanced (bends, no overnotes), Expert (everything included). 🎲 plays a singable phrase (intervals ≤ a fifth, no repetition), in the current key. ▶ Replay as often as you like; 🎤 Answer on mic: each correct note fills its box, a wrong one flashes red and counts as an error. Reveal shows the answer. Never writes to your tab.

Score, stats and badges

Each successful dictation gives a score = notes × level × 100, minus 20 per error and 5 per replay beyond the first. Below the module: dictations played, perfect runs, record, total and current streak (resettable with ↺). Seven badges to unlock — Bronze/Silver/Gold ear (10/50/100 dictations), Flawless and Perfect ear (5 and 10 perfect runs in a row), Virtuoso (a flawless Expert dictation), Breath master (over 1000 points). All kept in the browser, offline.

🎯 Practical example — 5 minutes before bed, with no harmonica handy to read a score from: launch a Beginner-level dictation, play on the mic on your bedside harmonica, and watch your perfect-run streak grow night after night.

8 ter. Ear transcription 👂 (beta)

Similar to Ear training dictation, but focused on scale and position rather than isolated notes — useful for getting your ear used to a specific scale color.

How it works

👂 button (Exercises group): the app plays a few notes from a scale/position of your choice (your ★ modes included) without showing them. Set the level and the number of notes (2–16), replay as much as you like, then rebuild the phrase in the window: 🎤 on the mic — each note played becomes a token — or by hand (syntax +4 -4 -3' +6°; click a token to remove it, ⌫ to clear all). Confirm shows the answer below, green/red note by note: what counts as correct is what sounds correct (-2 ≡ +3). Never touches your tab.

Points and badges

Score = correct notes × level × 100, −20 per error, −5 per replay beyond the first, counted at the first validation of the draw. One level every 1000 points; five badges (first flawless run, 10 and 50 transcriptions, 5 flawless in a row, flawless at Expert); reset with ↺. Kept in the browser, offline.

8 d. Rhythm workshop 🥁 (beta)

Trains rhythm independently from pitch accuracy — perfect for students who play in tune but "off" the beat, or the other way around.

How it works

🥁 button (Durations group): the app generates a one-bar 4/4 rhythm by level — up to ♪♬♬ and ♬♬♪, the ♬♪♬ syncopation, rests, triplets and big syncopation — and plays it with the metronome on the root note (tempo capped 60-100). After a one-bar count-in, reproduce it: 🎤 on the mic (a melody or a single note, with clearly detached attacks) or 👆 by tapping (spacebar or button). Figure-by-figure feedback (green/red), extra attacks flagged; latency is compensated automatically — only rhythmic placement counts.

Points and badges

On-time × level × 100, −20 per missed figure, −10 per extra attack, −5 per replay beyond the first; one level every 1000 points, twelve rewards, reset with ↺. They cover the number of rhythms played (1, 3, 10), the perfect runs (1, 3, 10), perfect runs in a row (2, 5), those achieved on the first listen (3), and those achieved at each level — Intermediate, Advanced and Expert, 3 each, never stacking from one level to the next. The answer mode does not count: mic and tapping are worth exactly the same. Kept in the browser, offline.

🎯 Practical example — A student tends to rush eighth notes: set the level to Beginner, have them tap (👆) rather than play on the mic at first, to isolate the rhythmic problem without pitch accuracy getting in the way.

8 quinquies. Mic sensor (test) 🎙︎

The 🎙︎? button (toolbar) is a check-first step before anything is written to the tab. Nothing changes until you validate.

🎤 Arm the sensor, start playback (▶) and play along: each detected attack is listed with the position played, the target slot, the note, the matching tab hole and the offset in milliseconds. The Grid (quarter, eighth or sixteenth note) sets the quantization precision aimed for.

Calibrating latency

Between the moment the sound leaves your harmonica and the moment the mic gets it to the app, there's always a small delay: latency. If left uncorrected, it throws off everything rhythm-related — the Rhythm workshop or the 🎯 "Play the tab" mode can judge a note "late" even though it was played right on time, and the automatic write-in via ✍ Write to the tab… places notes and durations slightly off. The Swing meter can also be thrown off a little, since it relies on the time gaps between your notes. As long as you're not using a timed exercise or the automatic write-in, latency doesn't matter at all.

⏱ Latency test (the simplest, do this first):

1. Click ⏱ Latency test.
2. After a short count-in, the metronome plays 8 clicks on its own, no melody.
3. Play one clean, detached note on each click — the hole doesn't matter, what counts is a clean sound, right on the beat.
4. Once the 8 clicks are done, the app compares each of your attacks to its matching click and computes the median offset.

The result is displayed (e.g. "8 attacks · median latency 42 ms") and the Latency (ms) field fills in automatically — nothing else to do. This setting is remembered app-wide.

⌁ Calibrate (to fine-tune, under real conditions):

1. 🎤 Arm the sensor, start a real playback (▶) and play normally along with it.
2. Each note played is added to the list, with its own offset.
3. Click ⌁ Calibrate: the app takes the median offset from this take and adds it to the latency already set.

Repeat this under different conditions (headphones or not, another mic, another room) to fine-tune it further.

Swing (the "and" position): set by hand, or deduced from what you just played with ◱ Measure the swing. Unrelated to latency — Grid and Swing only set the aimed quantization precision and the ternary feel.

Recording a melody or an improvisation as tab

The sensor only measures your attacks against the clock of the app's own ▶ playback: for it to capture anything, a playback must be running while you play — even if it only contains rests.

Case 1: playing solo, with the metronome

1. Choose your harmonica's key in the harmonica diagram.
2. Open the Mic sensor and arm it (🎤 Arm the sensor).
3. Fill "My tab" with empty bars (rests only), at the tempo you want — as many bars as needed.
4. Start playback ▶ of these silent bars: this is what runs the metronome and gives the sensor its time reference.
5. Play your melody along with it, following the click.
6. Click ✍ Write to the tab… (details below).

Case 2: playing along with a YouTube video

Same steps as case 1, with one extra constraint: at the playback step, start the YouTube video and the silent-bars playback at the same time, by hand, as close together as possible. You then play along with the video — the app's metronome now only serves to run the sensor's internal clock.

This manual sync works very well at slow tempos: a beat lasts longer, so a small sync offset is only a tiny fraction of the beat and the note still lands in the right slot. At fast tempos, the same offset weighs much more, and the risk of the note falling into the neighbouring slot increases.

✍ Write to the tab… opens "Review the take": a bar-by-bar comparison, ✓ keeps your take or ✕ keeps the original tab (shortcuts Keep all / Reject all). Nothing is written before Apply — and a single Ctrl+Z undoes it.

9. Keyboard shortcuts

Keys	Action
1–0	Blow note, holes 1 to 10
Shift+1–0	Draw note
Space	Play / Stop
P	Pause / Resume at current note
← / →	Previous / next selection
Delete	Delete the selection (or the last note)
Shift+click	Range selection
Ctrl+Z / Y	Undo / Redo

Works on AZERTY and QWERTY keyboards.

10. Audio recording 🎙 (beta)

To keep an audio trace of your playing, without it turning into a tab — just an audio file to listen back to or send.

Name the file, choose the mic (system default), ⏺ then ⏹: a player appears, ⬇ downloads, 🗑 Clear deletes the recording. Webm/opus mono format (≈ 1 MB/min), plays everywhere.

🎯 Practical example — Start looped playback of an exercise, start recording, play along two or three times, stop, then listen back and compare with the original: an excellent way to spot your own flaws without a teacher next to you.

10 bis. Exercises from a video 🎯 (beta)

The reverse of the previous module: instead of starting from a scale to generate an exercise, you start from a backing track and the app suggests the positions to work over it.

Pick one of your songs from the dropdown list (your videos first, then the library) — key, mode, style and tempo fill in on their own and the video shows up. As soon as you touch Key or Mode, the list narrows to backing tracks in that key and mode, and its label shows the count; ✕ Show all returns to the full list. Or, for any video, paste its YouTube link and enter its key, mode, style and tempo by hand; the app then suggests two of your matching backing tracks.

For each listed position (harp + scale), a button loads the harmonica and immediately generates an exercise in that position and key. Choosing a backing track pre-sets the 🎼 generator to the first position, over 1 bar.

11. Pitch recognition 🎤 (beta)

The most versatile of the app's mic-based tools: it's just as good for checking your pitch accuracy live as for automatically transcribing a melody you play, with nothing prepared beforehand.

Simple listening

🎤 Start listening, play a held note: the app shows the note, the tab hole (colored by its technique, based on the selected key) and your accuracy (±50 cents).

Writing notes to the tab live

"Write the notes to the tab": automatic transcription with the real rhythmic value, measured attack to attack — a detached quarter note stays a quarter note (articulation gap absorbed under ~40% of the interval; beyond that, a real rest is written; beyond 4 beats, a breath, nothing). Last note released early: rounded up to the next full value. At the end of listening, the rhythm is automatically recalibrated: real tempo estimated, durations requantized, Tempo set. Optional metronome locked to the grid. A single Ctrl+Z undoes the whole session.

🎯 Practical example — A melody is stuck in your head with nothing written: check "Write the notes to the tab", uncheck the Metronome if you want to play completely freely, click "🎤 Start listening" and play. When you stop, your melody is already in "My tab", ready to be corrected if needed. This also works over an external backing track (YouTube, CD...): just uncheck the metronome so it doesn't clash with the song's sound.

Other uses: checking a bend on the meter, confirming an overblow, transcribing a riff that writes itself.

📈 Live playing trace

Unfolds along with the tuner (foldable by clicking its title, 🗑 to clear). At the top, the staff (treble clef): each note placed at the exact instant it was played, aligned with the graph; clicking the trace (staff or curve) sends that point's reading to the tuner (needle, note, tab, frequency, cents). At the bottom, the scrolling graph (8 s): your pitch as a dotted line, colored like the dial — green at ±5 cents, orange up to ±15, red beyond. The colored horizontal lines are your target notes (tab in the margin). The vertical scale is fixed: line spacing stays constant, the frame just recenters on the note played.

Navigation: click = focus, ←/→ ±1 s (Shift: 5 s), scroll wheel, click and drag; scrolling freezes on hover (⏸ badge), vertical cursor with precise reading (tab, note, cents); End/Esc return to live. The ⏸ Freeze button stops scrolling steadily to examine the curve without keeping the mouse over it; ▶ Resume returns to live. ~5 minutes of history.

🎚 Chromatic tuner

±50 cent dial: green zone ±5 (in tune), orange up to ±15, red beyond. Smoothed needle, note tag that takes the color of the targeted zone (green/orange), matching tab, frequency. The word IN TUNE ✓ only appears in the green zone. When stopped, the display freezes (🗑 to reset) and the module folds along with the trace. Bounded to the range of the selected harmonica.

🎯 Training mode: useful for working on a specific bend. Check the mode and pick a target note from the list — only bends, overblows and overdraws (the notes worth practicing). The needle keeps pointing to the nearest note (it never gets stuck at the edge), while the spelled-out verdict is measured against the target: "NOT LOW ENOUGH ↓", "TOO HIGH ↓", and "IN TUNE ✓" when you reach it. The verdict only exists in training mode, and "IN TUNE" also requires the needle to be in the green zone.

A calibration (440 Hz, ▲▼, 415–466): many harmonicas are tuned to 442–443 Hz. Global, remembered setting: tuner, recognition and playback all use the same reference pitch. Calibrate A first.

🎯 Play the tab — validated practice

The expected note blinks blue; play it on the mic at your own pace: in tune → green, next note; wrong → red, try again. Final summary: notes validated, wrong notes, average accuracy in cents. Works with any tab — combined with the generator: a fresh, corrected exercise every session.

Beta limitations

• One note at a time (no chords or split octaves).
• Clean notes; minimum hold time adapted to tempo; validated at ±40 cents (a too-approximate bend isn't transcribed).
• Same note twice: detach them clearly. Rests between notes aren't transcribed.
• Set the app's key to match your harmonica; a quiet environment is recommended.

11 bis. Swing meter 🎵 (beta)

The Swing meter measures your swing ratio on the mic while you play eighth notes: 50% = straight (binary), 66.7% = swing (ternary). It's based on the intervals between your attacks, which makes it insensitive to audio latency — no need to calibrate anything before using it.

A gauge and a plain-language verdict — PLACEMENT OK for a straight target, SWING OK for a triplet target — show live whether you're on target, and the message stays displayed when you stop. Choose the target (Straight 50% or Triplet 66.7%), set the tempo (synced with the toolbar), and optionally let the module generate an exercise of eighth notes (2, 4, 6 or 8) in the chosen scale — or "free" to play whatever you want. 🗑 resets the module.

12. Exports

Four formats, each for a different use.

Export	Content	Use
.json 💾	Everything: notes, durations, tempo, key, modes	Reliable save, exchange, archiving
.mid 🎹	Notes and durations, GM harmonica sound	MuseScore, DAW, backing tracks
.xml	Exact score: full bars, ties, triplets, dotted notes — and chord symbols above the staff if "My progression" holds a grid	MuseScore, Guitar Pro, Sibelius
🖨	Tab, 12 notes/line, key, tempo, date, logo	Lesson handouts, PDF

🎯 Practical example — You want a student to redo at home exactly the version seen in class, editable: export to .json. You just want them to listen on their phone or in a music app: export to .mid. You want to give them a real score to read: export to .xml and open it in MuseScore.

13. Frequently asked questions

• No sound on the first click (iPhone/iPad): browsers unlock audio on the first gesture — click a note.
• Does changing the key change my notes? The tab never changes; only the names and pitch follow — like switching harmonicas.
• Session gone: the save is specific to this browser (private browsing and clearing data erase it) — export to .json to make it last.
• Offline? Yes, entirely: a self-contained file.
• Imported MIDI incomplete: notes unplayable in the chosen key are listed; the app suggests the best key.
• Overblows rejected on import: only overblows 1, 4, 5, 6 and overdraws 7, 9, 10 exist on a standard Richter harmonica.
• "Off harmonica": the detected note doesn't exist in the selected key — check the setting.
• ⟳ vs partial loop: ⟳ repeats whatever is played; with a range selected (Shift+click), only that passage.

14. Effect signs and text export

✨ Effect signs on a note

In the note editor (double-click on a note), you can add effect signs that have no effect on rhythm or duration: they only note a playing intention.

First choose the Position (Before or After the note), then click the Sign(s) you want. A single note can carry several effects, before and/or after; each one stays independent.

Sign	Effect
/	Attack from below (slight attack bend)
\	"Crying" note: slight bend at the end of the note
vib	Vibrato
Wa	"Wah-wah" effect with the hands
DS	Double stop (two notes together)
TBS	Tongue-blocking "slap"
TBO	Tongue-blocking "octave"
→	Glissando to the next note
↔	Trill between two notes

Glissando and trill aren't reproduced by the app's sound. The signs appear on the tab (in orange, around the note).

On export: in text (.txt), each sign is a separate item (e.g. DS TBS +4 vib Wa); in MusicXML, each effect becomes an independent lyric shown below the note in MuseScore.

📝 Text export (.txt)

The TXT button (File group) downloads the tab as plain text, with effect signs, under the tab's name.

Web-App zum Erstellen, Anhören und Üben von Tabulaturen für die 10-Loch-Blues-Harp. Eine einzige Datei, keine Installation, keine Internetverbindung nötig: öffnen Sie harmonica-trainer.html in Ihrem Browser. Die Oberfläche gibt es in sieben Sprachen (Flaggen in der Fußzeile der App, Auswahl wird gespeichert — dieses Handbuch folgt derselben Einstellung).

💡 Dieses Handbuch ist Modul für Modul aufgebaut, in der Reihenfolge, in der sie in der App erscheinen. Jeder Abschnitt erklärt, wofür das Modul da ist, wie man es benutzt, und bietet mindestens ein praktisches Beispiel, um sofort loszulegen.

1. Erste Schritte

Oben auf der Seite zeigt ein Laufband Inhalte von apprendrelharmonica.com; es pausiert beim Überfahren mit der Maus, ein Klick öffnet die Seite. Das Logo der Website unten auf der Seite signiert auch Tabulatur-Ausdrucke.

Vier Grundgriffe für den Anfang

• Ein Klick auf eine Note spielt sie und schreibt sie gleichzeitig. Jeder Klick auf die virtuelle Mundharmonika spielt die Note und fügt sie der Tabulatur hinzu — kein „Hinzufügen"-Knopf nötig.
• ▶ (oder Leertaste) spielt ab, was geschrieben steht. Leere Tabulatur? Die Schaltfläche „Ausprobieren: …" schlägt ein einaktiges Blues-Lick vor, bei jeder Anzeige ein anderes.
• 💾 Nichts von Hand zu speichern. Die App speichert automatisch im Browser: schließen, morgen wiederkommen, Ihre Sitzung wird genauso wiederhergestellt.
• 📂 Die meisten Module lassen sich per Klick auf ihren Titel auf- und zuklappen; das Mundharmonika-Schema und „Meine Tabulatur" bleiben immer geöffnet.

🎯 Praxisbeispiel — Sie öffnen die App zum ersten Mal: Klicken Sie ein paar Löcher der virtuellen Mundharmonika an, um den Klang zu hören, drücken Sie Leertaste, um zu hören, was Sie gerade komponiert haben, und schließen Sie den Tab, ohne etwas zu speichern. Öffnen Sie die App erneut: Ihre kleine Melodie ist immer noch da.

1 bis. Individuelles Layout 🔀

Standardmäßig sind die Module in einer festen Reihenfolge gestapelt. Wenn Sie hauptsächlich zwei oder drei Werkzeuge nutzen (z. B. den Melodie-Generator und die Rhythmus-Werkstatt), können Sie diese näher zusammenrücken, um nicht jedes Mal scrollen zu müssen.

• Ziehen Sie jede Karte an ihrem Griff ⠿: Sie rastet an den Spalten der Seite ein.
• Die Leiste „Layout" speichert mehrere benannte Anordnungen und ruft sie über ein Menü ab.
• ↺ kehrt zur ursprünglichen Anordnung zurück; 💾 exportiert Ihre Layouts in eine wieder importierbare Datei.

Alles wird im Browser gespeichert, geräteabhängig — bei einem Gerätewechsel exportieren Sie Ihr Layout, um es andernorts wiederzufinden.

2. Die Notation

Die Tabulatur der App liest sich wie eine klassische Papier-Tabulatur, mit ein paar zusätzlichen Zeichen für Bendings und Overnotes.

Schreibweise	Bedeutung
+4 / -4	Blasen / Ziehen in Loch 4
-3', -3'', -3'''	Zieh-Bending um 1, 2, 3 Halbtöne
+8'	Blas-Bending (Löcher 8–10)
+6° / -7°	Overblow / Overdraw
z	Pause (beim Textimport)

Derselbe Farbcode taucht überall in der App wieder auf — in der Tabulatur, auf der virtuellen Mundharmonika, im Live-Verlauf des Spiels: blasen · ziehen · Bending · Overblow · Overdraw. Sobald man diesen Code verinnerlicht hat, liest man die Farbe vor der Zahl.

3. Die virtuelle Mundharmonika

Das ist das Herzstück der App: eine komplette Mundharmonika, in der über dem Schema angezeigten Tonart. Jede Spalte reiht von oben nach unten: Overblows, Blas-Bendings, Blaston, Ziehton, Zieh-Bendings, Overdraws.

• Klick auf eine Lochnummer fügt den Blaston des entsprechenden Lochs hinzu.
• Überfahren einer Spalte hebt sie hervor, um auf einen Blick alle auf diesem Loch verfügbaren Techniken zu erkennen.
• Die angezeigten Notennamen folgen der gewählten Tonart und Oktave — ändern Sie die Tonart, ändern sich die Namen, aber die physische Lage der Klänge bleibt gleich.

3 bis. Keyfinder 🔑

Der Keyfinder beantwortet eine Frage, die sich früher oder später jeder Mundharmonikaspieler stellt: „Welche Mundharmonika nehme ich für dieses Stück?" — oder umgekehrt: „Was kann ich mit der Mundharmonika spielen, die ich gerade in der Hand habe?". Er zeigt außerdem die wichtigsten Noten der gewählten Position (Grundton, Terzen, Quinte, Septimen) und wo man sie auf der Mundharmonika spielt.

Praxisbeispiel 1: Ich gehe von der Tonart des Stücks aus

1. Reiter „Mundharmonika finden": wählen Sie die Tonart des Stücks (z. B. C).
2. Wählen Sie die Position, in der Sie spielen möchten (z. B. 2. Position).
3. Der Keyfinder gibt an, welche Mundharmonika zu nehmen ist, und zeigt die Schlüsselnoten: Grundton, große Terz, kleine Terz, reine Quinte, kleine Septime, große Septime — mit ihrer Lage auf der Mundharmonika.

Beispiel: Für ein Stück in C, gespielt in zweiter Position, empfiehlt der Keyfinder eine F-Mundharmonika und zeigt sofort, wo Grundton, Terzen, Quinte und Septimen liegen.

Praxisbeispiel 2: Ich gehe von der Mundharmonika aus, die ich in der Hand habe

1. Reiter „Tonart finden": wählen Sie die Tonart Ihrer Mundharmonika (z. B. E) — mehrere Mundharmonikas können gleichzeitig ausgewählt werden.
2. Das Werkzeug zeigt die 12 spielbaren Tonarten mit den entsprechenden Positionen.
3. Wählen Sie die zum Stil des Stücks passende Position, und finden Sie dann die wichtigsten Noten auf dem Instrument.

Beispiel: Mit einer in E gestimmten Mundharmonika spielen Sie in E in der 1. Position, in H in der 2. Position, in F# in der 3. Position usw.

Die hervorgehobenen Noten — und warum sie wichtig sind

Note	Rolle
Grundton	Wichtigste Bezugsnote der Tonart
Große Terz	Gibt die Dur-Farbe
Kleine Terz	Gibt die Moll- / Blues-Farbe
Reine Quinte	Stabile Stütznote
Kleine Septime	Blues- / Dominant-Farbe
Große Septime	Jazz- / Dur-Farbe

Kurz gesagt: Ob Sie von der Tonart des Stücks oder vom Instrument ausgehen — der Keyfinder führt Sie in wenigen Klicks; Sie sparen Zeit und spielen schneller richtig.

4. Die Werkzeugleiste

Die Werkzeugleiste bündelt fünf Befehlsgruppen. Sie kommen ständig vor — es lohnt sich, sie von Anfang an auswendig zu kennen.

🎵 Wiedergabe

• ▶/⏹ (Leertaste): spielt die Tabulatur ab oder stoppt sie. ⏸ Pause (Taste P) pausiert und merkt sich die aktuelle Note — ein zweiter Klick (oder P) setzt genau dort fort, während ⏹ ganz stoppt und die Position vergisst.
• Start an beliebiger Stelle: Klicken Sie eine Note der Tabulatur an, ▶ startet dort (ohne Auswahl beginnt die Wiedergabe von vorn). Ein Fortsetzen mitten im Stück überspringt Auftakt und Einzähler und synchronisiert das Akkordraster mit dem gespielten Takt.
• ⟳ wiederholt ohne Unterbrechung — das Feld ×N daneben legt eine Anzahl von Wiederholungen fest (spielt N-mal und stoppt dann; leer = unendlich).
• 🎹 Blockakkorde: neben dem Wiederholungsfeld — lässt die Akkorde des Akkord-Baukastens als Block statt als Arpeggio erklingen.
• ⏱0 Einzähler: das Metronom schlägt nur während des Auftakts (Takt 0) und schweigt danach.
• Tempo 40–240, 🔊 Lautstärke, ⏱ Metronom (Betonung je nach Taktart: alle 4 oder 3 Schläge).
• TAP: klicken Sie im Rhythmus (Maus), um das Tempo festzulegen — Durchschnitt der letzten Klicks, auf das Gesamttempo angewandt; RESET löscht die Klicks.

🎯 Praxisbeispiel — Sie kennen das genaue Tempo eines Stücks nicht, das Sie üben möchten: klicken Sie es (TAP) mit, während Sie das Original auf Ihrem Handy hören — die App leitet daraus das BPM ab und stellt es direkt ein.

Während der Wiedergabe leuchtet die aktuelle Note in der Tabulatur und auf der Mundharmonika auf — eine nützliche visuelle Orientierung, um nicht den Faden zu verlieren.

🏋️ Übungen

• 🎼 Generator für Melodien (ausführlich in Abschnitt 7).
• 🎶 Akkord-Baukasten und ♬ Akkordfolgen (ausführlich in Abschnitt 7 bis).
• 🧩 Songstruktur (ausführlich in Abschnitt 7 ter).
• 🎙︎ Mikrofon-Sensor (Test) (ausführlich in Abschnitt 8 quinquies) und 👂 Nach Gehör heraushören (ausführlich in Abschnitt 8 ter).
• 🔀 Mischen der Tabulatur (einmal pro Klick, Strg+Z zum Rückgängigmachen).
• ⇅ aufsteigend dann absteigend.
• SWING (ternäre Achtel: jeder Anschlag, der auf das „und" des Schlags fällt, wird auf zwei Drittel des Schlags verzögert).
• 🎲 Zufällige Notenwerte.
• +BPM progressives Tempo (ausführlich in Abschnitt 6).

Diese Modi lassen sich kombinieren: Sie können z. B. eine Melodie mischen und Swing einschalten und progressives Tempo aktivieren, alles gleichzeitig.

🎼 Tabulatur (Anzeige)

• TAB / Noten / Do Re Mi: wechselt zwischen Tabulatur, angelsächsischen Namen (C4, Bb3…) oder Solmisationsnamen (Do4, Sib3…).
• Tonart (12 Mundharmonikas): Namen und Tonhöhe passen sich an, die Tabulatur bleibt identisch — das ist eine Anzeigeänderung, keine Inhaltsänderung.
• ▾8 / ▴8: transponiert die ausgewählten Noten um eine Oktave (oder die gesamte Tabulatur, wenn nichts ausgewählt ist; entsprechende Löcher). Hat eine Note keine Entsprechung, bewegt sie sich nicht, und die App listet sie auf. Auswahl: Umschalt+Klick für einen Bereich, Strg/Cmd+Klick für eine einzelne Note, ⇄ Umkehren tauscht ausgewählt und nicht ausgewählt.
• 1·3b·5 Stufen: zeigt unter jeder Note ihre Stufe in der Referenz-Tonleiter — die benachbarte Schaltfläche 🎼 öffnet den Generator zur Wahl der Tonleiter, und die Anzeige richtet sich automatisch danach aus. Nicht zur Tonleiter gehörende Noten werden ausgegraut; die Arpeggien des Akkord-Konstrukteurs zeigen stattdessen die Intervalle des Akkords (1, 3b, 5, 7b…).

📁 Datei

• 📚 Bibliothek: benannte Tabulaturen, in diesem Browser gespeichert — laden, umbenennen, löschen; ⬇ Alle exportieren als wieder importierbares .json. Die Fenster lassen sich mit der Maus verschieben.
• 💾 / 📂: vollständige .json-Datei; 📂 öffnet auch .mid-Dateien (Umwandlung in Tabulatur: quantisierte Notenwerte, rekonstruierte Pausen, angewandtes Tempo, unspielbare Noten aufgelistet, beste Tonart vorgeschlagen) und .xml/.musicxml-Dateien.
• 📋 Importieren einer Text-Tabulatur (ausführlich in Abschnitt 5) · 🎹 MIDI (GM-Instrument Harmonica) · XML MusicXML: exakte Partitur — Notenwerte und Notenzeichen stimmen immer überein, volle Takte, geschriebene Bindebögen; MuseScore schreibt nichts um. · TXT: Export als reiner Text mit den Effekten (Bendings, Overnotes…), praktisch zum Einfügen in eine Nachricht.
• 🖨 Drucken: sauberes Layout, weißer Hintergrund, Logo, 12 Noten pro Zeile (PDF über „Als PDF drucken").

🎯 Praxisbeispiel — Sie bereiten ein Übungsblatt für einen Schüler vor: bauen Sie die Tabulatur, klicken Sie auf 🖨 Drucken, dann „Als PDF drucken" im Dialog des Browsers. Das PDF behält Ihr Logo und bleibt auch schwarz-weiß gedruckt gut lesbar.

✏️ Bearbeitung & ♩ Notenwerte

↶/↷ (Strg+Z / Strg+Y), 🗑 alles löschen, ? Hilfe, ! setzt die Anzeige geöffneter Fenster zurück (nützlich bei einem blockierten oder falsch positionierten Fenster außerhalb des Bildschirms).

Neun Notenwerte stehen zur Verfügung: ganze, halbe, Viertel-, Achtel-, Sechzehntelnote, Triole, Punkt (+50 %) sowie drei Pausen (1, ½, ¼ Schlag). Der gewählte Notenwert gilt für die nächsten eingegebenen Noten; auf eine bestehende Auswahl wirkt er sich direkt aus.

Über einen Takt hinausreichende Noten: werden für die Anzeige geteilt und durch ‿ verbunden (gepunkteter, gebundener Teil) — die Note bleibt eine einzige Note, in einem Atemzug gespielt; der MusicXML-Export schreibt den Bindebogen.

‿ Bindebogen: verbindet die ausgewählten Noten — das Zeichen ‿ wird zwischen ihnen angezeigt. Zwei gebundene Noten gleicher Tonhöhe fließen ohne erneuten Anschlag in einem Atemzug ineinander, und der MusicXML-Export schreibt den Phrasierungsbogen. Die Schaltfläche ‿ im Noten-Editor (Doppelklick auf eine Note) macht dasselbe, Note für Note.

5. Text-Tabulatur importieren 📋

Praktisch, um eine in einem Forum, einem Buch oder von einem Schüler per Textnachricht gefundene Tabulatur zu übernehmen — ohne alles von Hand abzutippen.

Fügen Sie Ihre Tabulaturen ein (Noten durch Leerzeichen getrennt; Kommas, Zeilenumbrüche, | werden akzeptiert): +4 -4 +5 -5 +6 -6' -6 z +6 -5 +5 -4 +4. Das + ist optional, z fügt eine Pause ein, ungültige Elemente werden ignoriert und aufgelistet, der Import wird an das bereits Vorhandene angehängt.

6. An einer Passage arbeiten

Zwei Werkzeuge, um an einer bestimmten Stelle zu üben, ohne bei jedem Versuch das ganze Stück durchspielen zu müssen.

Teilschleife

Klicken Sie die erste Note an, Umschalt+Klick auf die letzte: der Bereich wird hervorgehoben, ▶ spielt nur ihn, ⟳ wiederholt ihn. Ein Klick ohne Umschalt verlässt ihn wieder. Der Bereich dient auch dazu, alle Notenwerte zu ändern oder auf einmal zu löschen.

🎯 Praxisbeispiel — Eine zweitaktige Phrase bereitet Ihnen in einem längeren Solo Schwierigkeiten: wählen Sie sie aus (Umschalt+Klick), aktivieren Sie ⟳, und lassen Sie sie in Schleife laufen, während Sie daran arbeiten, ohne je den Rest des Stücks erneut abzuspielen.

Progressives Tempo (+BPM)

Stellen Sie den Schritt (1–20 BPM pro Durchgang) und das Maximum ein: bei jedem Schleifendurchlauf steigt das Tempo und wird angezeigt. Funktioniert auch auf einem ausgewählten Bereich: das Tempo steigt bei jedem Durchlauf der Auswahl, auch wenn die 🎹-Begleitung aktiv ist.

Klassisches Beispiel: 4 schwierige Noten, Start bei 60 BPM, Schritt 4, Maximum 120 — Sie beginnen langsam, und die App beschleunigt nach jedem erfolgreichen Durchgang automatisch, ohne dass Sie selbst das Tempo anfassen müssen.

7. Melodie-Generator 🎼

Der Generator komponiert stimmige Melodien, keine bloßen Zufallsfolgen von Noten: Die Tonleitern sind nach Position gruppiert — Dur & Dur-Pentatonik (1.); Blues, Mixolydisch, Pentatonik (2.); Moll-Pentatonik, Blues, Dorisch (3.); natürliches Moll, Moll-Pentatonik (4.); Phrygisch, Moll-Pentatonik, natürliches Moll mit Bendings (5.); Lydisch, Dur mit Bendings (12.). Vier Stufen (Anfänger, Löcher 4–8 → Experte mit Overblows), über 1, 2 oder 4 Takte. Die Melodie endet immer auf dem Grundton, außer Sie aktivieren „Nicht auf dem Grundton enden".

Das Fenster bleibt geöffnet, während Sie arbeiten: erzeugen Sie in Schleife neu (🎼), hören Sie zu, passen Sie an, ohne die Kontrolle über den Rest der App zu verlieren. Schließen Sie es mit ✕ oder Abbrechen; Strg+Z stellt die vorherige Tabulatur wieder her, falls das Ergebnis nicht passt.

Meine Einstellungen — direkt unter „Überrasche mich" speichern Sie die gesamte Konfiguration des Fensters unter einem Namen und rufen sie mit einem Klick wieder auf: Tonleiter, Stufe, Tonumfang, Länge, Phrasierung, Taktart, Noten pro Takt, angehakte Notenwerte, Begleitung der Progression und beide Einspeisungs-Regler. 💾 speichert (ein bereits vergebener Name ersetzt die alte Einstellung, statt eine doppelte anzulegen), 🗑 löscht die ausgewählte Einstellung, ⬇ exportiert alle Ihre Einstellungen als .json und 📂 importiert sie zurück. Zudem werden die Einstellungen Ihrer letzten Erzeugung von selbst gemerkt: Beim nächsten Start der App öffnet sich das Fenster genau so, wie Sie es verlassen haben.

Mit einem Klick, um schnell voranzukommen

Oben im Generator stellt die Schaltfläche Überrasch mich die Menüs für Sie ein (Sie sehen sie sich bewegen) und erzeugt sofort: ein Klick, eine Melodie. Erneut klicken für einen neuen Wurf. Die detaillierten Einstellungen bleiben darunter, für alle, die Tonleiter, Position und Stufe gezielt wählen möchten.

🎯 Praxisbeispiel — Sie haben 5 Minuten vor einer Unterrichtsstunde und möchten einem Anfänger schnell ein Beispiel zeigen: klicken Sie mehrmals hintereinander auf „Überrasch mich", bis Sie etwas Einfaches und Singbares erhalten, ohne eine Einstellung anzufassen.

Das gerade Erzeugte lesen und spielen

Die Notations-Erinnerung „📖 Wie liest man die Tabulatur?" (Blasen, Ziehen, Bendings, Farbcode) ist über die Hilfe ? im Bearbeitungsmenü verfügbar. Sobald Noten vorhanden sind, erscheint unter der Tabulatur eine Symbolreihe: ▶ (rot) spielt die Tabulatur, ⏹ (grün) stoppt, das Mikrofon-Symbol (blau) startet den 🎯-Modus (Sie spielen ins Mikrofon, die App bewertet Note für Note), und + fügt eine Note hinzu oder ein — nach der ausgewählten Note, sonst am Ende — und öffnet den Editor; erneut klicken, um weitere hinzuzufügen, die Taktstriche werden neu berechnet.

Phrasierung: der Melodie eine Form geben

Über eine „Note-für-Note"-Melodie hinaus können Sie eine Phrasierungsart vorgeben: Frage – Antwort (zwei Teile, die sich antworten), Bogen (Anstieg dann Abstieg), Tal (Abstieg dann Wiederanstieg), Welle (aufeinanderfolgende Wellenbewegungen), Durchgehender Anstieg oder Durchgehender Abfall (die Phrase durchquert das Register in eine einzige Richtung), Leichter Jazz (chromatische Annäherungen an bestimmte Noten) oder Vollständiger Bebop (Enclosures, Achtel). „Keine" lässt der App freie Hand.

Anstieg und Abfall geben eine Gesamtrichtung vor — keine Tonleiter: Die Linie führt von tief nach hoch (oder umgekehrt) und erlaubt sich kleine Rückschritte, was sie musikalisch hält. Die beiden Menüs tiefster → höchster Ton bestimmen den durchquerten Bereich der Mundharmonika. Da die letzte Note auf dem Grundton landet, kann sie ein Stück zurückgehen: Haken Sie „Nicht auf dem Grundton enden" an, wenn die Richtung bis zum Schluss durchgehalten werden soll.

Tal ist der umgekehrte Bogen: Die Phrase beginnt in der Höhe, senkt sich ab und steigt wieder an. Welle reiht Richtungswechsel aneinander — eine Wellenbewegung alle zwei Takte — genau die Phrasierung, die Richtungswechsel trainiert, an denen sich viele Schüler in eine einzige Richtung davontragen lassen.

AAB-Blues — die gesungene Form über Ihrem Schema

Die Phrasierung AAB-Blues schreibt einen Blues-Chorus so, wie er gesungen wird: Phrase A füllt die Takte 1 bis 4, A' wiederholt sie in den Takten 5 bis 8 unverändert, während das Schema zur IV geht — aus dieser Verschiebung entsteht die Spannung —, dann antwortet B und schließt über die Takte 9 bis 12 ab. Jede Vierergruppe endet mit einem Atemzug: Die Phrase setzt in Takt 4 und Takt 8 auf einem Stützton auf und macht dann Platz, so wie ein Sänger das Instrument antworten lässt. B ist dichter als die Aussage, und die Schlusstöne steigen zum Grundton hinab.

Diese Phrasierung verlangt ein 12-taktiges Schema und die angehakte Option „Meiner Progression folgen“: Die Form selbst fordert das. Fehlt eines von beiden, sagt es die App, statt etwas anderes zu erzeugen. In A' wird nur ein Ton korrigiert: eine große Septime auf einem Dominantseptakkord (das E über einem F7 in C) geht einen Halbton hinunter — Blue Notes bleiben unangetastet.

🎯 Praxisbeispiel — Laden Sie das Preset 12-Takt-Blues aus „Akkordfolgen“, senden Sie es an „Meine Progression“, haken Sie „Meiner Progression folgen“ an und wählen Sie AAB-Blues: Sie erhalten einen vollständigen, klar gegliederten Chorus zum Lesen oder Heraushören.

Frage – Antwort funktioniert jetzt über 2 Takte ebenso wie über 4: Der zweite Takt übernimmt Rhythmus und Anfang des ersten, und die Frage bleibt auf der Dominante stehen. So entsteht ein kurzer, klarer Lick, ohne den Umweg über 4 Takte.

🎯 Praxisbeispiel — Tonumfang mit einem Schüler üben: Durchgehender Abfall, 4 Takte, Stufe Fortgeschritten, Umfang auf die Kanäle 4 bis 8 begrenzt — er bekommt eine Phrase, die das gewählte Register wieder hinuntergeht, ohne eine bloße absteigende Tonleiter zu sein.

Takt, Notenwerte und Tonumfang

Wählen Sie die Taktart — 4/4, 3/4 (Walzer), 6/8 oder 12/8: die gesamte App folgt (Taktstriche, Metronom, MIDI- und MusicXML-Exporte). Länge: 1, 2 oder 4 Takte.

Beschränken Sie die verwendeten Notenwerte, indem Sie nur die gewünschten Werte ankreuzen — ganze Note, halbe Note, Viertelnote, punktierte Viertel, Achtel, Sechzehntel, Triole oder Viertel-Triole.

Beispiel: nur ganze Note für eine Note pro Takt, oder nur halbe Note für zwei Noten pro Takt — ideal für eine sehr einfache Phrasierung oder eine erste Stufe. Alles angekreuzt = frei.

Reicht die angeforderte Notenzahl nicht aus, um den Takt zu füllen — z. B. 4 Achtel in 4/4 —, füllt die App mit Pausen auf, statt abzulehnen: sie werden im Takt verteilt, nicht ans Ende gehäuft, damit die Melodie atmen kann.

Zwei Menüs tiefste Note → höchste Note beschränken die erzeugte Melodie auf den von Ihnen gewählten Bereich der Mundharmonika, unter den für die gewählte Tonleiter und Stufe verfügbaren Noten — praktisch, um auf einem bestimmten Bereich des Instruments zu bleiben. Sie füllen sich bei Änderung von Tonleiter oder Stufe automatisch neu.

Anzahl Noten pro Takt. Legen Sie ein Maximum fest: bei 6 nutzt die App bis zu 6 Noten, nicht zwingend 6. Kreuzen Sie „genau diese Anzahl" an, um die genaue Zahl zu erzwingen.

Über einer Akkordfolge erzeugen

Wenn Sie „Meiner Akkordfolge folgen" ankreuzen, wird die gewählte Tonleiter auf die Akkorde Ihrer Akkordfolge (Modul „Meine Akkordfolge") angewandt, unabhängig von deren Tonart — gut, um unerwartete Klänge auszuprobieren (Vorsicht vor Dissonanzen). Jeder Akkord behält seine eigene Dauer (voller Takt, halber Takt…): die erzeugte Melodie passt sich automatisch daran an, ohne zusätzliche Einstellung. Die Einstreu-Regler fügen dann einen Prozentsatz an tonleiterfremden Noten und Pausen (Phrasenenden-Atempausen) hinzu.

Das Menü „Verwendete Töne über der Progression" entscheidet zwischen Tonleiter und Akkorden. Frei mischt beides, gesteuert über den Einstreu-Regler — das ursprüngliche Verhalten, das tonleiterfremde Töne zulassen kann (etwa die große Terz eines Blues-Akkords). Strikte Tonleiter und Nur gemeinsame Töne bleiben beide strikt innerhalb der gewählten Tonleiter, ohne Ausnahme — ihr Unterschied liegt darin, wie der Ton ausgewählt wird, nicht darin, was verfügbar ist. Bei Strikte Tonleiter hat der aktuelle Akkord keinerlei Einfluss: Die Melodie folgt der Tonleiter unabhängig davon. Bei Nur gemeinsame Töne hat die App, wann immer ein Tonleiterton zugleich ein Akkordton ist, die Möglichkeit, ihn zu bevorzugen — vor allem auf den Schlagzeiten —, ohne dass dies systematisch oder verpflichtend wäre: eine mögliche Wahl unter anderen, kein Zwang. Beide Optionen deaktivieren den Einstreu-Regler, der dann keine Funktion mehr hat.

🎯 Praxisbeispiel — Blues-Tonleiter, 2. Position, über ein Blues-Schema: Im Modus Frei schleichen sich Töne der großen Terz des Akkords in die Melodie; wechseln Sie zu Strikte Tonleiter, um vom Anfang bis zum Ende in der Blues-Farbe zu bleiben, unabhängig vom Akkord.

Meine Modi 🧬: eigene Tonleitern erstellen

Ausklappbares Modul zum Erstellen eigener Modi — Name, Position (1. bis 12.), angekreuzte Stufen unter den 12 Halbtönen — im Browser gespeichert und (★) in den Tonleiter-Auswahlmenüs des Generators, der 1·3b·5-Stufen und des Swing-Meters verfügbar. ✎ bearbeitet einen Modus, 🗑 löscht ihn.

Im Generator-Fenster, neben der Tonleiter-Auswahl: 🗑 entfernt die angezeigte Tonleiter aus der Liste (Auswahl gespeichert), ↺ zeigt wieder alle Tonleitern; ⬇ exportiert Ihre Modi in eine .json-Datei und 📂 importiert sie wieder.

7 bis. Akkorde & Akkordfolgen 🎶

Drei sich ergänzende Module, um mit Akkorden statt einzelnen Noten zu arbeiten: einen einzelnen Akkord bauen, ein fertiges Raster verketten, und das aktuelle Raster spielen/exportieren.

🎶 Akkord-Konstrukteur

Gruppe Übungen: wählen Sie den Grundton, die Qualität (von Dreiklängen bis zur 13.), eventuelle Alterationen/Spannungen (b5, #5, b9, #9, #11, b13 — je nach Qualität aktiv), einen optionalen Bassnoten (Slash-Akkord, z. B. C/E) und die Arpeggio-Form (aufsteigend, oder auf- und absteigend).

Die Auswahl Takt (4/4, 3/4, 6/8, 12/8) legt vor dem Bauen die Taktart fest — sie wird mit dem Melodie-Generator und den Akkordfolgen geteilt; enthält die Tabulatur bereits Noten, wird eine Bestätigung verlangt, da die Taktstriche neu berechnet werden. Wählen Sie direkt die Dauer des Akkords, in Schlägen — 1, 2 oder 4 in 4/4; 1 oder 3 in 3/4; 1½ oder 3 in 6/8; 3 oder 6 in 12/8 — dieselbe Auswahl wie in „Akkordfolgen" und „Songstruktur".

Bestätigen fügt den Akkord als Arpeggio am Ende der Tabulatur ein — tiefste spielbare Lage, Overblows/Overdraws eingeschlossen — und das Fenster bleibt offen, um mehrere Akkorde nacheinander anzuhängen; Letzten löschen entfernt den zuletzt hinzugefügten. Der Akkordname erscheint als Kennzeichnung am Anfang seiner Zeile, und 🔀 sowie 🎲 wirken innerhalb jedes Akkords, ohne seine Takte zu zerstören. Bei der Wiedergabe schaltet 🎹 (Gruppe Wiedergabe) auf Blockakkorde um: jeder Akkord erklingt als Block, mit Klavierklang, statt als Arpeggio.

♬ Akkordfolgen (Vorlagen)

Verschiebbares Fenster der Gruppe Übungen: rund zwanzig klassische Akkordfolgen (Pop, Jazz, 12-taktiger Blues, Moll-Kadenzen…), transponierbar in alle 12 Tonarten und in Dur/Moll — kreuzen Sie „Nur Vorzeichen" an, um nur die angezeigte Tonart-Vorzeichnung zu ändern, ohne die Akkorde zu transponieren.

Die Akkordfolge ist vor dem Einfügen bearbeitbar: klicken Sie einen Akkord an, um seinen Grundton, seine Qualität, seine Spannungen, seine Bassnote und seine eigene Dauer (1, 2 oder 4 Schläge je nach Takt) zu ändern — jeder Akkord behält seine Dauer, Sie können also einen vollen Takt und zwei halbe Takte im selben Raster mischen. Die Takt-Auswahl des Fensters legt die Taktart fest, aus der sich die Dauer eines vollen Takts ergibt: 4 Schläge in 4/4, 3 in 3/4, 6 in 12/8. ◀ ▶ verschieben einen Akkord, ✕ entfernt ihn, + fügt einen hinzu. Anzeige-Umschaltung Namen / Stufen (römische Ziffern).

💾 speichert Ihre Akkordfolge in der Vorlagenliste (★, 🗑 zum Löschen), ⬇ exportiert Ihre Akkordfolgen in .json, und 📂 importiert sie wieder. → Meine Akkordfolge sendet das erstellte Raster zum Modul unten, ohne über die Tabulatur zu gehen. Ihre gespeicherten Songstrukturen (Modul 🧩, Abschnitt 7 ter) erscheinen ebenfalls in dieser Liste, mit dem Präfix 🧩: sie auszuwählen glättet die gesamte Struktur in das Raster, wobei Dauern und Tonarten je Teil erhalten bleiben.

♬ Meine Akkordfolge

Dieses Modul zeigt das empfangene Raster: jede Kachel gibt den Akkordnamen an, mit seiner Dauer in Klammern, wenn sie von einem vollen Takt abweicht (z. B. G7 (2)). Die Dauern werden automatisch erkannt und beachtet, unabhängig von ihrem Ursprung — Vorlagen, Konstrukteur (über die Tabulatur), oder Übertragung von der Tabulatur zu diesem Modul — ohne jede manuelle Einstellung.

• ♬ Wiedergabe begleiten: das Raster spielt am Klavier während der Wiedergabe der Tabulatur, jeder Akkord an seiner echten Position und Dauer.
• 🪟 Aktueller Akkord: öffnet ein kleines, verschiebbares, stets im Vordergrund bleibendes Fenster, das den aktuellen Akkord groß anzeigt, zusammen mit dem nächsten — praktisch, um das Raster im Blick zu behalten, ohne die Mundharmonika aus den Augen zu lassen.
• → Tabulatur: wandelt das Raster in Arpeggien in der Tabulatur um, eine Gruppe pro Akkord, jeweils mit seiner eigenen Dauer.
• 💾 🎹 XML TXT: exportieren nur das Raster — JSON, MIDI (Blockakkorde), MusicXML (Akkorde und Symbole über dem System geschrieben, nie als Noten), Text (Akkordnamen).
• 🗑: leert die Akkordfolge.

🎯 Praxisbeispiel — Sie bringen einem Schüler per Videoanruf ein Blues-Raster bei: senden Sie eine 12-taktige Blues-Vorlage an „Meine Akkordfolge", öffnen Sie 🪟 Aktueller Akkord, und lassen Sie das Fenster sichtbar, während der Schüler darüber spielt — er sieht immer, wo er steht, ohne das gesamte Raster lesen zu müssen.

Im Kopf von „Meine Tabulatur" macht die Schaltfläche → Meine Akkordfolge den umgekehrten Weg: sie liest die in der Tabulatur vorhandenen Akkord-Arpeggien (über 🎶 erstellt) und baut das Raster in „Meine Akkordfolge" wieder auf, Dauern eingeschlossen. Die Symbole 💾 🎹 XML TXT direkt daneben sind Abkürzungen zu den Exporten der vollständigen Melodie — dieselben wie in der Hauptwerkzeugleiste.

7 ter. Songstruktur 🧩

Dieses Modul dient dazu, das vollständige Akkordraster eines Songs Teil für Teil zu bauen, statt eines einzigen einheitlichen Rasters — nützlich, sobald ein Song eine Strophe und einen Refrain mit unterschiedlichen Akkorden hat.

Verschiebbares Fenster (Schaltfläche 🧩, Gruppe Übungen): Intro, Strophe, Refrain, Bridge, Solo, Break, Übergang, Outro, oder ein benutzerdefinierter Teil — jeder Typ hat seine eigene Farbe, als Rahmen auf der Karte wiedergegeben. Teil hinzufügen erstellt eine Karte und wählt sie sofort aus; ihr Name ist bearbeitbar, ihre Tonart und ihr Modus werden im Editor darunter eingestellt und transponieren alle ihre Akkorde auf einmal.

Das Raster eines Teils bauen

Das Raster jedes Teils wird mit demselben Akkord-Konstrukteur wie 🎶 (Abschnitt 7 bis) gebaut: + öffnet den Konstrukteur, Bestätigen fügt den Akkord dem Teil hinzu, und das Fenster bleibt offen, um weiter anzuhängen. Danach öffnet ein Klick auf eine Akkord-Kachel den Konstrukteur erneut, vorausgefüllt mit diesem Akkord, um ihn zu bearbeiten (Grundton, Qualität, Dauer…), ohne den Rest des Rasters zu berühren; das kleine ✕ rechts neben der Kachel entfernt sie; und die dezenten +-Zeichen zwischen den Kacheln fügen einen vergessenen Akkord genau an dieser Stelle ein — aufeinanderfolgende Einfügungen werden in der Reihenfolge verkettet, in der Sie sie eingeben.

Teile umordnen und verwalten

• ◀ ▶ verschieben einen Teil um eine Position, oder fassen Sie seinen Griff ⠿, um ihn per Ziehen und Ablegen zu platzieren, wo Sie möchten (ein blauer Rahmen zeigt das Einfügen vor oder nach der überfahrenen Zeile an).
• ⧉ dupliziert einen Teil, 📋 kopiert ihn und 📥 Einfügen fügt ihn am Ende der Struktur hinzu, 🗑 löscht ihn (Bestätigung erforderlich).
• ↺ Leeren aller Teile mit einem Klick (Bestätigung erforderlich): Ihre gespeicherten Strukturen bleiben unberührt.

💾 Speichern einer Struktur unter einem Namen: sie erscheint in der Dropdown-Liste (das erneute Laden einer Struktur verlangt eine Bestätigung, falls bereits eine andere in Bearbeitung ist), 🗑 direkt daneben löscht sie aus der Liste. ⬇ exportiert alle Ihre gespeicherten Strukturen in .json, 📂 importiert sie wieder. Ihre gespeicherten Strukturen erscheinen ebenfalls, mit dem Präfix 🧩, in der Liste „Akkordfolgen" (Abschnitt 7 bis): sie dort auszuwählen glättet das gesamte Raster, wobei Dauern und Tonarten je Teil erhalten bleiben.

Eine Melodie auf einem bestimmten Teil erzeugen

🎲 Eine Melodie erzeugen auf einem Teil (falls dieser Akkorde enthält): der Melodie-Generator 🎼 komponiert über sein Raster, in seiner Tonart, mit den aktuellen Einstellungen des Generators (Stufe, Tonleiter, Phrasierung…), und fügt das Ergebnis genau an der Stelle dieses Teils in „Meine Tabulatur" ein — der Rest der Tabulatur wird nicht angetastet; ein Teil erneut zu erzeugen ersetzt ihn, statt ihn hinzuzufügen.

🎯 Praxisbeispiel — Sie bauen einen Song mit Intro / Strophe / Refrain / Solo: erzeugen Sie eine ruhige Melodie über der Intro, dann eine technischere Melodie nur für das Solo, ohne je die beiden anderen Teile zu berühren.

→ Meine Akkordfolge glättet die gesamte Struktur, in der Reihenfolge der Teile, zum Modul in Abschnitt 7 bis — derselbe Weg wie bei den Vorlagen.

Spezielle Exporte: TXT erzeugt ein druckbares Raster, benannte Teile, in Spalten ausgerichtete Takte; XML erzeugt eine MusicXML-Datei, bei der jeder Teil auf einer neuen Zeile beginnt (Teil-Markierung und Tonart-Vorzeichnung), mit Akkordsymbolen in internationaler Notation über dem System — das System bleibt leer (Pausen ausgeblendet), wenn „Meine Tabulatur" leer ist, oder übernimmt ihre Melodie, wenn sie eine enthält.

8. Feinbearbeitung

Sobald eine Melodie steht — erzeugt, importiert oder Note für Note eingegeben — so feilen Sie präzise daran.

Übersicht der Kopfleiste

Von oben nach unten die Funktion jedes Bedienelements der Kopfleiste:

• ⠿ verschiebt das Modul auf der Seite.
• Ma tablature: Modultitel; 18 Elemente · 4 Takte: Zähler für Noten/Pausen und Takte, in Echtzeit aktualisiert.
• ▼8 / ▲8: transponiert die gesamte Auswahl eine Oktave tiefer/höher (ohne Auswahl: die ganze Tabulatur).
• Auftakt: erklärt den ersten Takt zum Auftakt.
• ▶ rotes Symbol oben rechts: öffnet das Tutorial-Video des Moduls.
• 💡 Hinweisleiste: erinnert an den Doppelklick zum Bearbeiten einer Note.
• ▶ / ■ / 🎤 / +: Wiedergabe, Stopp, Mikrofonmodus, Note hinzufügen.
• ⇄ Umkehren: kehrt die Auswahl um (gezogen ⇄ geblasen).
• ✕ Note: löscht die zuletzt eingegebene Note (und weitere Aktionen an der ausgewählten Note).
• 🗑 Alles: löscht die gesamte Tabulatur.
• ⇅ Folgen: schaltet das automatische Scrollen während der Wiedergabe ein/aus.
• ♫ Arpeggien: schaltet den Arpeggio-Modus um.
• Stumm: schaltet den Wiedergabeton stumm.
• → Meine Progression: wechselt zum verknüpften Akkordfolgen-Modul.
• 💾 / 🎹 / XML / TXT: speichert die Tabulatur, exportiert nach MIDI, nach MusicXML, als Text.
• ⚠ Takt vervollständigen: meldet einen unvollständigen, zu korrigierenden Takt.
• Taktnummer (linke Spalte): markiert den Takt im Raster.
• Notenfeld: Kanal, Notenwert und Kanalnummer — Doppelklick zum Bearbeiten (Tonhöhe, Notenwert, Pause).

Auswahl und Löschen

Klick = Auswahl (neue Noten werden danach eingefügt); ⌫/Entf löscht; ←/→ verschiebt die Auswahl. Automatische, nummerierte Taktstriche (4/4 oder 3/4 je nach im Generator gewählter Taktart); der Zähler zeigt Elemente und Takte an.

Der Noten-Editor (Doppelklick)

Doppelklick auf eine Note öffnet einen vollständigen Editor: das Loch (1–10) ändern, die Technik (nur tatsächlich auf diesem Loch spielbare Noten werden angeboten, mit ihrer Farbe), die Dauer und den Punkt, die Note in eine Pause umwandeln (und umgekehrt), oder sie löschen.

Takt vervollständigen, duplizieren, löschen

⚠ Takt vervollständigen: ist der letzte Takt unvollständig, erscheint diese Schaltfläche über der Tabulatur. Die App schlägt drei mögliche Enden innerhalb der aktuellen Tonleiter vor — wählen Sie eines aus, die Noten werden hinzugefügt, und der Takt geht genau auf.

Einen Takt duplizieren oder löschen. Jede Zeile der Tabulatur entspricht einem Takt. Die beiden kleinen Schaltflächen am Zeilenende erlauben es, ihn zu duplizieren (eine Kopie wird direkt danach eingefügt) oder mit einem Klick zu löschen.

Oktaven transponieren

Oktaven ±8. Wenn es die Tonhöhen erlauben, senken oder heben ▾8 / ▴8 die Auswahl (oder die gesamte Tabulatur) um eine oder zwei Oktaven; eine Note ohne Entsprechung wird nicht transponiert.

Akkorden während der Wiedergabe folgen

⇅ Folgen und 🎵 Arpeggien. Ist eine Akkordfolge in „Meine Akkordfolge" vorhanden, können ihre Akkord-Arpeggien während der Wiedergabe mit einem grünen Rahmen umgeben werden: ⇅ Folgen lässt die Tabulatur auf sie hin scrollen (deaktivieren, um selbst zu scrollen), 🎵 Arpeggien lässt sie mit ihrem Akkord hörbar werden (deaktivieren, um nur das Klavier zu behalten).

Woher kommen die Noten der Tabulatur?

Dort werden Noten angezeigt, die stammen von: Ihren Klicks auf das Schema, dem Mikrofon (Modul Tonhöhenerkennung oder Mikrofon-Sensor), dem Melodie-Generator, der Bibliothek, der Schaltfläche „Tabulatur" von „Meine Akkordfolge", der Schaltfläche + des Moduls, und der Schaltfläche „Ausprobieren".

Tonart-Vorzeichnung (für Exporte)

Die Vorzeichnung der Exporte ist automatisch: sie folgt dem Grundton der erzeugten Melodie entsprechend ihrer Position, in Dur oder Moll — so ergibt eine Moll-Pentatonik in 3. Position auf einer C-Mundharmonika D-Moll (ein b), nicht die Vorzeichnung der Mundharmonika selbst. Ohne erzeugte Melodie gilt die Dur-Tonart der Mundharmonika. Sie erscheint im ersten Takt des MusicXML (mit dem Modus) und im MIDI — MuseScore zeigt eine saubere Partitur an.

Auftakt

Geben Sie Ihren Auftakt am Anfang der Tabulatur ein, inklusive etwaiger Vorpausen — zum Beispiel zwei Seufzer dann zwei Achtel — und klicken Sie auf Auftakt im Kopf des Moduls: der erste Takt wird zum Takt 0, mit gepunkteltem Rahmen markiert. Erneut klicken hebt es auf. Seine Noten werden wie alle anderen bearbeitet (Dauer, Doppelklick, Ziehen und Ablegen). Bei der Wiedergabe spielt Takt 0 nur einmal am Anfang: die Schleife ⟳ wiederholt nur den Hauptteil, und die Begleitung von „Meine Akkordfolge" setzt erst bei Takt 1 ein. Bei aktiviertem Metronom werden die leeren Schläge vor dem Auftakt eingezählt — und ohne Auftakt erhalten Sie am Anfang einen Einzähler von einem vollen Takt. Der MusicXML-Export schreibt einen echten Auftakt (verkürzter Takt 0, führende Pausen entfernt); das MIDI behält das genaue Timing bei. Eine über die Taktstrichlinie hinausreichende Note bleibt im Hauptteil.

8 bis. Gehörbildungsdiktat 🎧 (Beta)

Zum Trainieren des reinen Hörens: die App spielt etwas vor, Sie müssen es erkennen und nachspielen, ohne es geschrieben zu sehen.

So funktioniert's

Unter dem Stimmgerät: wählen Sie 1 bis 6 Noten und die Stufe — Anfänger (Löcher 4–6), Mittelstufe (natürliche Noten), Fortgeschritten (Bendings, ohne Overnotes), Experte (alles eingeschlossen). 🎲 spielt eine singbare Phrase (Intervalle ≤ Quinte, keine Wiederholung), in der aktuellen Tonart. ▶ Erneut hören beliebig oft; 🎤 Am Mikrofon antworten: jede richtige Note füllt ihr Feld, eine falsche blinkt rot und zählt als Fehler. Auflösen zeigt die Lösung. Schreibt nie in Ihre Tabulatur.

Punkte, Statistiken und Abzeichen

Jedes erfolgreiche Diktat ergibt einen Punktestand = Noten × Stufe × 100, minus 20 pro Fehler und 5 pro Wiederholung nach der ersten. Unter dem Modul: gespielte Diktate, fehlerfreie Durchgänge, Rekord, Gesamtsumme und laufende Serie (zurücksetzbar mit ↺). Sieben freischaltbare Abzeichen — Bronze-/Silber-/Gold-Ohr (10/50/100 Diktate), Makellos und Absolutes Gehör (5 und 10 fehlerfrei in Folge), Virtuose (ein fehlerfreies Experte-Diktat), Meister des Atems (über 1000 Punkte). Alles im Browser gespeichert, offline.

🎯 Praxisbeispiel — 5 Minuten vor dem Einschlafen, ohne Mundharmonika griffbereit, um eine Partitur zu lesen: starten Sie ein Diktat der Stufe Anfänger, spielen Sie am Mikrofon auf Ihrer Nachttisch-Mundharmonika, und beobachten Sie, wie Ihre Serie fehlerfreier Durchgänge Abend für Abend wächst.

8 ter. Nach Gehör heraushören 👂 (Beta)

Ähnlich dem Gehörbildungsdiktat, aber auf Tonleiter und Position ausgerichtet statt auf isolierte Noten — nützlich, um das Ohr an eine bestimmte Tonleiterfarbe zu gewöhnen.

So funktioniert's

Schaltfläche 👂 (Gruppe Übungen): die App spielt ein paar Noten einer Tonleiter/Position Ihrer Wahl (Ihre ★-Modi eingeschlossen) ohne sie zu zeigen. Stellen Sie die Stufe und die Anzahl der Noten (2–16) ein, hören Sie beliebig oft erneut, und rekonstruieren Sie dann die Phrase im Fenster: 🎤 am Mikrofon — jede gespielte Note wird zu einem Plättchen — oder von Hand (Syntax +4 -4 -3' +6°; Klick auf ein Plättchen, um es zu entfernen, ⌫ um alles zu löschen). Bestätigen zeigt darunter die Lösung, grün/rot Note für Note: richtig ist, was klingt wie richtig (-2 ≡ +3). Berührt nie Ihre Tabulatur.

Punkte und Abzeichen

Punktestand = richtige Noten × Stufe × 100, −20 pro Fehler, −5 pro Wiederholung nach der ersten, gezählt bei der ersten Bestätigung des Durchgangs. Eine Stufe je 1000 Punkte; fünf Abzeichen (erster fehlerfreier Durchgang, 10 und 50 Heraushören, 5 fehlerfrei in Folge, fehlerfrei bei Experte); Zurücksetzen mit ↺. Im Browser gespeichert, offline.

8 d. Rhythmus-Werkstatt 🥁 (Beta)

Trainiert den Rhythmus unabhängig von der Tonhöhengenauigkeit — perfekt für Schüler, die richtig spielen, aber „daneben" liegen, oder umgekehrt.

So funktioniert's

Taste 🥁 (Gruppe Dauern): Die App erzeugt einen Ein-Takt-Rhythmus (4/4) je nach Stufe — bis zu ♪♬♬ und ♬♬♪, der Synkope ♬♪♬, Pausen, Triolen und großen Synkopen — und spielt ihn mit Metronom auf dem Grundton (Tempo begrenzt auf 60-100). Nach einem Takt Einzähler spielen Sie ihn nach: 🎤 per Mikrofon (Melodie oder ein einzelner Ton, mit klar getrennten Anschlägen) oder 👆 durch Tippen (Leertaste oder Taste). Korrektur Figur für Figur (grün/rot), überzählige Anschläge markiert; die Latenz wird automatisch kompensiert — nur die rhythmische Platzierung zählt.

Punkte und Abzeichen

Richtige × Stufe × 100, −20 pro verpasster Figur, −10 pro überzähligem Anschlag, −5 pro Wiedergabe nach der ersten; eine Stufe je 1000 Punkte, zwölf Auszeichnungen, Zurücksetzen mit ↺. Sie betreffen die Anzahl gespielter Rhythmen (1, 3, 10), die fehlerfreien Durchgänge (1, 3, 10), fehlerfrei in Folge (2, 5), fehlerfrei beim ersten Hören (3) sowie fehlerfrei auf jeder Stufe — Mittelstufe, Fortgeschritten und Experte, je 3, ohne sich je von einer Stufe zur nächsten zu addieren. Die Antwortart zählt nicht: Mikrofon und Tippen sind genau gleichwertig. Bleibt im Browser, offline.

🎯 Praxisbeispiel — Ein Schüler neigt dazu, Achtelnoten zu früh zu spielen: stellen Sie die Stufe auf Anfänger, lassen Sie ihn zunächst tippen (👆) statt am Mikrofon zu spielen, um das rhythmische Problem zu isolieren, ohne dass die Tonhöhengenauigkeit dazwischenfunkt.

8 quinquies. Mikrofon-Sensor (Test) 🎙︎

Schaltfläche 🎙︎? (Werkzeugleiste): ein Kontrollschritt, bevor irgendetwas in die Tabulatur geschrieben wird. Nichts ändert sich, bis Sie bestätigen.

🎤 Sensor scharfschalten, Wiedergabe starten (▶) und mitspielen: Jeder erkannte Anschlag erscheint in der Liste mit gespielter Position, Zielfeld, Note, entsprechendem Tabulatur-Loch und Abweichung in Millisekunden. Das Raster (Viertel-, Achtel- oder Sechzehntelnote) legt die angestrebte Quantisierungsgenauigkeit fest.

Latenz kalibrieren

Zwischen dem Moment, in dem der Ton aus der Mundharmonika kommt, und dem Moment, in dem das Mikrofon ihn an die App weitergibt, liegt immer eine kleine Verzögerung: die Latenz. Unkorrigiert verfälscht sie alles, was mit Rhythmus zu tun hat — die Rhythmus-Werkstatt oder der 🎯-Modus „Tabulatur spielen" können eine Note als „zu spät" werten, obwohl sie genau im Takt war, und das automatische Schreiben über ✍ In die Tabulatur schreiben… setzt Noten und Notenwerte leicht daneben. Auch der Swing-Meter kann dadurch etwas verzerrt werden, da er sich auf die Zeitabstände zwischen Ihren Noten stützt. Solange Sie keine zeitgesteuerte Übung oder das automatische Schreiben nutzen, spielt die Latenz keine Rolle.

⏱ Latenztest (am einfachsten, zuerst durchführen):

1. Klicken Sie auf ⏱ Latenztest.
2. Nach einem kurzen Countdown spielt das Metronom 8 Klicks von allein, ohne Melodie.
3. Spielen Sie bei jedem Klick eine einzelne, klare, abgesetzte Note — welches Loch ist egal, wichtig ist ein sauberer Klang, genau im Takt.
4. Nach den 8 Klicks vergleicht die App jeden Ihrer Anschläge mit dem passenden Klick und berechnet die mediane Abweichung.

Das Ergebnis wird angezeigt (z. B. „8 Anschläge · Median-Latenz 42 ms"), und das Feld Latenz (ms) füllt sich automatisch — sonst nichts zu tun. Diese Einstellung gilt appweit.

⌁ Kalibrieren (zur Feinabstimmung unter echten Bedingungen):

1. 🎤 Sensor scharfschalten, eine echte Wiedergabe starten (▶) und normal dazu spielen.
2. Jede gespielte Note wird der Liste hinzugefügt, mit ihrer eigenen Abweichung.
3. Klicken Sie auf ⌁ Kalibrieren: Die App übernimmt die mediane Abweichung dieser Aufnahme und addiert sie zur bereits eingestellten Latenz.

Wiederholen Sie dies unter verschiedenen Bedingungen (mit oder ohne Kopfhörer, anderes Mikrofon, anderer Raum), um noch feiner abzustimmen.

Swing (Position des „und"): von Hand einstellbar, oder mit ◱ Swing messen aus dem eben Gespielten abgeleitet. Hat nichts mit der Latenz zu tun — Raster und Swing legen nur die angestrebte Zerlegungsgenauigkeit und das ternäre Feeling fest.

Eine Melodie oder Improvisation als Tabulatur aufnehmen

Der Sensor misst Ihre Anschläge nur relativ zur Uhr der app-eigenen ▶-Wiedergabe: Damit er überhaupt etwas erfasst, muss eine Wiedergabe laufen, während Sie spielen — auch wenn sie nur aus Pausen besteht.

Fall 1: solo, mit dem Metronom

1. Wählen Sie die Tonart Ihrer Mundharmonika im Mundharmonika-Schema.
2. Öffnen Sie den Mikrofon-Sensor und schalten Sie ihn scharf (🎤 Sensor scharfschalten).
3. Füllen Sie „Meine Tabulatur" mit leeren Takten (nur Pausen), im gewünschten Tempo — so viele Takte wie nötig.
4. Starten Sie die Wiedergabe ▶ dieser stillen Takte: Sie lässt das Metronom laufen und gibt dem Sensor seinen Zeitbezug.
5. Spielen Sie Ihre Melodie dazu, im Takt des Klicks.
6. Klicken Sie auf ✍ In die Tabulatur schreiben… (Details unten).

Fall 2: gleichzeitig mit einem YouTube-Video

Gleicher Ablauf wie Fall 1, mit einer zusätzlichen Einschränkung: Starten Sie im Wiedergabeschritt das YouTube-Video und die Wiedergabe der stillen Takte gleichzeitig, von Hand, so nah wie möglich beieinander. Sie spielen anschließend im Takt des Videos — das Metronom der App dient nun nur noch dazu, die interne Uhr des Sensors laufen zu lassen.

Diese manuelle Synchronisation funktioniert bei langsamem Tempo sehr gut: Ein Schlag dauert länger, sodass eine kleine Sync-Abweichung nur einen winzigen Bruchteil des Schlags ausmacht und die Note trotzdem im richtigen Feld landet. Bei schnellem Tempo wiegt dieselbe Abweichung viel schwerer, und das Risiko steigt, dass die Note ins Nachbarfeld rutscht.

✍ In die Tabulatur schreiben… öffnet „Aufnahme prüfen": ein Vergleich Takt für Takt, ✓ behält Ihre Aufnahme, ✕ behält die ursprüngliche Tabulatur (Abkürzungen Alle behalten / Alle verwerfen). Vor Übernehmen wird nichts geschrieben — ein einziges Strg+Z macht alles rückgängig.

9. Tastaturkürzel

Tasten	Aktion
1–0	Blaston, Löcher 1 bis 10
Umschalt+1–0	Ziehton
Leertaste	Wiedergabe / Stopp
P	Pause / Fortsetzen bei der aktuellen Note
← / →	Vorherige / nächste Auswahl
Entf	Auswahl löschen (oder die letzte Note)
Umschalt+Klick	Bereichsauswahl
Strg+Z / Y	Rückgängig / Wiederholen

Funktioniert mit AZERTY- und QWERTZ-Tastaturen.

10. Audioaufnahme 🎙 (Beta)

Um eine akustische Spur Ihres Spiels festzuhalten, ohne dass daraus eine Tabulatur wird — nur eine Audiodatei zum erneuten Anhören oder Versenden.

Benennen Sie die Datei, wählen Sie das Mikrofon (Systemstandard), ⏺ dann ⏹: ein Player erscheint, ⬇ lädt herunter, 🗑 Löschen löscht die Aufnahme. Webm/opus-Format, Mono (≈ 1 MB/min), überall abspielbar.

🎯 Praxisbeispiel — Starten Sie die Schleifenwiedergabe einer Übung, starten Sie die Aufnahme, spielen Sie zwei- oder dreimal mit, stoppen Sie, und hören Sie sich dann selbst im Vergleich zum Original an: eine hervorragende Methode, um die eigenen Schwächen zu erkennen, ohne dass jemand daneben sitzen muss.

10 bis. Übungen nach einem Video 🎯 (Beta)

Das umgekehrte Modul zum vorherigen: statt von einer Tonleiter auszugehen, um eine Übung zu erzeugen, gehen Sie von einem Backing Track aus, und die App schlägt die darüber zu übenden Positionen vor.

Wählen Sie eines Ihrer Stücke aus der Dropdown-Liste (zunächst Ihre Videos, dann die Bibliothek) — Tonart, Modus, Stil und Tempo füllen sich von selbst, und das Video wird angezeigt. Sobald Sie Tonart oder Modus berühren, beschränkt sich die Liste auf die Backing Tracks in dieser Tonart und diesem Modus, und ihre Beschriftung zeigt die Anzahl an; ✕ Alle anzeigen kehrt zur vollständigen Liste zurück. Oder, für ein beliebiges Video, fügen Sie dessen YouTube-Link ein und geben Sie von Hand seine Tonart, seinen Modus, seinen Stil und sein Tempo an; die App schlägt dann zwei passende Backing Tracks aus Ihrer Sammlung vor.

Für jede aufgeführte Position (Harp + Tonleiter) lädt eine Schaltfläche die Mundharmonika und erzeugt sofort eine Übung in dieser Position und Tonart. Die Wahl eines Backing Tracks stellt den Generator 🎼 auf die erste Position voreingestellt, über 1 Takt.

11. Tonhöhenerkennung 🎤 (Beta)

Das vielseitigste der Mikrofon-Werkzeuge der App: es eignet sich sowohl zum sofortigen Überprüfen Ihrer Tonhöhengenauigkeit als auch zum automatischen Transkribieren einer Melodie, die Sie spielen, ohne vorher irgendetwas vorbereitet zu haben.

Einfaches Zuhören

🎤 Zuhören starten, spielen Sie eine gehaltene Note: die App zeigt die Note, das Tabulatur-Loch (Farbe je nach Technik, entsprechend der gewählten Tonart) und Ihre Genauigkeit (±50 Cent).

Live Noten in die Tabulatur schreiben

„Die Noten in die Tabulatur schreiben": automatische Transkription mit dem echten rhythmischen Wert, von Anschlag zu Anschlag gemessen — eine abgesetzte Viertelnote bleibt eine Viertelnote (Artikulationslücke unter ~40 % des Intervalls wird ignoriert; darüber hinaus wird eine echte Pause notiert; über 4 Schläge hinaus: Atemzug, nichts). Letzte Note früh losgelassen: aufgerundet auf den nächsten vollen Wert. Am Ende des Zuhörens wird der Rhythmus automatisch neu ausgerichtet: geschätztes echtes Tempo, requantisierte Notenwerte, Tempo eingestellt. Optionales Metronom, am Raster ausgerichtet. Ein einziges Strg+Z macht die ganze Sitzung rückgängig.

🎯 Praxisbeispiel — Eine Melodie geht Ihnen nicht aus dem Kopf, ohne dass etwas geschrieben ist: kreuzen Sie „Die Noten in die Tabulatur schreiben" an, deaktivieren Sie das Metronom, wenn Sie völlig frei spielen möchten, klicken Sie auf „🎤 Zuhören starten" und spielen Sie. Beim Stoppen steht Ihre Melodie bereits in „Meine Tabulatur", bei Bedarf korrigierbar. Das funktioniert auch über einen externen Backing Track (YouTube, CD...): deaktivieren Sie einfach das Metronom, damit es nicht mit dem Klang des Stücks kollidiert.

Weitere Anwendungen: ein Bending am Messgerät überprüfen, einen Overblow bestätigen, ein Riff heraushören, das sich von selbst niederschreibt.

📈 Live-Verlauf des Spiels

Klappt sich mit dem Stimmgerät auf (per Klick auf seinen Titel klappbar, 🗑 zum Löschen). Oben das Notensystem (Violinschlüssel): jede Note wird genau zu dem Zeitpunkt gesetzt, zu dem sie gespielt wurde, ausgerichtet mit dem Graphen; ein Klick auf den Verlauf (Notensystem oder Kurve) sendet die Ablesung dieses Punktes an das Stimmgerät (Nadel, Note, Tabulatur, Frequenz, Cent). Unten der scrollende Graph (8 s): Ihre Tonhöhe als gepunktete Linie, farblich wie das Zifferblatt — grün bei ±5 Cent, orange bis ±15, darüber rot. Die farbigen horizontalen Linien sind Ihre Zielnoten (Tabulatur am Rand). Die vertikale Skala ist fest: der Linienabstand bleibt konstant, der Rahmen zentriert sich einfach auf die gespielte Note neu.

Navigation: Klick = Fokus, ←/→ ±1 s (Umschalt: 5 s), Mausrad, Klicken und Ziehen; das Scrollen friert beim Überfahren ein (⏸-Abzeichen), vertikaler Cursor mit präziser Ablesung (Tabulatur, Note, Cent); Ende/Esc kehren zum Live-Modus zurück. Die Schaltfläche ⏸ Einfrieren stoppt das Scrollen stabil, um die Kurve zu untersuchen, ohne die Maus darüber zu halten; ▶ Fortsetzen kehrt zum Live-Modus zurück. ~5 Minuten Verlauf.

🎚 Chromatisches Stimmgerät

Zifferblatt ±50 Cent: grüne Zone ±5 (richtig), orange bis ±15, darüber rot. Geglättete Nadel, Noten-Etikett, das die Farbe der angepeilten Zone annimmt (grün/orange), entsprechende Tabulatur, Frequenz. Das Wort RICHTIG ✓ erscheint nur in der grünen Zone. Beim Anhalten friert die Anzeige ein (🗑 zum Zurücksetzen), und das Modul klappt sich mit dem Verlauf zu. Auf den Tonumfang der gewählten Mundharmonika begrenzt.

🎯 Trainingsmodus: nützlich, um an einem bestimmten Bending zu arbeiten. Aktivieren Sie den Modus und wählen Sie eine Zielnote aus der Liste — nur Bendings, Overblows und Overdraws (die zu übenden Noten). Die Nadel zeigt weiterhin die nächstgelegene Note an (sie bleibt nie am Anschlag stecken), während das ausgeschriebene Urteil relativ zum Ziel gemessen wird: „NICHT TIEF GENUG ↓", „ZU HOCH ↓", und „RICHTIG ✓", wenn Sie es erreichen. Das Urteil existiert nur im Trainingsmodus, und „RICHTIG" setzt außerdem voraus, dass die Nadel in der grünen Zone steht.

Kalibrierung des Kammertons A (440 Hz, ▲▼, 415–466): viele Mundharmonikas sind auf 442–443 Hz gestimmt. Globale, gespeicherte Einstellung: Stimmgerät, Erkennung und Wiedergabe verwenden denselben Kammerton. Kalibrieren Sie zuerst den Kammerton A.

🎯 Tabulatur spielen — geprüfte Übung

Die erwartete Note blinkt blau; spielen Sie sie am Mikrofon in Ihrem eigenen Tempo: richtig → grün, weiter; falsch → rot, erneut versuchen. Abschließende Bilanz: bestätigte Noten, falsche Noten, durchschnittliche Genauigkeit in Cent. Funktioniert mit jeder Tabulatur — kombiniert mit dem Generator: bei jeder Sitzung eine neue, geprüfte Übung.

Einschränkungen der Beta

• Eine Note nach der anderen (keine Akkorde oder gesplitteten Oktaven).
• Klare Noten; angemessene Mindesthaltedauer je nach Tempo; Bewertung bei ±40 Cent (ein zu ungenaues Bending wird nicht transkribiert).
• Dieselbe Note zweimal: deutlich absetzen. Pausen zwischen Noten werden nicht transkribiert.
• Stellen Sie die Tonart der App auf die Ihrer Mundharmonika ein; eine ruhige Umgebung wird empfohlen.

11 bis. Swing-Meter 🎵 (Beta)

Der Swing-Meter misst am Mikrofon Ihr Swing-Verhältnis, während Sie Achtelnoten spielen: 50 % = binär (gerade), 66,7 % = ternär (Swing). Er stützt sich auf die Intervalle zwischen Ihren Anschlägen, was ihn unempfindlich gegenüber Audio-Latenz macht — vor der Nutzung muss nichts kalibriert werden.

Eine Anzeige und ein Urteil in Klartext — PLATZIERUNG OK für ein gerades Ziel, SWING OK für ein Triolen-Ziel — zeigen live, ob Sie im Ziel liegen, und die Meldung bleibt beim Anhalten stehen. Wählen Sie das Ziel (gerade 50 % oder Triole 66,7 %), stellen Sie das Tempo ein (mit der Werkzeugleiste synchronisiert), und lassen Sie das Modul optional eine Übung aus Achteln (2, 4, 6 oder 8) in der gewählten Tonleiter erzeugen — oder „frei", um zu spielen, was Sie möchten. 🗑 setzt das Modul zurück.

12. Exporte

Vier Formate, jedes für einen anderen Zweck.

Export	Inhalt	Verwendung
.json 💾	Alles: Noten, Dauern, Tempo, Tonart, Modi	Zuverlässige Speicherung, Austausch, Archivierung
.mid 🎹	Noten und Dauern, GM-Mundharmonika-Klang	MuseScore, DAW, Backing Tracks
.xml	Exakte Partitur: volle Takte, Bindebögen, Triolen, punktierte Noten — und Akkordsymbole über dem System, wenn „Meine Akkordfolge" ein Raster enthält	MuseScore, Guitar Pro, Sibelius
🖨	Tabulatur, 12 Noten/Zeile, Tonart, Tempo, Datum, Logo	Unterrichtsmaterial, PDF

🎯 Praxisbeispiel — Sie möchten, dass ein Schüler zu Hause genau dieselbe, bearbeitbare Version übt wie im Unterricht: exportieren Sie in .json. Er soll sie nur auf dem Handy oder in einer Musik-App anhören: exportieren Sie in .mid. Sie möchten ihm eine echte Partitur zum Lesen geben: exportieren Sie in .xml und öffnen Sie sie in MuseScore.

13. Häufig gestellte Fragen

• Kein Ton beim ersten Klick (iPhone/iPad): Browser entsperren Audio erst nach der ersten Geste — klicken Sie eine Note an.
• Ändert ein Tonartwechsel meine Noten? Die Tabulatur ändert sich nie; nur Namen und Tonhöhe passen sich an — wie beim Wechsel der Mundharmonika.
• Sitzung verschwunden: die Speicherung ist an diesen Browser gebunden (privates Surfen und Datenlöschung entfernen sie) — exportieren Sie in .json, damit sie erhalten bleibt.
• Offline nutzbar? Ja, vollständig: eigenständige Datei.
• Importiertes MIDI unvollständig: die in der gewählten Tonart unspielbaren Noten werden aufgelistet; die App schlägt die beste Tonart vor.
• Overblows beim Import abgelehnt: nur die Overblows 1, 4, 5, 6 und Overdraws 7, 9, 10 existieren auf einer Standard-Richter-Mundharmonika.
• „Nicht auf der Mundharmonika": die erkannte Note existiert nicht in der gewählten Tonart — überprüfen Sie die Einstellung.
• ⟳ vs. Teilschleife: ⟳ wiederholt, was gespielt wird; bei einem Bereich (Umschalt+Klick) nur die Passage.

14. Effektzeichen und Textexport

✨ Effektzeichen auf einer Note

Im Noten-Editor (Doppelklick auf eine Note) können Sie Effektzeichen hinzufügen, die keinerlei Einfluss auf Rhythmus oder Dauer haben: sie dienen nur dazu, eine Spielabsicht zu notieren.

Wählen Sie zunächst die Position (Vor oder Nach der Note), dann klicken Sie das oder die gewünschten Zeichen an. Eine Note kann mehrere Effekte tragen, davor und/oder danach; jeder bleibt unabhängig.

Zeichen	Effekt
/	Anschlag von unten (leichtes Bending am Anschlag)
\	„Weinende" Note: leichtes Bending am Ende der Note
vib	Vibrato
Wa	„Wahwah"-Effekt mit den Händen
DS	Double Stop (zwei Noten gleichzeitig)
TBS	Tongue Blocking „Slap"
TBO	Tongue Blocking „auf der Oktave"
→	Glissando zur nächsten Note
↔	Triller zwischen zwei Noten

Glissando und Triller werden vom Klang der App nicht wiedergegeben. Die Zeichen erscheinen in der Tabulatur (orange, um die Note herum).

Beim Export: im Text (.txt) ist jedes Zeichen ein separates Element (z. B. DS TBS +4 vib Wa); in MusicXML wird jeder Effekt zu einem eigenständigen lyric, das in MuseScore unter der Note angezeigt wird.

📝 Textexport (.txt)

Die Schaltfläche TXT (Gruppe Datei) lädt die Tabulatur als reinen Text herunter, mit Effektzeichen, unter dem Namen der Tabulatur.

Aplicación web para crear, escuchar y trabajar tablaturas de armónica diatónica de 10 agujeros. Un solo archivo, sin instalación, sin conexión necesaria: abra harmonica-trainer.html en su navegador. La interfaz existe en siete idiomas (banderas en el pie de página de la app, elección memorizada — este manual sigue el mismo ajuste).

💡 Este manual está organizado módulo por módulo, en el orden en que aparecen en la app. Cada sección explica para qué sirve el módulo, cómo usarlo, y propone al menos un caso práctico para empezar de inmediato.

1. Primeros pasos

En la parte superior de la página, una franja deslizante presenta los contenidos de apprendrelharmonica.com; se pausa al pasar el cursor, un clic abre la página. El logotipo del sitio, al pie de la página, también firma las tablaturas impresas.

Cuatro reflejos que conviene tener desde el principio

• Hacer clic en una nota la toca y la escribe a la vez. Cada clic en la armónica virtual toca la nota y la añade a la tablatura — no hace falta buscar un botón «añadir».
• ▶ (o Espacio) reproduce lo escrito. ¿Tablatura vacía? El botón «Probar: …» propone un lick de blues de un compás, distinto cada vez que aparece.
• 💾 Nada que guardar a mano. La app guarda automáticamente en el navegador: cierre, vuelva mañana, su sesión se restaura tal cual.
• 📂 La mayoría de los módulos se pliegan y despliegan con un clic en su título; el esquema de la armónica y «Mi tablatura» permanecen siempre abiertos.

🎯 Caso práctico — Abre la app por primera vez: haga clic en algunos agujeros de la armónica virtual para escuchar el sonido, pulse Espacio para oír lo que acaba de componer, y cierre la pestaña sin guardar nada. Vuelva a abrir la app: su pequeña melodía sigue ahí.

1 bis. Disposición personalizada 🔀

Por defecto, los módulos se apilan en un orden estándar. Si usa sobre todo dos o tres herramientas (por ejemplo el generador de melodías y el taller de ritmo), puede acercarlos para evitar desplazarse por la página cada vez.

• Arrastre cada tarjeta por su asa ⠿: se ajusta a las columnas de la página.
• La barra «Disposición» guarda varias disposiciones con nombre y las recupera desde un menú.
• ↺ vuelve a la disposición original; 💾 exporta sus disposiciones a un archivo reimportable.

Todo se guarda en el navegador, propio de este dispositivo — si cambia de ordenador, exporte su disposición para recuperarla en otro sitio.

2. La notación

La tablatura de la app se lee como una tablatura de papel clásica, con algunos signos adicionales para las alteraciones y las overnotes.

Escritura	Significado
+4 / -4	Soplar / aspirar en el agujero 4
-3', -3'', -3'''	Bend aspirado de 1, 2, 3 semitonos
+8'	Bend soplado (agujeros 8–10)
+6° / -7°	Overblow / overdraw
z	Silencio (para la importación de texto)

El mismo código de colores reaparece en toda la app — en la tablatura, en la armónica virtual, en el trazado del juego en directo: soplado · aspirado · bend · overblow · overdraw. Una vez interiorizado este código, leerá el color antes que el número.

3. La armónica virtual

Es el corazón de la app: una armónica completa, en la tonalidad mostrada encima del esquema. Cada columna alinea, de arriba abajo: overblows, bends soplados, nota soplada, nota aspirada, bends aspirados, overdraws.

• Hacer clic en un número de agujero añade la nota soplada del agujero correspondiente.
• Pasar el cursor sobre una columna la ilumina, para detectar de un vistazo todas las técnicas disponibles en ese agujero.
• Los nombres de notas mostrados siguen la tonalidad y la octava elegidas — cambie la tonalidad, los nombres cambian, pero la ubicación física de los sonidos permanece igual.

3 bis. Keyfinder 🔑

El Keyfinder responde a una pregunta que todo armonicista se plantea tarde o temprano: «¿qué armónica cojo para esta canción?» — o al revés, «¿qué puedo tocar con la armónica que tengo en la mano?». También muestra las notas esenciales de la posición elegida (tónica, terceras, quinta, séptimas) y dónde tocarlas en la armónica.

Caso práctico 1: parto de la tonalidad de la canción

1. Pestaña «Encontrar la armónica»: elija la tonalidad de la canción (p. ej. Do).
2. Elija la posición en la que quiere tocar (p. ej. 2ª posición).
3. El Keyfinder indica qué armónica coger y muestra las notas clave: tónica, tercera mayor, tercera menor, quinta justa, séptima menor, séptima mayor — con su ubicación en la armónica.

Ejemplo: para una canción en Do tocada en segunda posición, el Keyfinder recomienda una armónica en Fa y muestra de inmediato dónde están la tónica, las terceras, la quinta y las séptimas.

Caso práctico 2: parto de la armónica que tengo en la mano

1. Pestaña «Encontrar la tonalidad»: seleccione la tonalidad de su armónica (p. ej. Mi) — se pueden seleccionar varias armónicas a la vez.
2. La herramienta muestra las 12 tonalidades tocables con sus posiciones correspondientes.
3. Elija la posición adecuada al estilo de la canción, y localice después las notas esenciales en el instrumento.

Ejemplo: con una armónica afinada en Mi, toca en Mi en 1ª posición, en Si en 2ª posición, en Fa# en 3ª posición, etc.

Las notas destacadas — y por qué importan

Nota	Papel
Tónica	Nota de referencia principal de la tonalidad
Tercera mayor	Da el color mayor
Tercera menor	Da el color menor / blues
Quinta justa	Nota de apoyo estable
Séptima menor	Color blues / dominante
Séptima mayor	Color jazz / mayor

En resumen: ya parta de la tonalidad de la canción o del instrumento, el Keyfinder le guía en unos pocos clics — gana tiempo y toca más afinado, más rápido.

4. La barra de herramientas

La barra de herramientas agrupa cinco familias de comandos. Aparecen todo el tiempo, así que vale la pena conocerlos de memoria desde el principio.

🎵 Reproducción

• ▶/⏹ (Espacio): reproduce o detiene la tablatura. ⏸ Pausa (tecla P) pausa y recuerda la nota en curso — un segundo clic (o P) retoma exactamente ahí, mientras que ⏹ detiene por completo y olvida la posición.
• Inicio en cualquier punto: haga clic en una nota de la tablatura, ▶ empieza ahí (sin selección, la reproducción vuelve a empezar desde el principio). Reanudar en mitad de la canción salta la anacrusa y la cuenta atrás, y sincroniza la grilla de acordes con el compás que se está tocando.
• ⟳ repite en bucle sin corte — el campo ×N junto a él fija un número de repeticiones (toca N veces y se detiene; vacío = infinito).
• 🎹 Acordes en bloque: junto al campo de repeticiones, toca los acordes del constructor en bloque en lugar de en arpegio.
• ⏱0 Cuenta atrás: el metrónomo solo suena durante la anacrusa (compás 0) y luego calla el resto de la reproducción.
• Tempo 40–240, 🔊 Volumen, ⏱ Metrónomo (tiempo fuerte según el compás: cada 4 o 3 pulsaciones).
• TAP: haga clic al ritmo (ratón) para fijar el tempo — media de los últimos clics, aplicada al tempo general; RESET borra los clics.

🎯 Caso práctico — No conoce el tempo exacto de una canción que quiere trabajar: márquelo con TAP mientras escucha el original en su teléfono, la app deduce el BPM y lo ajusta directamente.

Durante la reproducción, la nota en curso se ilumina en la tablatura y en la armónica — una referencia visual útil para seguir sin perderse.

🏋️ Ejercicios

• 🎼 Generador de melodías (detallado en el § 7).
• 🎶 Constructor de acordes y ♬ Progresiones de acordes (detallados en el § 7 bis).
• 🧩 Estructura de la canción (detallado en el § 7 ter).
• 🎙︎ Sensor de micrófono (prueba) (detallado en el § 8 quinquies) y 👂 Transcripción de oído (detallado en el § 8 ter).
• 🔀 Mezcla de la tablatura (una vez por clic, Ctrl+Z para deshacer).
• ⇅ ascendente y luego descendente.
• SWING (corcheas ternarias: todo ataque que caiga en el «y» del tiempo se retrasa a dos tercios del tiempo).
• 🎲 Duraciones aleatorias.
• +BPM tempo progresivo (detallado en el § 6).

Estos modos se combinan: puede, por ejemplo, mezclar una melodía y activar el swing y el tempo progresivo, todo a la vez.

🎼 Tablatura (visualización)

• TAB / Notas / Do Re Mi: alterna entre la tablatura, los nombres anglosajones (C4, Bb3…) o latinos (Do4, Sib3…).
• Tonalidad (12 armónicas): nombres y altura se adaptan, la tablatura permanece idéntica — es un cambio de visualización, no de contenido.
• ▾8 / ▴8: transpone una octava las notas seleccionadas (o toda la tablatura si no hay nada seleccionado; agujeros equivalentes). Si una nota no tiene equivalente, no se mueve y la app la lista. Selección: Mayús+clic un rango, Ctrl/Cmd+clic una nota individual, ⇄ Invertir intercambia seleccionadas y no seleccionadas.
• 1·3b·5 Grados: muestra debajo de cada nota su grado en la escala de referencia — el botón vecino 🎼 abre el generador para elegir la escala, y la visualización se alinea automáticamente con ella. Las notas fuera de escala aparecen en gris; los arpegios del constructor de acordes muestran en cambio los intervalos del acorde (1, 3b, 5, 7b…).

📁 Archivo

• 📚 Biblioteca: tablaturas con nombre, guardadas en este navegador — cargar, renombrar, eliminar; ⬇ Exportar todo como .json reimportable. Las ventanas se desplazan con el ratón.
• 💾 / 📂: archivo .json completo; 📂 también abre archivos .mid (convertidos a tablatura: duraciones cuantizadas, silencios reconstruidos, tempo aplicado, notas no tocables listadas, mejor tonalidad sugerida) y archivos .xml/.musicxml.
• 📋 Importar una tablatura de texto (detallado en el § 5) · 🎹 MIDI (instrumento GM Harmonica) · XML MusicXML: partitura exacta — figuras y duraciones coinciden siempre, compases completos, ligaduras escritas; MuseScore no reescribe nada. · TXT: exportación en texto plano con los efectos (bends, overnotes…), útil para pegar en un mensaje.
• 🖨 Imprimir: maquetación limpia, fondo blanco, logotipo, 12 notas por línea (PDF mediante «Imprimir a PDF»).

🎯 Caso práctico — Está preparando material de clase para un alumno: construya la tablatura, haga clic en 🖨 Imprimir, luego «Imprimir a PDF» desde el diálogo del navegador. El PDF conserva su logotipo y sigue siendo legible incluso impreso en blanco y negro.

✏️ Edición y ♩ Duraciones

↶/↷ (Ctrl+Z / Ctrl+Y), 🗑 borrar todo, ? ayuda, ! restablece la visualización de las ventanas abiertas (útil si una ventana queda bloqueada o mal colocada fuera de la pantalla).

Hay nueve valores rítmicos disponibles: redonda, blanca, negra, corchea, semicorchea, tresillo, puntillo (+50 %), y tres silencios (1, ½, ¼ de tiempo). La duración elegida se aplica a las próximas notas que introduzca; sobre una selección existente, la modifica directamente.

Notas a caballo entre compases: se dividen en la visualización y se enlazan con ‿ (parte ligada en punteado) — la nota sigue siendo una sola, tocada de un solo soplo; la exportación MusicXML escribe la ligadura.

‿ Ligadura: liga las notas seleccionadas — el signo ‿ se muestra entre ellas. Dos notas ligadas de la misma altura se encadenan en un solo soplo, sin nuevo ataque, y la exportación MusicXML escribe la ligadura de frase. El botón ‿ del editor de notas (doble clic en una nota) hace lo mismo, nota por nota.

5. Importar una tablatura de texto 📋

Útil para recuperar una tablatura encontrada en un foro, en un libro, o enviada por un alumno como mensaje de texto — sin tener que retipearlo todo a mano.

Pegue sus tablaturas (notas separadas por espacios; se aceptan comas, saltos de línea, |): +4 -4 +5 -5 +6 -6' -6 z +6 -5 +5 -4 +4. El + es opcional, z inserta un silencio, los elementos no válidos se ignoran y se listan, la importación se añade a continuación de lo que ya exista.

6. Trabajar un pasaje

Dos herramientas para progresar en un punto concreto sin tener que repetir toda la pieza cada vez.

Bucle parcial

Haga clic en la primera nota, Mayús+clic en la última: el rango se resalta, ▶ reproduce solo eso, ⟳ lo repite en bucle. Un clic sin Mayús lo desactiva. El rango también sirve para cambiar todas las duraciones o eliminar de golpe.

🎯 Caso práctico — Una frase de dos compases le resulta difícil en un solo más largo: selecciónela (Mayús+clic), active ⟳, y déjela repetirse mientras la trabaja, sin volver a tocar nunca el resto de la pieza.

Tempo progresivo (+BPM)

Ajuste el paso (1–20 BPM por pasada) y el máximo: en cada vuelta del bucle el tempo sube y se muestra. También funciona en un rango seleccionado: el tempo sube en cada pasada de la selección, incluso cuando el acompañamiento 🎹 está activo.

Ejemplo clásico: 4 notas difíciles, inicio a 60 BPM, paso de 4, máximo 120 — empieza despacio y la app acelera automáticamente tras cada pasada exitosa, sin que usted tenga que tocar el tempo.

7. Generador de melodía 🎼

El generador compone melodías coherentes, no simples sucesiones de notas al azar: las escalas se agrupan por posición — mayor y pentatónica mayor (1ª); blues, mixolidia, pentatónica (2ª); pentatónica menor, blues, dórica (3ª); menor natural, pentatónica menor (4ª); frigia, pentatónica menor, menor natural con bends (5ª); lidia, mayor con bends (12ª). Cuatro niveles (Principiante, agujeros 4–8 → Experto con overblows), sobre 1, 2 o 4 compases. La melodía termina siempre en la tónica, salvo que marque «No terminar en la tónica».

La ventana permanece abierta mientras trabaja: regenere en bucle (🎼), escuche, ajuste, sin perder el control del resto de la app. Ciérrela con ✕ o Cancelar; Ctrl+Z restaura la tablatura anterior si el resultado no le convence.

Mis ajustes — justo debajo de «Sorpréndeme», guarde con un nombre toda la configuración de la ventana y recupérela con un clic: escala, nivel, extensión, longitud, fraseo, compás, notas por compás, duraciones marcadas, seguimiento de la progresión y los dos deslizadores de inyección. 💾 guarda (reutilizar un nombre existente sustituye el ajuste anterior en vez de duplicarlo), 🗑 elimina el ajuste seleccionado, ⬇ exporta todos sus ajustes en .json y 📂 los reimporta. Además, los ajustes de su última generación se recuerdan solos: al abrir de nuevo la app, la ventana aparece tal como la dejó.

Con un clic, para ir rápido

En la parte superior del generador, el botón Sorpréndeme ajusta los menús por usted (los verá moverse) y genera de inmediato: un clic, una melodía. Vuelva a hacer clic para un nuevo sorteo. Los ajustes detallados quedan debajo para quien quiera elegir escala, posición y nivel con precisión.

🎯 Caso práctico — Tiene 5 minutos antes de una clase y quiere un ejemplo rápido que mostrar a un principiante: haga clic en «Sorpréndeme» varias veces seguidas hasta obtener algo sencillo y cantable, sin tocar ningún ajuste.

Leer y tocar lo que se acaba de generar

El recordatorio de notación «📖 ¿Cómo leer la tablatura?» (soplado, aspirado, bends, código de colores) está disponible en la ayuda ? del menú Edición. En cuanto hay notas, aparece una fila de iconos bajo la tablatura: ▶ (rojo) reproduce la tablatura, ⏹ (verde) detiene, el icono de micrófono (azul) lanza el modo 🎯 (toca al micrófono, la app valida nota a nota) y + añade o inserta una nota — tras la nota seleccionada, o al final — abriendo el editor; vuelva a hacer clic para añadir más, las barras de compás se recalculan.

Fraseo: dar forma a la melodía

Más allá de una melodía «nota a nota», puede imponer un tipo de fraseo: Pregunta – Respuesta (dos partes que se responden), Arco (subida y luego bajada), Valle (bajada y luego subida), Onda (ondulaciones sucesivas), Subida continua o Bajada continua (la frase atraviesa el registro en un solo sentido), Jazz ligero (acercamientos cromáticos a ciertas notas) o Bebop completo (enclosures, corcheas). «Ninguno» deja a la app en libertad.

Subida y Bajada imponen una dirección de conjunto — no es una escala: la línea va del grave al agudo (o al revés) permitiéndose pequeños retrocesos, lo que la mantiene musical. Los dos menús nota grave → nota aguda deciden qué parte de la armónica se recorre. Como la última nota cae en la tónica, puede retroceder un poco: marque «No terminar en la tónica» para mantener la dirección hasta el final.

Valle es el arco al revés: la frase parte del agudo, se hunde y vuelve a subir. Onda encadena cambios de dirección —una ondulación cada dos compases—: es el fraseo que hace trabajar los giros, ahí donde muchos alumnos se dejan llevar en un solo sentido.

Blues AAB: la forma cantada, sobre tu rejilla

El fraseo Blues AAB escribe un chorus de blues tal como se canta: la frase A ocupa los compases 1 a 4, A' la repite en los compases 5 a 8 sin moverse mientras la rejilla pasa al IV —de ese desfase nace la tensión—, y luego B responde y concluye en los compases 9 a 12. Cada grupo de cuatro termina con una respiración: la frase se posa sobre un apoyo en el compás 4 y en el 8, y deja sitio, como un cantante deja responder al instrumento. B es más densa que el enunciado, y las últimas notas descienden hacia la tónica.

Este fraseo requiere una rejilla de 12 compases y la opción «Seguir Mi progresión» marcada: lo exige la propia forma. Si falta alguna de las dos, la app te lo dice en lugar de generar otra cosa. En A' solo se retoca una nota: la 7ª mayor que cae sobre un acorde de séptima (el mi sobre un F7, en do) baja un semitono; las blue notes se conservan tal cual.

🎯 Caso práctico — Carga el preset Blues de 12 compases desde «Progresiones de acordes», envíalo a «Mi progresión», marca «Seguir Mi progresión» y elige Blues AAB: obtienes un chorus completo y estructurado para que un alumno lo lea o lo saque de oído.

Pregunta – Respuesta funciona ahora sobre 2 compases además de 4: el segundo compás retoma el ritmo y el inicio del primero, y la pregunta queda suspendida en la dominante. Un lick corto y cuadrado, sin pasar por 4 compases.

🎯 Caso práctico — Trabajar el ámbito con un alumno: Bajada continua, 4 compases, nivel Intermedio, ámbito reducido a los agujeros 4 a 8 — obtiene una frase que vuelve a bajar todo el registro elegido sin ser una simple escala descendente.

Compás, duraciones y ámbito

Elija la indicación de compás — 4/4, 3/4 (vals), 6/8 o 12/8: toda la app la sigue (barras de compás, metrónomo, exportaciones MIDI y MusicXML). Longitud: 1, 2 o 4 compases.

Restrinja las duraciones de nota empleadas marcando solo los valores deseados — redonda, blanca, negra, negra con puntillo, corchea, semicorchea, tresillo o tresillo de negras.

Ejemplo: solo redonda para una nota por compás, o solo blanca para dos notas por compás — ideal para un fraseo muy simple o un primer nivel. Todo marcado = libre.

Si el número de notas solicitado no basta para llenar el compás — 4 corcheas en 4/4, por ejemplo — la app completa con silencios en lugar de rechazar: se reparten por el compás, no se amontonan al final, para dejar respirar a la melodía.

Dos menús nota grave → nota aguda limitan la melodía generada a la porción de armónica que elija, entre las notas disponibles para la escala y el nivel seleccionados — práctico para permanecer en una zona precisa del instrumento. Se repueblan automáticamente al cambiar de escala o de nivel.

Número de notas por compás. Fije un máximo: en 6, la app usa hasta 6 notas, no necesariamente 6. Marque «exactamente ese número» para imponer el recuento exacto.

Generar sobre una progresión de acordes

Si marca «Seguir Mi progresión», la escala elegida se aplica sobre los acordes de su progresión (módulo «Mi progresión»), sea cual sea su tonalidad — bueno para probar sonoridades inesperadas (cuidado con las disonancias). Cada acorde conserva su propia duración (compás completo, medio compás…): la melodía generada se ajusta a ella automáticamente, sin ajuste adicional. Los deslizadores de inyección añaden entonces un porcentaje de notas fuera de escala y de silencios (respiros de fin de frase).

El menú «Notas usadas sobre la progresión» decide entre escala y acordes. Libre mezcla ambas, gobernado por la inyección — el comportamiento original, que puede dejar pasar notas fuera de escala (la tercera mayor de un acorde de blues, por ejemplo). Escala estricta y Solo notas comunes se mantienen ambas estrictamente dentro de la escala elegida, sin excepción — su diferencia está en cómo se elige la nota, no en lo que está disponible. En Escala estricta, el acorde del momento no influye en absoluto: la melodía sigue la escala sin tenerlo en cuenta. En Solo notas comunes, cuando una nota de la escala resulta ser también una nota del acorde, la app tiene la posibilidad de preferirla — sobre todo en los primeros tiempos —, sin que sea sistemático ni obligatorio: es una opción posible entre otras, no una imposición. Ambas opciones desactivan el deslizador de inyección, que deja de tener utilidad.

🎯 Caso práctico — Escala de blues, 2ª posición, sobre una rejilla de blues: en modo Libre, notas de la tercera mayor del acorde se cuelan en la melodía; cambia a Escala estricta para mantener el color blues de principio a fin, sea cual sea el acorde.

Mis modos 🧬: crear sus propias escalas

Módulo plegable para crear sus propios modos — nombre, posición (1ª a 12ª), grados marcados entre los 12 semitonos — memorizados en el navegador y disponibles (★) en los selectores de escala del generador, de los grados 1·3b·5 y del medidor de swing. ✎ edita un modo, 🗑 lo elimina.

En la ventana del generador, junto al selector de escalas: 🗑 retira la escala mostrada de la lista (elección memorizada), ↺ vuelve a mostrar todas las escalas; ⬇ exporta sus modos a un archivo .json y 📂 los reimporta.

7 bis. Acordes y progresiones 🎶

Tres módulos complementarios para trabajar con acordes en lugar de notas sueltas: construir un acorde aislado, encadenar una grilla ya preparada, y tocar/exportar la grilla en curso.

🎶 Constructor de acordes

Grupo Ejercicios: elija la fundamental, la calidad (de las tríadas a las 13ª), eventuales alteraciones/tensiones (b5, #5, b9, #9, #11, b13 — activas según la calidad), una nota de bajo opcional (acorde «slash», p. ej. C/E) y la forma del arpegio (ascendente, o ascendente-descendente).

El selector Compás (4/4, 3/4, 6/8, 12/8) fija la métrica antes de construir — se comparte con el generador de melodías y las progresiones; si la tablatura ya contiene notas, se pide confirmación, ya que las barras de compás se recalculan. Elija directamente la duración del acorde, en tiempos — 1, 2 o 4 en 4/4; 1 o 3 en 3/4; 1½ o 3 en 6/8; 3 o 6 en 12/8 — el mismo selector que en «Progresiones de acordes» y en «Estructura de la canción».

Confirmar inserta el acorde en arpegio al final de la tablatura — posición más grave tocable, overblows/overdraws incluidos — y la ventana permanece abierta para encadenar varios acordes seguidos; Eliminar el último retira el último añadido. El nombre del acorde aparece como insignia al inicio de su línea, y 🔀 y 🎲 actúan dentro de cada acorde sin romper sus compases. En la reproducción, 🎹 (grupo Reproducción) pasa a acordes en bloque: cada acorde suena en bloque, con sonido de piano, en lugar del arpegio.

♬ Progresiones de acordes (preajustes)

Ventana movible del grupo Ejercicios: una veintena de progresiones clásicas (pop, jazz, blues de 12 compases, cadencias menores…), transponibles a las 12 tonalidades y en mayor/menor — marque «Solo armadura» para cambiar solo la armadura mostrada sin transponer los acordes.

La progresión es editable antes de insertarla: haga clic en un acorde para cambiar su fundamental, su calidad, sus tensiones, su nota de bajo, y su duración propia (1, 2 o 4 tiempos según el compás) — cada acorde conserva su duración, por lo que puede mezclar un compás completo y dos medios compases en la misma grilla. El selector Compás de la ventana fija la métrica, de la que se deriva la duración de un compás completo: 4 tiempos en 4/4, 3 en 3/4, 6 en 12/8. ◀ ▶ mueven un acorde, ✕ lo retira, + añade uno. Alternancia de visualización Nombres / Grados (numerales romanos).

💾 guarda su progresión en la lista de preajustes (★, 🗑 para eliminarla), ⬇ exporta sus progresiones a .json y 📂 las reimporta. → Mi progresión envía la grilla construida al módulo de abajo, sin pasar por la tablatura. Sus estructuras de canción guardadas (módulo 🧩, § 7 ter) también aparecen en esta lista, con el prefijo 🧩: seleccionarlas aplana toda la estructura en la grilla, conservando duraciones y tonalidades por parte.

♬ Mi progresión

Este módulo muestra la grilla recibida: cada ficha indica el nombre del acorde, con su duración entre paréntesis si difiere de un compás completo (p. ej. G7 (2)). Las duraciones se reconocen y respetan automáticamente, sea cual sea su origen — preajustes, constructor (vía la tablatura), o envío de la tablatura a este módulo — sin ningún ajuste manual.

• ♬ Acompañar la reproducción: la grilla suena al piano durante la reproducción de la tablatura, cada acorde en su posición y duración reales.
• 🪟 Acorde actual: abre una pequeña ventana movible, siempre en primer plano, que muestra en grande el acorde en curso junto con el siguiente — práctico para seguir la grilla sin quitar la vista de su armónica.
• → Tablatura: convierte la grilla en arpegios en la tablatura, un grupo por acorde, cada uno con su propia duración.
• 💾 🎹 XML TXT: exportan solo la grilla — JSON, MIDI (acordes en bloque), MusicXML (acordes y símbolos escritos encima del pentagrama, nunca como notas), texto (nombres de acordes).
• 🗑: vacía la progresión.

🎯 Caso práctico — Está enseñando una grilla de blues a un alumno por videollamada: envíe un preajuste de blues de 12 compases a «Mi progresión», abra 🪟 Acorde actual, y mantenga la ventana visible mientras el alumno toca por encima — siempre sabe dónde está, sin tener que leer toda la grilla.

En la cabecera de «Mi tablatura», el botón → Mi progresión hace el camino inverso: relee los arpegios de acordes presentes en la tablatura (construidos vía 🎶) y reconstruye la grilla en «Mi progresión», duraciones incluidas. Los iconos 💾 🎹 XML TXT justo al lado son atajos hacia las exportaciones de la melodía completa — los mismos que los de la barra de herramientas principal.

7 ter. Estructura de la canción 🧩

Este módulo sirve para construir la grilla de acordes completa de una canción, parte por parte, en lugar de una única grilla uniforme — útil en cuanto una canción tiene una estrofa y un estribillo con acordes distintos.

Ventana movible (botón 🧩, grupo Ejercicios): Intro, Estrofa, Estribillo, Puente, Solo, Break, Transición, Final, o una parte Personalizada — cada tipo tiene su propio color, reflejado como borde en la tarjeta. Añadir una parte crea una tarjeta y la selecciona de inmediato; su nombre es editable, su tonalidad y su modo se ajustan en el editor de abajo y transponen todos sus acordes a la vez.

Construir la grilla de una parte

La grilla de cada parte se construye con el mismo constructor de acordes que 🎶 (§ 7 bis): + abre el constructor, Confirmar añade el acorde a la parte y la ventana permanece abierta para encadenar más. Después, hacer clic en una ficha de acorde reabre el constructor precargado con ese acorde para modificarlo (fundamental, calidad, duración…) sin tocar el resto de la grilla; la pequeña ✕ a la derecha de la ficha lo retira; y los + discretos entre fichas insertan un acorde olvidado en ese punto exacto — inserciones sucesivas encadenadas en el orden en que las escriba.

Reorganizar y gestionar las partes

• ◀ ▶ mueven una parte un paso, o tome su asa ⠿ para arrastrarla y soltarla donde quiera (un borde azul indica la inserción antes o después de la fila sobre la que pase el cursor).
• ⧉ duplica una parte, 📋 la copia y 📥 Pegar la añade al final de la estructura, 🗑 la elimina (se pide confirmación).
• ↺ Vaciar todas las partes de un clic (se pide confirmación): sus estructuras guardadas no se ven afectadas.

💾 Guardar una estructura con un nombre: se une a la lista desplegable (recargar una estructura pide confirmación si ya hay otra en curso), 🗑 justo al lado la elimina de la lista. ⬇ exporta todas sus estructuras guardadas a .json, 📂 las reimporta. Sus estructuras guardadas también aparecen, con el prefijo 🧩, en la lista de «Progresiones de acordes» (§ 7 bis): seleccionarlas ahí aplana toda la grilla, conservando duraciones y tonalidades por parte.

Generar una melodía sobre una parte concreta

🎲 Generar una melodía sobre una parte (si contiene acordes): el generador de melodía 🎼 compone sobre su grilla, en su tonalidad, con los ajustes actuales del generador (nivel, escala, fraseo…), e inserta el resultado exactamente en el lugar de esa parte en «Mi tablatura» — el resto de la tablatura no se toca; regenerar una parte la sustituye, no se añade.

🎯 Caso práctico — Está construyendo una canción con Intro / Estrofa / Estribillo / Solo: genere una melodía tranquila sobre la Intro, luego una más técnica solo para el Solo, sin tocar nunca las otras dos partes.

→ Mi progresión aplana la estructura entera, en el orden de las partes, hacia el módulo del § 7 bis — mismo camino que los preajustes.

Exportaciones dedicadas: TXT produce una grilla imprimible, partes nombradas, compases alineados en columnas; XML produce un MusicXML donde cada parte empieza en una nueva línea (marca de parte y armadura), con los símbolos de acordes en notación internacional encima del pentagrama — el pentagrama queda vacío (silencios ocultos) si «Mi tablatura» está vacía, o retoma su melodía si contiene una.

8. Edición fina

Una vez colocada una melodía — generada, importada, o introducida nota a nota —, así se retoca con precisión.

Vista general de la barra de comandos

De arriba abajo, para qué sirve cada control de la cabecera:

• ⠿ mueve el módulo dentro de la página.
• Ma tablature: título del módulo; 18 elementos · 4 compases: contador de notas/silencios y compases, actualizado en tiempo real.
• ▼8 / ▲8: baja / sube toda la selección una octava (toda la tablatura si no hay selección).
• Anacrusa: declara el primer compás como anacrusa.
• ▶ icono rojo arriba a la derecha: abre el vídeo tutorial del módulo.
• 💡 aviso: recuerda el doble clic para editar una nota.
• ▶ / ■ / 🎤 / +: reproducir, detener, modo micrófono, añadir una nota.
• ⇄ Invertir: invierte la selección (aspirado ⇄ soplado).
• ✕ Nota: borra la última nota introducida (y otras acciones sobre la nota seleccionada).
• 🗑 Todo: borra toda la tablatura.
• ⇅ Seguir: activa/desactiva el desplazamiento automático durante la reproducción.
• ♫ Arpegios: alterna el modo arpegios.
• Silencio: silencia el sonido de la reproducción.
• → Mi progresión: cambia al módulo de progresión de acordes vinculado.
• 💾 / 🎹 / XML / TXT: guarda la tablatura, exporta a MIDI, a MusicXML, a texto.
• ⚠ Completar el compás: señala un compás incompleto por corregir.
• Número de compás (columna izquierda): ubica el compás en la rejilla.
• Casilla de nota: celda, duración y número de celda — doble clic para editarla (altura, duración, silencio).

Selección y eliminación

Clic = selección (las nuevas notas se insertan después); ⌫/Supr elimina; ←/→ mueve la selección. Barras de compás automáticas y numeradas (4/4 o 3/4 según la indicación elegida en el generador); el contador muestra elementos y compases.

El editor de notas (doble clic)

Doble clic en una nota abre un editor completo: cambiar el agujero (1–10), la técnica (solo se ofrecen las notas realmente tocables en ese agujero, con su color), la duración y el puntillo, convertir la nota en silencio (y viceversa), o eliminarla.

Completar, duplicar, borrar un compás

⚠ Completar el compás: cuando el último compás está incompleto, este botón aparece encima de la tablatura. La app propone tres finales posibles dentro de la escala actual — elija uno, se añaden las notas y el compás cuadra.

Duplicar o borrar un compás. Cada línea de la tablatura corresponde a un compás. Los dos pequeños botones al final de la línea permiten duplicarlo (se inserta una copia justo después) o borrarlo con un clic.

Transponer por octava

Octavas ±8. Si las alturas lo permiten, ▾8 / ▴8 bajan o suben la selección (o toda la tablatura) una o dos octavas; una nota sin equivalente no se transpone.

Seguir los acordes durante la reproducción

⇅ Seguir y 🎵 Arpegios. Cuando hay una progresión presente en «Mi progresión», sus arpegios de acordes pueden rodearse de un borde verde durante la reproducción: ⇅ Seguir hace desplazarse la tablatura hacia ellos (desactívelo para desplazarse usted mismo), 🎵 Arpegios los hace audibles junto con su acorde (desactívelo para conservar solo el piano).

¿De dónde vienen las notas de la tablatura?

Ahí se muestran las notas procedentes de: sus clics en el esquema, el micrófono (módulo Reconocimiento de notas o Sensor de micrófono), el generador de melodía, la biblioteca, el botón «Tablatura» de «Mi progresión», el botón + del módulo, y el botón «Probar».

Armadura de tonalidad (para las exportaciones)

La armadura de las exportaciones es automática: sigue la tónica de la melodía generada según su posición, en mayor o menor — así, una pentatónica menor en 3ª posición sobre una armónica en Do da Re menor (un bemol), y no la armadura de la armónica. Sin melodía generada, es la tonalidad mayor de la armónica. Aparece en el primer compás del MusicXML (con el modo) y en el MIDI — MuseScore muestra una partitura limpia.

Anacrusa

Introduzca su anacrusa al principio de la tablatura, silencios de cuadre incluidos — por ejemplo dos silencios seguidos de dos corcheas — y haga clic en Anacrusa en la cabecera del módulo: el primer compás se convierte en el compás 0, marcado con un borde punteado. Vuelva a hacer clic para anularlo. Sus notas se editan como todas las demás (duración, doble clic, arrastrar y soltar). En la reproducción, el compás 0 suena una sola vez al principio: el bucle ⟳ solo repite el cuerpo, y el acompañamiento de «Mi progresión» no entra hasta el compás 1. Con el metrónomo activado, los tiempos vacíos previos a la anacrusa se cuentan atrás — y sin anacrusa, dispone de una cuenta atrás de un compás completo al inicio. La exportación MusicXML escribe una anacrusa real (compás 0 acortado, silencios iniciales retirados); el MIDI conserva el cuadre exacto. Una nota a caballo sobre la barra permanece en el cuerpo.

8 bis. Dictado musical 🎧 (beta)

Úselo para trabajar el oído puro: la app toca algo, usted debe reconocerlo y volver a tocarlo sin verlo escrito.

Cómo funciona

Bajo el afinador: elija de 1 a 6 notas y el nivel — Principiante (agujeros 4–6), Intermedio (notas naturales), Avanzado (bends, sin overnotes), Experto (todo incluido). 🎲 toca una frase cantable (intervalos ≤ quinta, sin repetición), en la tonalidad actual. ▶ Reescuchar a voluntad; 🎤 Responder al micrófono: cada nota correcta llena su casilla, una equivocada parpadea en rojo y cuenta como error. Revelar muestra la solución. Nunca escribe en su tablatura.

Puntuación, estadísticas e insignias

Cada dictado logrado da una puntuación = notas × nivel × 100, menos 20 por error y 5 por reescucha más allá de la primera. Bajo el módulo: dictados tocados, sin fallos, récord, acumulado y racha en curso (reiniciables con ↺). Siete insignias por desbloquear — Oído de bronce/plata/oro (10/50/100 dictados), Sin fallos y Oído absoluto (5 y 10 sin fallos seguidos), Virtuoso (un dictado Experto sin fallos), Maestro del soplo (más de 1000 puntos). Todo guardado en el navegador, sin conexión.

🎯 Caso práctico — 5 minutos antes de dormir, sin armónica a mano para leer una partitura: lance un dictado de nivel Principiante, toque al micrófono en su armónica de mesilla, y vea crecer su racha de dictados sin fallos noche tras noche.

8 ter. Transcripción de oído 👂 (beta)

Parecido al Dictado musical, pero orientado a la escala y posición más que a notas aisladas — útil para acostumbrar el oído a un color de escala concreto.

Cómo funciona

Botón 👂 (grupo Ejercicios): la app toca algunas notas de una escala/posición de su elección (sus modos ★ incluidos) sin mostrarlas. Ajuste el nivel y el número de notas (2–16), reescuche a voluntad, y luego reconstruya la frase en la ventana: 🎤 al micrófono — cada nota tocada se convierte en una pastilla — o a mano (sintaxis +4 -4 -3' +6°; clic en una pastilla para retirarla, ⌫ para borrar todo). Confirmar muestra la solución debajo, verde/rojo nota por nota: es correcto lo que suena correcto (-2 ≡ +3). Nunca toca su tablatura.

Puntos e insignias

Puntuación = notas correctas × nivel × 100, −20 por error, −5 por reescucha más allá de la primera, contado en la primera validación del sorteo. Un nivel cada 1000 puntos; cinco insignias (primer sin fallos, 10 y 50 transcripciones, 5 sin fallos seguidas, sin fallos en Experto); reinicio con ↺. Guardado en el navegador, sin conexión.

8 quater. Taller de ritmo 🥁 (beta)

Trabaja el ritmo independientemente de la afinación — perfecto para alumnos que tocan afinado pero «descolocados» respecto al tiempo, o al revés.

Cómo funciona

Botón 🥁 (grupo Duraciones): la aplicación genera un ritmo de un compás 4/4 según el nivel — hasta ♪♬♬ y ♬♬♪, la síncopa ♬♪♬, silencios, tresillos y grandes síncopas — y lo toca con metrónomo sobre la fundamental (tempo limitado a 60-100). Tras una cuenta previa de un compás, reprodúzcalo: 🎤 con el micrófono (melodía o una sola nota, separando bien los ataques) o 👆 tocando (barra espaciadora o botón). Corrección figura a figura (verde/rojo), ataques de más señalados; la latencia se compensa automáticamente — solo cuenta la colocación rítmica.

Puntos e insignias

A tiempo × nivel × 100, −20 por figura perdida, −10 por ataque de más, −5 por reescucha más allá de la primera; un nivel cada 1000 puntos, doce recompensas, puesta a cero con ↺. Se refieren al número de ritmos tocados (1, 3, 10), a los sin fallos (1, 3, 10), a los sin fallos seguidos (2, 5), a los logrados a la primera escucha (3) y a los logrados en cada nivel — Intermedio, Avanzado y Experto, 3 cada uno, sin acumularse nunca de un nivel a otro. El modo de respuesta no cuenta: micrófono y tap valen exactamente lo mismo. Se guarda en el navegador, sin conexión.

🎯 Caso práctico — Un alumno tiende a tocar las corcheas adelantadas: ajuste el nivel a Principiante, hágale tocar (👆) en lugar de al micrófono al principio, para aislar el problema rítmico sin que interfiera la afinación.

8 quinquies. Sensor de micrófono (prueba) 🎙︎

Botón 🎙︎? (barra de herramientas): un paso de verificación antes de escribir nada en la tablatura. Nada cambia hasta que usted valide.

🎤 Armar el sensor, inicie la reproducción (▶) y toque por encima del acompañamiento: cada ataque detectado aparece en la lista con la posición tocada, la casilla prevista, la nota, el agujero correspondiente en la tablatura y el desfase en milisegundos. La Rejilla (negra, corchea o semicorchea) fija la precisión de cuantización buscada.

Calibrar la latencia

Entre el momento en que el sonido sale de la armónica y el momento en que el micrófono lo hace llegar a la aplicación, siempre hay un pequeño retraso: la latencia. Sin corregir, distorsiona todo lo relacionado con el ritmo — el Taller de ritmo o el modo 🎯 «Tocar la tablatura» pueden juzgar una nota como «tarde» aunque se tocara justo a tiempo, y la escritura automática mediante ✍ Escribir en la tablatura… coloca notas y duraciones ligeramente descolocadas. El medidor de swing también puede verse un poco afectado, ya que se basa en los intervalos de tiempo entre sus notas. Mientras no use un ejercicio cronometrado ni la escritura automática, la latencia no importa en absoluto.

⏱ Prueba de latencia (la más sencilla, hágala primero):

1. Haga clic en ⏱ Prueba de latencia.
2. Tras una breve cuenta atrás, el metrónomo toca 8 clics solo, sin melodía.
3. Toque una sola nota limpia y separada en cada clic — no importa el agujero, lo importante es un sonido limpio, justo a tiempo.
4. Tras los 8 clics, la aplicación compara cada uno de sus ataques con el clic correspondiente y calcula el desfase mediano.

El resultado se muestra (p. ej. «8 ataques · latencia mediana 42 ms») y el campo Latencia (ms) se rellena automáticamente — nada más que hacer. Ajuste memorizado para toda la aplicación.

⌁ Calibrar (para afinar, en condiciones reales):

1. 🎤 Arme el sensor, inicie una reproducción real (▶) y toque normalmente por encima.
2. Cada nota tocada se añade a la lista, con su propio desfase.
3. Haga clic en ⌁ Calibrar: la aplicación toma el desfase mediano de esta toma y lo añade a la latencia ya ajustada.

Repita esto en distintas condiciones (con o sin auriculares, otro micrófono, otra sala) para afinar aún más.

Swing (posición del «y»): ajustable a mano, o deducido de lo que acaba de tocar con ◱ Medir el swing. No tiene relación con la latencia — la Rejilla y el Swing solo ajustan la precisión de cuantización y el feeling ternario buscados.

Grabar una melodía o una improvisación en tablatura

El sensor solo mide sus ataques respecto al reloj de la propia reproducción ▶ de la aplicación: para que capture algo, una reproducción debe estar en marcha mientras usted toca — aunque solo contenga silencios.

Caso 1: en solitario, con el metrónomo

1. Elija la tonalidad de su armónica en el esquema de la armónica.
2. Abra el Sensor de micrófono y ármelo (🎤 Armar el sensor).
3. Rellene «Mi tablatura» con compases vacíos (solo silencios), al tempo deseado — tantos compases como necesite.
4. Inicie la reproducción ▶ de estos compases silenciosos: es ella la que hace sonar el metrónomo y da al sensor su referencia de tiempo.
5. Toque su melodía por encima, siguiendo el clic.
6. Haga clic en ✍ Escribir en la tablatura… (detalle más abajo).

Caso 2: al mismo tiempo que un vídeo de YouTube

Mismo procedimiento que el caso 1, con una restricción adicional: en el paso de reproducción, inicie el vídeo de YouTube y la reproducción de los compases silenciosos al mismo tiempo, a mano, lo más cerca posible el uno del otro. Después toca siguiendo el vídeo — el metrónomo de la aplicación ya solo sirve para hacer funcionar el reloj interno del sensor.

Esta sincronización manual funciona muy bien a tempos lentos: un tiempo dura más, así que un pequeño desfase de sincronización representa solo una fracción minúscula del tiempo y la nota sigue cayendo en la casilla correcta. A tempos rápidos, el mismo desfase pesa mucho más, y aumenta el riesgo de que la nota caiga en la casilla vecina.

✍ Escribir en la tablatura… abre «Validar la toma»: una comparación compás por compás, ✓ conserva su toma o ✕ conserva la tablatura original (atajos Conservar todo / Rechazar todo). Nada se escribe antes de Aplicar — y un solo Ctrl+Z lo deshace.

9. Atajos de teclado

Teclas	Acción
1–0	Nota soplada, agujeros 1 a 10
Mayús+1–0	Nota aspirada
Espacio	Reproducir / Detener
P	Pausa / Reanudar en la nota actual
← / →	Selección anterior / siguiente
Supr	Eliminar la selección (o la última nota)
Mayús+clic	Selección de un rango
Ctrl+Z / Y	Deshacer / Rehacer

Funciona en teclados AZERTY y QWERTY.

10. Grabación de audio 🎙 (beta)

Para conservar un rastro sonoro de su interpretación, sin que se convierta en tablatura — solo un archivo de audio para volver a escuchar o enviar.

Nombre el archivo, elija el micrófono (el del sistema por defecto), ⏺ y luego ⏹: aparece un reproductor, ⬇ descarga, 🗑 Borrar elimina la grabación. Formato webm/opus mono (≈ 1 MB/min), reproducible en cualquier sitio.

🎯 Caso práctico — Inicie la reproducción en bucle de un ejercicio, comience a grabar, toque por encima dos o tres veces, deténgase, y luego escúchese comparando con el original: una excelente forma de detectar sus propios defectos sin un profesor al lado.

10 bis. Ejercicios a partir de un vídeo 🎯 (beta)

El módulo inverso del anterior: en lugar de partir de una escala para generar un ejercicio, parte de un backing track y la app propone las posiciones para trabajar sobre él.

Elija una de sus canciones en la lista desplegable (primero sus vídeos, luego la biblioteca) — tonalidad, modo, estilo y tempo se rellenan solos y el vídeo se muestra. En cuanto toque Tonalidad o Modo, la lista se reduce a los backing tracks de esa tonalidad en ese modo y su etiqueta muestra el recuento; ✕ Mostrar todo vuelve a la lista completa. O, para un vídeo cualquiera, pegue su enlace de YouTube e indique a mano su tonalidad, su modo, su estilo y su tempo; la app propone entonces dos de sus backing tracks correspondientes.

Para cada posición listada (armónica + escala), un botón carga la armónica y genera de inmediato un ejercicio en esa posición y tonalidad. Elegir un backing track preajusta el generador 🎼 a la primera posición, en 1 compás.

11. Reconocimiento de notas 🎤 (beta)

El módulo más versátil de las herramientas de micrófono de la app: sirve tanto para verificar su afinación en directo como para transcribir automáticamente una melodía que toca, sin tener nada preparado de antemano.

Escucha simple

🎤 Iniciar la escucha, toque una nota sostenida: la app muestra la nota, el agujero en la tablatura (color según su técnica, según la tonalidad seleccionada) y su afinación (±50 cents).

Escribir las notas en la tablatura en directo

«Escribir las notas en la tablatura»: transcripción automática con el valor rítmico real, medido de ataque a ataque — una negra separada sigue siendo una negra (el hueco de articulación se absorbe por debajo de ~40 % del intervalo; más allá, se anota un silencio real; más allá de 4 tiempos, respiración, nada). Última nota soltada pronto: redondeada al valor completo superior. Al final de la escucha, el ritmo se recalibra automáticamente: tempo real estimado, duraciones recuantizadas, Tempo ajustado. Metrónomo opcional acompasado con la rejilla. Un solo Ctrl+Z deshace toda la sesión.

🎯 Caso práctico — Una melodía se le queda en la cabeza sin nada escrito: marque «Escribir las notas en la tablatura», desmarque el Metrónomo si quiere tocar completamente libre, haga clic en «🎤 Iniciar la escucha» y toque. Al detenerse, su melodía ya está en «Mi tablatura», lista para corregirse si hace falta. También funciona sobre un backing track externo (YouTube, CD...): basta con desmarcar el metrónomo para que no choque con el sonido de la canción.

Otros usos: verificar un bend en el medidor, confirmar un overblow, transcribir un riff que se escribe solo.

📈 Trazado del juego en directo

Se despliega junto con el afinador (plegable con clic en su título, 🗑 para borrar). Arriba, el pentagrama (clave de sol): cada nota colocada en el instante exacto en que se tocó, alineada con el gráfico; un clic sobre el trazado (pentagrama o curva) envía la lectura de ese punto al afinador (aguja, nota, tablatura, frecuencia, cents). Abajo, el gráfico deslizante (8 s): su altura como línea punteada, coloreada como el dial — verde a ±5 cents, naranja hasta ±15, rojo más allá. Las líneas horizontales de colores son sus notas objetivo (tablatura al margen). La escala vertical es fija: la separación de las líneas permanece constante, el marco simplemente se recentra en la nota tocada.

Navegación: clic = foco, ←/→ ±1 s (Mayús: 5 s), rueda del ratón, clic y arrastre; el desplazamiento se congela al pasar el cursor (insignia ⏸), cursor vertical con lectura precisa (tablatura, nota, cents); Fin/Esc vuelven al directo. El botón ⏸ Congelar detiene el desplazamiento de forma estable para examinar la curva sin mantener el ratón encima; ▶ Reanudar vuelve al directo. ~5 minutos de historial.

🎚 Afinador cromático

Dial ±50 cents: zona verde ±5 (afinado), naranja hasta ±15, rojo más allá. Aguja suavizada, etiqueta de nota que toma el color de la zona apuntada (verde/naranja), tablatura equivalente, frecuencia. La palabra AFINADO ✓ solo aparece en la zona verde. Al detenerse, la pantalla se congela (🗑 para reiniciar) y el módulo se pliega junto con el trazado. Limitado al registro de la armónica seleccionada.

🎯 Modo entrenamiento: útil para trabajar un bend concreto. Marque el modo y elija una nota objetivo en la lista — solo bends, overblows y overdraws (las notas a trabajar). La aguja sigue indicando la nota más cercana (nunca se queda bloqueada en el tope), mientras que el veredicto en texto se mide respecto al objetivo: «NO SUFICIENTEMENTE BAJO ↓», «DEMASIADO ALTO ↓», y «AFINADO ✓» cuando lo alcanza. El veredicto solo existe en modo entrenamiento, y «AFINADO» también supone la aguja en la zona verde.

Calibración del La (440 Hz, ▲▼, 415–466): muchas armónicas están a 442–443 Hz. Ajuste global y memorizado: afinador, reconocimiento y reproducción usan el mismo diapasón. Calibre primero el La.

🎯 Tocar la tablatura — práctica validada

La nota esperada parpadea en azul; tóquela al micrófono a su ritmo: afinada → verde, siguiente; equivocada → roja, se repite. Balance final: notas validadas, notas equivocadas, afinación media en cents. Funciona con cualquier tablatura — combinado con el generador: un ejercicio nuevo y corregido en cada sesión.

Limitaciones de la beta

• Una nota a la vez (sin acordes ni octavas divididas).
• Notas limpias; sostenimiento mínimo adaptado al tempo; validación a ±40 cents (un bend demasiado impreciso no se transcribe).
• La misma nota dos veces: sepárelas claramente. Los silencios entre notas no se transcriben.
• Ajuste la tonalidad de la app a la de su armónica; se recomienda un entorno tranquilo.

11 bis. Medidor de swing 🎵 (beta)

El Medidor de swing mide al micrófono su ratio de swing mientras toca corcheas: 50 % = binario (recto), 66,7 % = ternario (swing). Se basa en los intervalos entre sus ataques, lo que lo hace insensible a la latencia de audio — no hace falta calibrar nada antes de usarlo.

Un indicador y un veredicto claro — COLOCACIÓN OK para un objetivo recto, SWING OK para un objetivo de tresillo — muestran en directo si está en el objetivo, y el mensaje permanece al detenerse. Elija el objetivo (Recto 50 % o Tresillo 66,7 %), ajuste el tempo (sincronizado con la barra de herramientas), y deje opcionalmente que el módulo genere un ejercicio de corcheas (2, 4, 6 u 8) en la escala elegida — o «libre» para tocar lo que quiera. 🗑 reinicia el módulo.

12. Exportaciones

Cuatro formatos, cada uno para un uso distinto.

Exportación	Contenido	Uso
.json 💾	Todo: notas, duraciones, tempo, tonalidad, modos	Guardado fiable, intercambio, archivo
.mid 🎹	Notas y duraciones, sonido de armónica GM	MuseScore, DAW, backing tracks
.xml	Partitura exacta: compases completos, ligaduras, tresillos, con puntillo — y símbolos de acordes encima del pentagrama si «Mi progresión» contiene una grilla	MuseScore, Guitar Pro, Sibelius
🖨	Tablatura, 12 notas/línea, tonalidad, tempo, fecha, logotipo	Material de clase, PDF

🎯 Caso práctico — Quiere que un alumno vuelva a trabajar en casa exactamente la misma versión vista en clase, editable: exporte a .json. Solo quiere que la escuche en su teléfono o en una app de música: exporte a .mid. Quiere darle una partitura de verdad para leer: exporte a .xml y ábrala en MuseScore.

13. Preguntas frecuentes

• Sin sonido en el primer clic (iPhone/iPad): los navegadores desbloquean el audio en el primer gesto — haga clic en una nota.
• ¿Cambiar de tonalidad cambia mis notas? La tablatura nunca cambia; solo siguen los nombres y la altura — como cambiar de armónica.
• Sesión desaparecida: el guardado es propio de este navegador (la navegación privada y la limpieza de datos lo borran) — exporte a .json para que perdure.
• ¿Sin conexión? Sí, completamente: archivo autónomo.
• MIDI importado incompleto: las notas no tocables en la tonalidad elegida se listan; la app sugiere la mejor tonalidad.
• Overblows rechazados al importar: solo existen los overblows 1, 4, 5, 6 y overdraws 7, 9, 10 en una armónica Richter estándar.
• «Fuera de la armónica»: la nota detectada no existe en la tonalidad seleccionada — compruebe el ajuste.
• ⟳ frente a bucle parcial: ⟳ repite lo que se toca; con un rango seleccionado (Mayús+clic), solo el pasaje.

14. Signos de efectos y exportación de texto

✨ Signos de efectos sobre una nota

En el editor de notas (doble clic en una nota), puede añadir signos de efectos que no tienen ninguna incidencia sobre el ritmo ni la duración: solo sirven para anotar una intención de interpretación.

Elija primero la Posición (Antes o Después de la nota), luego haga clic en el o los Signos deseados. Una misma nota puede llevar varios efectos, antes y/o después; cada uno permanece independiente.

Signo	Efecto
/	Ataque desde abajo (ligero bend de ataque)
\	Nota «llorona»: ligero bend al final de la nota
vib	Vibrato
Wa	Efecto «wah-wah» con las manos
DS	Double stop (dos notas juntas)
TBS	Tongue blocking «slap»
TBO	Tongue blocking «a la octava»
→	Glissando hacia la nota siguiente
↔	Trino entre dos notas

El glissando y el trino no se reproducen con el sonido de la app. Los signos aparecen en la tablatura (en naranja, alrededor de la nota).

En la exportación: en texto (.txt), cada signo es un elemento separado (p. ej. DS TBS +4 vib Wa); en MusicXML, cada efecto se convierte en un lyric independiente mostrado debajo de la nota en MuseScore.

📝 Exportación de texto (.txt)

El botón TXT (grupo Archivo) descarga la tablatura en texto plano, con los signos de efectos, con el nombre de la tablatura.

10穴ダイアトニック・ハーモニカのタブ譜を作成・再生・練習するためのウェブアプリです。単一ファイルで、インストールも接続も不要：ブラウザで harmonica-trainer.html を開いてください。インターフェースは7言語で利用可能です（アプリのフッターにある国旗、選択は記憶されます — この取扱説明書も同じ設定に従います）。

💡 この取扱説明書は、アプリに表示される順序でモジュールごとに構成されています。各セクションでは、そのモジュールが何のためにあるか、どう使うかを説明し、すぐに始められるよう少なくとも1つの実践例を紹介します。

1. はじめの一歩

ページ上部のスクロールバナーには apprendrelharmonica.com のコンテンツが表示されます。カーソルを合わせると一時停止し、クリックするとページが開きます。ページ下部のサイトのロゴは、タブ譜の印刷にも署名として入ります。

最初に覚えておきたい4つの操作

• 音をクリックすると再生と記譜が同時に行われます。 仮想ハーモニカをクリックするたびにその音が再生され、タブ譜に追加されます——「追加」ボタンを探す必要はありません。
• ▶（またはスペースキー）で記譜されている内容を再生します。タブ譜が空の場合は、「試す：…」ボタンが1小節のブルース・リックを提案します。表示のたびに変わります。
• 💾 手動で保存する必要はありません。 ブラウザに自動保存されます：閉じても、翌日開き直しても、そのままセッションが復元されます。
• 📂 ほとんどのモジュールはタイトルをクリックすると開閉できます。 ハーモニカの図と「マイタブ譜」は常に開いたままです。

🎯 実践例 — 初めてアプリを開くとき：仮想ハーモニカのいくつかの穴をクリックして音を聴き、スペースキーを押して作曲したものを聴いてから、何も保存せずにタブを閉じてみてください。アプリを開き直すと、先ほどの小さなメロディがそのまま残っています。

1 bis. カスタムレイアウト 🔀

デフォルトでは、モジュールは標準的な順序で積み重なっています。主に2つか3つのツール（例えばメロディ・ジェネレーターとリズム工房）を使うなら、それらを近づけて配置し、毎回スクロールしなくて済むようにできます。

• 各カードをその取っ手 ⠿ でドラッグ：ページの列に吸着します。
• 「レイアウト」バーは複数の名前付きレイアウトを保存し、メニューから呼び出せます。
• ↺ は元のレイアウトに戻し、💾 はレイアウトを再インポート可能なファイルにエクスポートします。

すべてブラウザに保存され、この端末専用です——別のパソコンに変えたら、レイアウトをエクスポートしてそちらでも使えるようにしましょう。

2. 記譜法

アプリのタブ譜は、紙のタブ譜と同じように読めます。ベンドとオーバーノートに関するいくつかの記号が追加されています。

表記	意味
+4 / -4	4番の穴を吹く／吸う
-3', -3'', -3'''	1、2、3半音のドロー・ベンド
+8'	ブロー・ベンド（8～10番）
+6° / -7°	オーバーブロー／オーバードロー
z	休符（テキストインポート用）

同じカラーコードがアプリ全体で繰り返し使われます——タブ譜、仮想ハーモニカ、リアルタイムの演奏トレースにも：ブロー・ドロー・ベンド・オーバーブロー・オーバードロー。このコードが身につけば、数字より先に色で読めるようになります。

3. 仮想ハーモニカ

これがアプリの心臓部です：図の上に表示されているキーの、完全なハーモニカです。各列は上から下に、オーバーブロー、ブロー・ベンド、ブロー音、ドロー音、ドロー・ベンド、オーバードローの順に並んでいます。

• 穴の番号をクリックすると、対応する穴のブロー音が追加されます。
• 列にカーソルを合わせると点灯し、その穴で使えるすべてのテクニックを一目で確認できます。
• 表示される音名は選んだキーとオクターブに従います——キーを変えると名前は変わりますが、音の物理的な位置は変わりません。

3 bis. Keyfinder 🔑

Keyfinderは、ハーモニカ奏者なら誰もが遅かれ早かれ抱く疑問に答えます：「この曲にはどのハーモニカを使えばいい？」——あるいは逆に「今持っているハーモニカで何が弾ける？」。位置（ポジション）ごとの重要な音（トニック、3度、5度、7度）と、それらをハーモニカのどこで弾くかも表示します。

実践例1：曲のキーから出発する

1. 「ハーモニカを探す」タブ：曲のキーを選びます（例：C）。
2. 演奏したいポジションを選びます（例：2番ポジション）。
3. Keyfinder はどのハーモニカを使うべきかを示し、主要な音——トニック、長3度、短3度、完全5度、短7度、長7度——をハーモニカ上の位置とともに表示します。

例：Cのキーの曲を2番ポジションで演奏する場合、Keyfinder は F のハーモニカを推奨し、トニック、3度、5度、7度がどこにあるかをすぐに示します。

実践例2：手元のハーモニカから出発する

1. 「キーを探す」タブ：お手持ちのハーモニカのキーを選択します（例：E）——複数のハーモニカを同時に選択できます。
2. ツールが演奏可能な12のキーを対応するポジションとともに表示します。
3. 曲のスタイルに合ったポジションを選び、楽器上の重要な音を確認します。

例：Eに調律されたハーモニカを使う場合、1番ポジションではEで、2番ポジションではBで、3番ポジションではF#で演奏することになります。

強調される音——その理由

音	役割
トニック	そのキーの主要な基準音
長3度	メジャーの響きを与える
短3度	マイナー／ブルースの響きを与える
完全5度	安定した支えとなる音
短7度	ブルース／ドミナントの響き
長7度	ジャズ／メジャーの響き

まとめると：曲のキーから始めても楽器から始めても、Keyfinder が数クリックで案内してくれます——時間を節約し、より速く正確に演奏できるようになります。

4. ツールバー

ツールバーには5つのコマンド群がまとまっています。頻繁に使うので、最初から暗記しておく価値があります。

🎵 再生

• ▶/⏹（スペースキー）：タブ譜を再生または停止します。⏸ 一時停止（Pキー）は一時停止して現在の音を記憶します——もう一度クリック（またはP）するとまさにそこから再開しますが、⏹ は完全に停止して位置を忘れます。
• どこからでも開始：タブ譜の音をクリックすると、▶ はそこから再生を始めます（選択がない場合は最初から再生）。曲の途中から再開する場合、アウフタクトとカウントインをスキップし、コード進行のグリッドを演奏中の小節に同期させます。
• ⟳ は途切れなくループします——隣の×N欄でループ回数を指定できます（N回演奏後に停止；空欄なら無限）。
• 🎹 ブロックコード：ループ回数欄の隣にあり、コードビルダーのコードをアルペジオではなく同時発音（ピアノ）で鳴らします。
• ⏱0 カウントイン：メトロノームはアウフタクト（第0小節）の間だけ鳴り、その後は無音になります。
• テンポ 40～240、🔊 音量、⏱ メトロノーム（拍子に応じた強拍：4拍または3拍ごと）。
• TAP：マウスでリズムに合わせてクリックしてテンポを設定します——直近のクリックの平均が全体のテンポに適用されます；RESET でクリックをクリアします。

🎯 実践例 — 練習したい曲の正確なテンポが分からないとき：スマホでオリジナルを聴きながら TAP でタップすると、アプリが BPM を割り出して直接設定してくれます。

再生中は、現在の音がタブ譜とハーモニカの両方で点灯します——見失わずに追うための便利な視覚的目印です。

🏋️ エクササイズ

• メロディ用の🎼 ジェネレーター（第7節で詳述）。
• 🎶 コードビルダーと♬ コード進行（7 bis節で詳述）。
• 🧩 曲の構成（7 ter節で詳述）。
• 🎙︎ マイクセンサー（テスト）（8 quinquies節で詳述）と👂 耳コピ（8 ter節で詳述）。
• タブ譜の🔀 シャッフル（クリックごとに1回、Ctrl+Zで元に戻せます）。
• ⇅ 上行してから下行。
• SWING（三連符系の8分音符：拍の「裏」に落ちるアタックはすべて拍の3分の2の位置まで遅らせます）。
• 🎲 ランダムな音価。
• プログレッシブテンポの+BPM（第6節で詳述）。

これらのモードは組み合わせ可能です：例えば、メロディをシャッフルしかつスウィングをオンにしかつプログレッシブテンポも同時に有効にできます。

🎼 タブ譜（表示）

• TAB / 音名 / ドレミ：タブ譜、英語音名（C4、Bb3…）、またはソルフェージュ名（Do4、Sib3…）を切り替えます。
• キー（12種類のハーモニカ）：名前と音高は適応しますが、タブ譜自体は変わりません——これは内容の変更ではなく表示の変更です。
• ▾8 / ▴8：選択したノートをオクターブ移調します（何も選択していなければタブ譜全体；対応する穴に）。対応する音がない場合は移動せず、アプリがそれをリストします。選択：Shift+クリックで範囲、Ctrl/Cmd+クリックで単一の音、⇄ 反転 は選択・非選択を入れ替えます。
• 1・3b・5 度数：各音の下に、基準スケールにおける度数を表示します——隣の🎼ボタンでジェネレーターを開いてスケールを選ぶと、表示が自動的にそれに合わせられます。スケール外の音はグレーアウトされます；コード構築ツールのアルペジオでは、代わりにコードのインターバル（1、3b、5、7b…）が表示されます。

📁 ファイル

• 📚 ライブラリ：名前付きのタブ譜をこのブラウザに保存——読み込み、名前変更、削除；⬇ すべてエクスポートで再インポート可能な.jsonに。ウィンドウはマウスで移動できます。
• 💾 / 📂：完全な.jsonファイル；📂 は.midファイル（タブ譜に変換：音価を量子化、休符を再構築、テンポを適用、演奏不可能な音をリスト表示、最適なキーを提案）と.xml/.musicxmlファイルも開きます。
• テキストタブ譜の📋 インポート（第5節で詳述）・🎹 MIDI（GM Harmonica音源）・XML MusicXML：正確な楽譜——音符と音価が常に一致し、完全な小節、書き出されたタイ；MuseScoreは何も書き換えません。・TXT：エフェクト（ベンド、オーバーノートなど）付きのプレーンテキスト書き出し。メッセージに貼り付けるのに便利です。
• 🖨 印刷：整った配置、白背景、ロゴ、1行12音符（ブラウザの「PDFに印刷」でPDFに）。

🎯 実践例 — 生徒用のレッスン資料を準備しているとき：タブ譜を作成し、🖨 印刷をクリックし、ブラウザのダイアログから「PDFに印刷」を選びます。PDFにはロゴが残り、白黒印刷でも読みやすいままです。

✏️ 編集 & ♩ 音価

↶/↷（Ctrl+Z / Ctrl+Y）、🗑 すべて消去、? ヘルプ、! は開いているウィンドウの表示をリセットします（ウィンドウが固まったり画面外に配置されたりしたときに便利です）。

9種類のリズム値が使えます：全音符、2分音符、4分音符、8分音符、16分音符、三連符、付点（+50%）、そして3種類の休符（1、½、¼拍）。選んだ音価はこれから入力する音符に適用されます；既存の選択範囲に対しては直接変更が反映されます。

小節をまたぐ音符：表示上は分割され、‿（点線でつながれた部分）で結ばれます——その音符自体は1つのままで、一息で演奏されます；MusicXMLエクスポートにはタイが書き出されます。

‿ タイ：選択した音符を結びます——‿記号がその間に表示されます。同じ高さの2つのタイでつながれた音符は再アタックなしで一息に流れ、MusicXMLエクスポートにはフレージングのスラーが書き出されます。ノートエディタ（音符をダブルクリック）の‿ボタンでも、音符ごとに同じことができます。

5. テキストタブ譜のインポート 📋

フォーラムや本で見つけたタブ譜、生徒がテキストメッセージで送ってきたタブ譜を、すべて手で打ち直さずに取り込むのに便利です。

タブ譜を貼り付けます（音符はスペースで区切り；カンマ、改行、|も使用可）：+4 -4 +5 -5 +6 -6' -6 z +6 -5 +5 -4 +4。+は省略可能、zは休符を挿入、無効な要素は無視されリストに表示されます。インポートはすでにある内容の後に追加されます。

6. パッセージの練習

特定の箇所を、毎回曲全体を演奏し直すことなく練習するための2つのツールです。

部分ループ

最初の音をクリックし、Shift+クリックで最後の音を選びます：範囲がハイライトされ、▶はそこだけを再生し、⟳はそこをループします。Shiftなしでクリックすると範囲を抜けます。この範囲は、すべての音価を一括変更したり、一度に削除したりするのにも使えます。

🎯 実践例 — 長いソロの中の2小節のフレーズがうまくいかないとき：それを選択し（Shift+クリック）、⟳をオンにして、その部分だけをループさせながら練習しましょう。曲の他の部分を弾き直す必要はありません。

プログレッシブテンポ（+BPM）

ステップ（1回のパスごとに1～20 BPM）と最大値を設定します：ループが1周するごとにテンポが上がり、表示されます。選択した範囲でも機能します：🎹伴奏が有効な場合を含め、選択範囲が1周するごとにテンポが上がります。

典型的な例：難しい4つの音を、60 BPMから開始、ステップ4、最大120——ゆっくり始めて、成功するたびにアプリが自動的にテンポを上げてくれるので、自分でテンポを操作する必要はありません。

7. メロディ・ジェネレーター 🎼

ジェネレーターは単なるランダムな音の羅列ではなく、まとまりのあるメロディを作曲します：スケールはポジションごとにグループ化されています——メジャー＆メジャー・ペンタトニック（1番）；ブルース、ミクソリディアン、ペンタトニック（2番）；マイナー・ペンタトニック、ブルース、ドリアン（3番）；ナチュラル・マイナー、マイナー・ペンタトニック（4番）；フリジアン、マイナー・ペンタトニック、ベンド付きナチュラル・マイナー（5番）；リディアン、ベンド付きメジャー（12番）。4段階のレベル（初級：4～8番の穴 → 上級：オーバーブロー使用）、1、2、4小節のいずれか。メロディは常にトニックで終わりますが、「トニックで終わらせない」にチェックを入れると変わります。

ウィンドウは作業中開いたままです：ループ（🎼）で再生成し、聴き、調整しても、アプリの他の操作は妨げられません。✕またはキャンセルで閉じます；結果が気に入らなければCtrl+Zで前のタブ譜に戻せます。

マイ設定 — 「サプライズ」のすぐ下で、ウィンドウ全体の設定に名前を付けて保存し、ワンクリックで呼び出せます：スケール、レベル、音域、長さ、フレージング、拍子、1小節あたりの音数、チェックした音価、コード進行への追従、2つの注入スライダー。💾 で保存（既存の名前を使うと重複を作らず上書きします）、🗑 で選択中の設定を削除、⬇ ですべての設定を .json に書き出し、📂 で読み込みます。さらに、最後に生成したときの設定は自動的に記憶されます：次にアプリを起動すると、ウィンドウは前回のままの状態で開きます。

ワンクリックで、素早く

ジェネレーターの上部にあるおまかせボタンは、メニューを自動で設定し（動くのが見えます）、そのまま即座に生成します：1クリックで1メロディ。もう一度クリックすると新しい抽選になります。詳細設定はその下にあり、スケール、ポジション、レベルを細かく選びたい人向けです。

🎯 実践例 — レッスンまで5分しかなく、初心者にすぐ見せる簡単な例が欲しいとき：設定に触れずに「おまかせ」を何度かクリックして、シンプルで歌いやすいものが出るまで試してみましょう。

生成されたものを読んで演奏する

記譜法のリマインダー「📖 タブ譜の読み方は？」（ブロー、ドロー、ベンド、カラーコード）は、編集メニューのヘルプ?から確認できます。音符ができるとすぐに、タブ譜の下にアイコンの列が表示されます：▶（赤）はタブ譜を再生、⏹（緑）は停止、マイクアイコン（青）は🎯モードを起動します（マイクで演奏すると、アプリが音符ごとに判定します）、+ は音符を追加または挿入します——選択中の音符の後、なければ末尾に——エディタを開きます；再度クリックするとさらに追加でき、小節線は再計算されます。

フレージング：メロディに形を与える

「音を並べただけ」のメロディを超えて、フレージングのタイプを指定できます：問いと答え（互いに呼応する2つのパート）、アーチ（上昇してから下降）、谷（下降してから上昇）、波（連続したうねり）、上行のみ・下行のみ（フレーズが一方向だけで音域を横断します）、軽いジャズ（特定の音への半音階アプローチ）、完全なビバップ（エンクロージャー、8分音符）。「なし」を選ぶとアプリに任せられます。

上行と下行は全体の方向を決めるもので、スケールそのものではありません：低音から高音へ（またはその逆へ）進みつつ、わずかな戻りは許容されるため、音楽的な流れが保たれます。横断する範囲は低い音 → 高い音の2つのメニューで決めます。最後の音は主音に着地するため少し戻ることがあります：最後まで方向を貫きたいときは「トニックで終わらせない」にチェックを入れてください。

谷はアーチの裏返しです：フレーズは高音域から始まり、低くくぼんでから再び上がります。波は方向転換を次々に重ねます——2小節ごとに1回のうねり——一方向に流されがちな生徒に、切り返しを練習させるためのフレージングです。

AABブルース — 歌われる形式を、あなたの進行の上に

AABブルースのフレージングは、ブルースのコーラスを歌うとおりに書き出します：フレーズAが1〜4小節を占め、A'は5〜8小節でそれをそのまま繰り返します——進行はIVへ動くのに旋律は動かない、そのずれこそが緊張感の源です——そしてBが9〜12小節で応答し、締めくくります。4小節ごとのまとまりはひと息で終わります：4小節目と8小節目でフレーズは支点に着地し、そのあと場所を譲ります。歌い手が楽器に応答させるのと同じです。Bは提示部より音数が多く、最後の音は主音へ向かって下降します。

このフレージングには12小節の進行と「マイ進行に従う」のチェックが必要です——形式そのものがそれを求めます。どちらかが欠けている場合、別のものを生成せずにその旨を知らせます。A'で修正される音はひとつだけです：セブンス・コード上に落ちた長7度（ハ長調でのF7上のミ）は半音下がります——ブルーノートはそのまま保たれます。

🎯 実践例 — 「コード進行」から12小節ブルースのプリセットを読み込み、「マイ進行」へ送り、「マイ進行に従う」にチェックを入れてAABブルースを選びます：生徒に読ませたり耳コピさせたりできる、完結した構成のコーラスが手に入ります。

問いと答えは4小節だけでなく2小節でも機能するようになりました：2小節目が1小節目のリズムと出だしを受け継ぎ、問いは属音の上で宙づりになります。4小節を使わずに、短く引き締まったリックが得られます。

🎯 実践例 — 生徒と音域を練習するとき：下行のみ、4小節、中級レベル、音域を4～8番の穴に限定——単なる下行スケールではなく、選んだ音域を降りていくフレーズが得られます。

拍子、音価、音域

拍子を選びます——4/4、3/4（ワルツ）、6/8、12/8——アプリ全体がそれに従います（小節線、メトロノーム、MIDIおよびMusicXMLエクスポート）。長さ：1、2、または4小節。

使用する音符の音価を制限するには、必要な値だけにチェックを入れます——全音符、2分音符、4分音符、付点4分音符、8分音符、16分音符、三連符、または4分音符の三連符。

例：全音符のみで1小節に1音、または2分音符のみで1小節に2音——非常にシンプルなフレージングや最初のレベルに最適です。すべてチェック＝自由。

要求された音符数が小節を埋めるのに足りない場合——例えば4/4で8分音符4つなど——アプリは拒否せずに休符で補います：末尾に詰め込まず小節内に分散させ、メロディが呼吸できるようにします。

最低音→最高音の2つのメニューは、選択したスケールとレベルで使える音の中から、生成されるメロディをお好みのハーモニカの範囲に制限します——楽器の特定のゾーンにとどめたいときに便利です。スケールやレベルを変更すると自動的に再設定されます。

1小節あたりの音符数。最大値を設定します：6にすると、アプリは最大6音まで使いますが、必ずしも6音とは限りません。「正確にこの数」にチェックを入れると、正確な数を強制できます。

コード進行の上に生成する

「マイ・コード進行に従う」にチェックを入れると、選択したスケールが（「マイ・コード進行」モジュールの）コード進行のコードに適用されます。コードのキーに関わらず——意外な響きを試すのに良い方法です（不協和音に注意）。各コードはその固有の長さ（フル小節、半小節…）を保持します：生成されるメロディは追加設定なしで自動的にそれに合わせられます。注入スライダーは、スケール外の音と休符（フレーズ末の呼吸）の割合を追加します。

メニュー「進行上で使う音」は、スケールとコードのどちらを優先するかを決めます。自由は両方を混ぜ、注入スライダーで調整します——これが元の動作で、スケール外の音（ブルースコードの長3度など）が混じることがあります。厳格なスケールと共通音のみは、どちらも選んだスケールの中に厳密にとどまり、例外はありません——両者の違いは、使える音の範囲ではなく、音の選び方にあります。厳格なスケールではその瞬間のコードは一切影響しません：メロディはコードを無視してスケールに従います。共通音のみでは、スケールの音が同時にコードの音でもある場合、アプリはそれを——主に拍の頭で——優先して選ぶ可能性を持ちますが、それは常にそうなるわけでも強制でもありません：数ある選択肢の一つに過ぎません。どちらのオプションも注入スライダーを無効化します（もう意味を持たないためです）。

🎯 実践例 — 2ndポジションのブルーススケールをブルース進行にかけるとき：自由ではコードの長3度がメロディに紛れ込みます。厳格なスケールに切り替えれば、コードが何であれ最初から最後までブルースの響きを保てます。

マイ・モード 🧬：自分だけのスケールを作る

折りたたみ可能なモジュールで、自分だけのモードを作成できます——名前、ポジション（1番～12番）、12の半音の中からチェックした度数——ブラウザに記憶され、ジェネレーター、1・3b・5度数、スウィング・メーターのスケール選択メニューで（★）利用可能になります。✎ はモードを編集、🗑 は削除します。

ジェネレーターのウィンドウ内、スケール選択の横にある：🗑 は表示中のスケールをリストから外します（選択は記憶されます）、↺ はすべてのスケールを再表示します；⬇ はモードを.jsonファイルにエクスポートし、📂 で再インポートできます。

7 bis. コードとコード進行 🎶

単音ではなくコードで作業するための、補完し合う3つのモジュールです：単一のコードを作る、既成のグリッドをつなげる、現在のグリッドを再生・エクスポートする。

🎶 コード構築ツール

エクササイズグループ：ルート音、クオリティ（トライアドから13thまで）、任意のアルタレーション／テンション（b5、#5、b9、#9、#11、b13——クオリティに応じて有効）、任意のベース音（分数コード、例：C/E）、アルペジオの形（上行のみ、または上行下行）を選びます。

拍子セレクター（4/4、3/4、6/8、12/8）は構築前に拍子を決めます——メロディ・ジェネレーターやコード進行と共有されています；タブ譜にすでに音符がある場合は確認を求められます。小節線が再分割されるためです。コードの長さを拍数で直接選べます——4/4なら1、2、4；3/4なら1または3；6/8なら1½または3；12/8なら3または6——「コード進行」と「曲の構成」でも同じセレクターです。

確定すると、コードがアルペジオとしてタブ譜の末尾に挿入されます——演奏可能な最も低い位置、オーバーブロー／オーバードローも含めて——ウィンドウは開いたままなので複数のコードを続けて追加できます；最後を削除で直前に追加したものを取り除きます。コード名はその行の先頭にバッジとして表示され、🔀 と 🎲 は各コードの中で作用し、その小節を壊しません。再生時、🎹（再生グループ）はブロックコードに切り替わります：各コードがアルペジオの代わりに、ピアノ音でブロックとして鳴ります。

♬ コード進行（プリセット）

エクササイズグループの移動可能なウィンドウ：約20のクラシックなコード進行（ポップ、ジャズ、12小節ブルース、マイナーのカデンツ…）、12のキーおよびメジャー／マイナーに移調可能——「調号のみ」にチェックを入れると、コードを移調せずに表示される調号だけを変更します。

コード進行は挿入前に編集可能です：コードをクリックしてルート音、クオリティ、テンション、ベース音、そして拍子に応じた固有の長さ（1、2、または4拍）を変更できます——各コードはその長さを保持するので、同じグリッド内にフル小節と半小節2つを混在させられます。ウィンドウの拍子セレクターが拍子を決め、そこからフル小節の長さが導かれます：4/4なら4拍、3/4なら3拍、12/8なら6拍。◀ ▶ でコードを移動、✕ で削除、+ で追加。表示切替名前 / 度数（ローマ数字）。

💾 はコード進行をプリセットリストに保存し（★、削除は🗑）、⬇ はコード進行を.jsonにエクスポートし、📂 で再インポートします。→ マイ・コード進行 は構築したグリッドをタブ譜を経由せず下のモジュールに送ります。保存済みの曲の構成（🧩モジュール、7 ter節）もこのリストに🧩の接頭辞付きで表示されます：それを選択すると構成全体がグリッドに平坦化され、各パートの長さとキーは保持されます。

♬ マイ・コード進行

このモジュールは受け取ったグリッドを表示します：各チップにはコード名が表示され、フル小節と異なる場合はその長さがカッコ内に表示されます（例：G7 (2)）。長さは、プリセット、構築ツール（タブ譜経由）、タブ譜からこのモジュールへの送信のいずれから来たものでも、手動設定なしで自動的に認識・尊重されます。

• ♬ 再生に伴奏をつける：タブ譜の再生中、各コードが実際の位置と長さでピアノとともに鳴ります。
• 🪟 現在のコード：小さな移動可能な、常に最前面の窓を開き、現在のコードを大きく、次のコードとともに表示します——ハーモニカから目を離さずにグリッドを追うのに便利です。
• → タブ譜：グリッドをタブ譜内のアルペジオに変換します。コードごとに1グループ、それぞれ固有の長さで。
• 💾 🎹 XML TXT：グリッドのみをエクスポートします——JSON、MIDI（ブロックコード）、MusicXML（コードとシンボルは音符としてではなく五線の上に書かれます）、テキスト（コード名）。
• 🗑：コード進行をクリアします。

🎯 実践例 — ビデオ通話で生徒にブルースのグリッドを教えるとき：12小節ブルースのプリセットを「マイ・コード進行」に送り、🪟 現在のコードを開いて、生徒がその上で演奏する間も窓を表示したままにしておきましょう——生徒はグリッド全体を読まなくても、常に自分がどこにいるか分かります。

「マイタブ譜」のヘッダーにある→ マイ・コード進行ボタンは逆の動作をします：タブ譜内にある（🎶で構築された）コード・アルペジオを読み取り、長さも含めて「マイ・コード進行」内にグリッドを再構築します。すぐ横の💾 🎹 XML TXTアイコンは、完全なメロディのエクスポートへのショートカットです——メインツールバーにあるものと同じです。

7 ter. 曲の構成 🧩

このモジュールは、1つの均一なグリッドではなく、パートごとに曲の全体のコードグリッドを構築するためのものです——曲にコードの異なるヴァースとコーラスがある時点で役立ちます。

移動可能なウィンドウ（🧩ボタン、エクササイズグループ）：イントロ、ヴァース、コーラス、ブリッジ、ソロ、ブレイク、トランジション、アウトロ、またはカスタムパート——各タイプには固有の色があり、カード上に枠線として表示されます。パートを追加するとカードが作成され、即座に選択されます；名前は編集可能で、そのキーとモードは下のエディタで設定され、そのパートのすべてのコードを一括で移調します。

パートのグリッドを構築する

各パートのグリッドは、🎶（7 bis節）と同じコード構築ツールで作られます：+で構築ツールを開き、確定でコードをそのパートに追加し、ウィンドウは開いたままなので続けて追加できます。その後、コードのチップをクリックすると、そのコードがあらかじめ入力された状態で構築ツールが再度開き、グリッドの他の部分に触れずに編集できます（ルート音、クオリティ、長さ…）；チップ右側の小さな✕で削除します；チップの間にある目立たない+は、忘れていたコードをその正確な位置に挿入します——連続した挿入は入力した順につながります。

パートの並べ替えと管理

• ◀ ▶ はパートを1つ移動させます。または取っ手 ⠿ をつかんでドラッグ＆ドロップで好きな位置に配置できます（カーソルが乗った行の前後どちらに挿入されるかを青い枠で示します）。
• ⧉ はパートを複製、📋 はコピー、📥 貼り付けは構成の末尾に追加、🗑 は削除します（確認が必要）。
• ↺ クリアで全パートを一括削除できます（確認が必要）：保存済みの構成には影響しません。

💾 保存で構成に名前を付けます：ドロップダウンリストに加わります（構成を再読み込みする際、別のものが編集中なら確認が求められます）、すぐ横の🗑でリストから削除します。⬇で保存済みの構成をすべて.jsonにエクスポートし、📂で再インポートします。保存済みの構成は、🧩の接頭辞付きで「コード進行」のリスト（7 bis節）にも表示されます：そこで選択すると、各パートの長さとキーを保持したままグリッド全体が平坦化されます。

特定のパートにメロディを生成する

コードを含むパートに対して🎲 メロディを生成：メロディ・ジェネレーター🎼が、そのグリッド、そのキー、現在のジェネレーターの設定（レベル、スケール、フレージング…）で作曲し、結果を「マイタブ譜」内のそのパートの場所に正確に挿入します——タブ譜の他の部分には触れません；パートを再生成すると置き換えられ、追加されることはありません。

🎯 実践例 — イントロ／ヴァース／コーラス／ソロで曲を構築しているとき：イントロには落ち着いたメロディを生成し、ソロだけにはより技巧的なメロディを生成——他の2つのパートには一切触れません。

→ マイ・コード進行は、パートの順に構成全体を7 bis節のモジュールに平坦化します——プリセットと同じ経路です。

専用エクスポート：TXTは印刷可能なグリッドを生成し、パート名が付き、小節が列で揃えられます；XMLは各パートが新しい行から始まる（パートマーカーと調号付き）MusicXMLを生成し、コードシンボルは国際記法で五線の上に表示されます——「マイタブ譜」が空なら五線は空のまま（休符は非表示）、内容があればそのメロディが表示されます。

8. 細かい編集

メロディができたら——生成、インポート、または音符ごとに入力したもの——ここで詳細に手を加える方法です。

ヘッダーバーの概要

上から順に、ヘッダーの各コマンドの機能です：

• ⠿：モジュールをページ内で移動。
• Ma tablature：モジュール名。18 éléments · 4 mesures：音符/休符と小節のカウンター（リアルタイム更新）。
• ▼8 / ▲8：選択範囲全体を1オクターブ下げる／上げる（選択がなければタブ譜全体）。
• Anacrouse：最初の小節をアウフタクトとして宣言。
• ▶（右上の赤いアイコン）：モジュールのチュートリアル動画を開く。
• 💡 ヒントバー：音符を編集するにはダブルクリックすることを案内。
• ▶ / ■ / 🎤 / +：再生、停止、マイクモード、音符の追加。
• ⇄ Inverser：選択範囲を反転（吸音⇄吹音）。
• ✕ Note：直前に入力した音符を消去（選択中の音符に対するその他の操作も）。
• 🗑 Tout：タブ譜全体を削除。
• ⇅ Suivre：再生中の自動スクロールのオン/オフ。
• ♫ Arpèges：アルペジオ表示モードの切り替え。
• Muet：再生音をミュート。
• → Ma progression：連動するコード進行モジュールへ切り替え。
• 💾 / 🎹 / XML / TXT：タブ譜を保存、MIDIへ書き出し、MusicXMLへ書き出し、テキストへ書き出し。
• ⚠ Compléter la mesure：不完全な小節を知らせる警告。
• 小節番号（左の列）：グリッド内の小節の位置を示す。
• 音符のマス：穴・音価・穴番号を表示 — ダブルクリックで編集（音高、音価、休符）。

選択と削除

クリック＝選択（新しい音符はその後に挿入されます）；⌫/Deleteで削除；←/→で選択を移動。自動的に番号付けされた小節線（ジェネレーターで選んだ拍子に応じて4/4または3/4）；カウンターは要素数と小節数を表示します。

ノートエディタ（ダブルクリック）

音符をダブルクリックすると完全なエディタが開きます：穴（1～10）の変更、テクニックの変更（その穴で実際に演奏可能な音のみが色付きで提示されます）、音価と付点、音符を休符に変換（またはその逆）、または削除。

小節の補完・複製・削除

⚠ 小節を補完：最後の小節が不完全な場合、このボタンがタブ譜の上に表示されます。アプリは現在のスケール内で3つの可能な終わり方を提案します——1つ選ぶと音符が追加され、小節がぴったり収まります。

小節の複製または削除。 タブ譜の各行が1つの小節に対応します。行末の2つの小さなボタンで、その小節を複製（コピーが直後に挿入されます）または1クリックで削除できます。

オクターブの移調

オクターブ ±8。音高が許せば、▾8 / ▴8で選択部分（または全体）を1オクターブか2オクターブ上げ下げできます；対応する音がない音符は移調されません。

再生中にコードを追う

⇅ 追従 と 🎵 アルペジオ。「マイ・コード進行」にコード進行がある場合、再生中にコードのアルペジオが緑の枠で囲まれることがあります：⇅ 追従はタブ譜をそこにスクロールさせます（自分でスクロールしたい場合はオフに）、🎵 アルペジオはそのコードとともに音を鳴らします（ピアノだけにしたい場合はオフに）。

タブ譜の音符はどこから来るのか？

そこに表示される音符は、次のような由来を持ちます：図面上のクリック、マイク（ピッチ認識モジュールまたはマイクセンサー）、メロディ・ジェネレーター、ライブラリ、「マイ・コード進行」の「タブ譜」ボタン、モジュールの+ボタン、そして「試す」ボタン。

調号（エクスポート用）

エクスポートの調号は自動的に決まります：生成されたメロディのトニックを、そのポジションに応じてメジャーかマイナーで反映します——例えば、Cのハーモニカで3番ポジションのマイナー・ペンタトニックはニ短調（フラット1つ）になり、ハーモニカ自体の調号にはなりません。生成されたメロディがない場合は、ハーモニカのメジャー・キーになります。MusicXMLの最初の小節（モードとともに）とMIDIに表示されます——MuseScoreはきれいな楽譜を表示します。

アウフタクト

アウフタクトをタブ譜の最初に入力します。合わせの休符も含めて——例えば休符2つと8分音符2つのように——そしてモジュールのヘッダーにあるアウフタクトをクリックします：最初の小節が小節0となり、点線の枠で示されます。再度クリックすると解除されます。その音符は他と同様に編集できます（音価、ダブルクリック、ドラッグ＆ドロップ）。再生時、小節0は先頭で1回だけ演奏されます：ループ⟳は本体だけを繰り返し、「マイ・コード進行」の伴奏は小節1からしか入りません。メトロノームが有効なら、アウフタクト前の空の拍はカウントされます——アウフタクトがない場合は、最初にフル1小節分のカウントインがあります。MusicXMLエクスポートは実際のアウフタクトを書き出します（短縮された小節0、先頭の休符は削除）；MIDIは正確なタイミングを保持します。小節線をまたぐ音符は本体側に留まります。

8 bis. 聴音ディクテーション 🎧（ベータ版）

純粋な耳の訓練に使います：アプリが何かを再生し、あなたはそれを見ずに聴き分けて弾き返さなければなりません。

使い方

チューナーの下：1～6音とレベルを選びます——初級（4～6番）、中級（自然音）、上級（ベンド、オーバーノートなし）、エキスパート（すべて含む）。🎲は歌えるフレーズ（インターバル≦5度、繰り返しなし）を、現在のキーで再生します。▶ 再聴取は何度でも；🎤 マイクで回答：正しい音はそのマスを埋め、間違った音は赤く点滅してエラーとしてカウントされます。解答を見るで答えを表示します。あなたのタブ譜には決して書き込みません。

スコア、統計、バッジ

ディクテーションに成功するたびにスコア = 音符数 × レベル × 100 が加算され、エラー1つにつき−20、初回を超える再聴取1回につき−5されます。モジュールの下には、プレイしたディクテーション数、パーフェクトの回数、記録、累計、現在の連続記録が表示されます（↺でリセット可）。解除できる7つのバッジ——ブロンズ／シルバー／ゴールドの耳（10／50／100回のディクテーション）、ノーミスと絶対音感（5回・10回連続パーフェクト）、ヴィルトゥオーゾ（エキスパートでノーミス）、息のマスター（1000点超）。すべてブラウザに保存され、オフラインで使えます。

🎯 実践例 — 寝る前の5分、楽譜を読むハーモニカが手元にないとき：初級レベルのディクテーションを起動し、ベッドサイドのハーモニカでマイクに向かって演奏し、夜ごとにパーフェクトの連続記録が伸びていくのを確認しましょう。

8 ter. 耳コピ 👂（ベータ版）

聴音ディクテーションに似ていますが、単独の音ではなくスケールとポジションに焦点を当てています——特定のスケールの響きに耳を慣れさせるのに役立ちます。

使い方

👂ボタン（エクササイズグループ）：アプリは選んだスケール／ポジション（★のモードも含む）の数音を、見せずに再生します。レベルと音符数（2～16）を設定し、何度でも再聴取した後、ウィンドウ内でフレーズを再構築します：🎤 マイクで——弾いた音がそれぞれトークンになります——または手動で（構文+4 -4 -3' +6°；トークンをクリックすると削除、⌫ですべて消去）。確定で下に解答が緑／赤で音ごとに表示されます：正しいとされるのは響きが正しいもの（-2 ≡ +3）。あなたのタブ譜には決して触れません。

ポイントとバッジ

スコア = 正解音数 × レベル × 100、エラー1つにつき−20、初回を超える再聴取1回につき−5、抽選の最初の確定時にカウントされます。1000点ごとにレベルアップ；5つのバッジ（初のノーミス、10回・50回の耳コピ、5回連続ノーミス、エキスパートでノーミス）；↺でリセット。ブラウザに保存、オフライン対応。

8-d. リズム工房 🥁（ベータ）

音程の正確さとは独立してリズムを鍛えます——音程は正しいのにリズムが「ずれている」生徒、あるいはその逆の生徒に最適です。

使い方

🥁ボタン（音価群）：アプリがレベルに応じて1小節（4/4）のリズムを生成 — ♪♬♬、♬♬♪、シンコペーション♬♪♬、休符、三連符、大シンコペーションまで — し、基音の上でメトロノームと共に再生します（テンポは60-100に制限）。1小節のカウントインの後に再現します：🎤 マイクで（メロディでも単音でも、アタックをはっきり切って）または👆 タップで（スペースキーかボタン）。音型ごとの判定（緑／赤）、余分なアタックも表示；レイテンシは自動補正 — リズムの配置だけが評価されます。

ポイントとバッジ

正解 × レベル × 100、外した音型ごとに −20、余分なアタックごとに −10、2回目以降の聴き直しごとに −5；1000ポイントごとにレベルアップ、12つのバッジ、↺でリセット。内容は、演奏したリズムの数（1、3、10）、パーフェクト（1、3、10）、連続パーフェクト（2、5）、一度聴いてパーフェクト（3）、そして各レベルでのパーフェクト — 中級・上級・エキスパートを各3回、レベル間で兼ねることはありません。回答方法は問いません：マイクとタップは完全に同等です。ブラウザに保存、オフライン対応。

🎯 実践例 — ある生徒が8分音符を早く弾きすぎる傾向がある場合：レベルを初級に設定し、まずはマイクではなくタップ（👆）で答えさせて、音程の正確さが影響しないようリズムの問題だけを切り分けましょう。

8 quinquies. マイクセンサー（テスト） 🎙︎

🎙︎? ボタン（ツールバー）：タブ譜に何かを書き込む前の確認ステップです。検証するまでは何も変更されません。

🎤 センサーを有効化し、再生（▶）を始めて伴奏に合わせて演奏してください。検出された各アタックは、演奏位置、対応する割当先、音名、対応するタブ譜の穴、そしてずれ（ミリ秒）とともにリストに表示されます。グリッド（四分音符・八分音符・十六分音符）は目標とする量子化の精度を決めます。

レイテンシをキャリブレーションする

ハーモニカから音が出た瞬間と、マイクがそれをアプリに伝える瞬間の間には、常にわずかな遅れ——レイテンシ——があります。補正しないと、リズムに関わるすべてが狂います。リズム工房や 🎯「タブ譜を演奏」モードは、ぴったりのタイミングで弾いた音でも「遅れている」と判定してしまうことがありますし、✍ タブ譜に書き込む… による自動書き込みでは音符と音価が少しずれて配置されます。スウィング・メーターも、あなたの音同士の時間差を基準にしているため、多少影響を受けます。タイム計測系の練習や自動書き込みを使わない限り、レイテンシはまったく気にしなくて構いません。

⏱ レイテンシテスト（最も簡単、まずこれから）：

1. ⏱ レイテンシテスト をクリックします。
2. 短いカウントインの後、メトロノームだけが8回クリック音を鳴らします（メロディなし）。
3. 各クリックに合わせてはっきりと切り離した音を1つ演奏してください——どの穴でも構いません、大事なのはクリックにぴったり合った、きれいな音です。
4. 8回のクリックが終わると、アプリは各アタックを対応するクリックと比較し、中央値のずれを計算します。

結果が表示され（例：「8アタック・レイテンシ中央値42ms」）、レイテンシ (ms) の欄が自動的に埋まります——他に何もする必要はありません。この設定はアプリ全体で記憶されます。

⌁ キャリブレーション（実際の条件で微調整する）：

1. 🎤 センサーを有効化し、実際の再生（▶）を始めて普通に演奏してください。
2. 演奏した各音がリストに追加され、それぞれのずれが表示されます。
3. ⌁ キャリブレーション をクリック：アプリはこのテイクの中央値のずれを取り、すでに設定されているレイテンシに加算します。

条件を変えて（ヘッドホンあり／なし、別のマイク、別の部屋）これを繰り返すと、さらに精度を高められます。

スウィング（裏拍の位置）：手動で設定するか、◱ スウィングを測定 で直前の演奏から求められます。レイテンシとは無関係——グリッドとスウィングは、目標とする分割精度と三連符系のフィーリングを設定するだけです。

メロディや即興演奏をタブ譜として録音する

センサーは、アプリ自身の ▶ 再生 の時計を基準にしてしかアタックを測定しません。何かを取得させるには、演奏中にアプリの再生が動いている必要があります——休符だけの内容であっても構いません。

ケース1：メトロノームに合わせてソロで演奏する

1. ハーモニカの図でハーモニカのキーを選びます。
2. マイクセンサーを開き、有効化します（🎤 センサーを有効化）。
3. 「マイタブ譜」を、希望のテンポで空の小節（休符のみ）で埋めます——必要な数だけ。
4. この無音の小節の再生 ▶ を開始します。これがメトロノームを動かし、センサーに時間の基準を与えます。
5. クリックに合わせて、メロディを演奏します。
6. ✍ タブ譜に書き込む… をクリックします（詳細は後述）。

ケース2：YouTube動画に合わせて演奏する

ケース1と同じ流れですが、ひとつ制約が加わります。再生のステップで、YouTube動画と無音小節の再生を同時に手動でできるだけ近いタイミングで開始してください。その後は動画に合わせて演奏します——アプリのメトロノームは、もうセンサーの内部時計を動かすためだけのものになります。

この手動同期は、遅いテンポではとてもうまくいきます。1拍が長いので、多少のズレがあっても拍全体に占める割合はごくわずかで、音は正しい位置に収まります。速いテンポでは同じズレの重みが大きくなり、音が隣の位置にずれてしまうリスクが高まります。

✍ タブ譜に書き込む… をクリックすると「テイクを確認」が開きます：小節ごとの比較で、✓ はあなたの演奏を採用、✕ は元のタブ譜を維持します（すべて採用 / すべて破棄 のショートカットあり）。「適用」を押すまでは何も書き込まれません — Ctrl+Z 一回で元に戻せます。

9. キーボードショートカット

キー	動作
1–0	ブロー音、1～10番の穴
Shift+1–0	ドロー音
スペース	再生／停止
P	一時停止／現在の音符から再開
← / →	前／次の選択
Delete	選択（または最後の音符）を削除
Shift+クリック	範囲選択
Ctrl+Z / Y	元に戻す／やり直す

AZERTYおよびQWERTYキーボードに対応。

10. 音声録音 🎙（ベータ版）

演奏の音声記録を残すためのものです。タブ譜に変換されることはなく——聴き直したり送ったりできる音声ファイルだけです。

ファイル名を入力し、マイク（システムのデフォルト）を選び、⏺、次に⏹：プレーヤーが表示され、⬇でダウンロード、🗑 消去で録音を削除します。webm/opus モノラル形式（約1MB/分）、どこでも再生できます。

🎯 実践例 — エクササイズをループ再生し、録音を開始して2、3回演奏を重ね、停止してから元の音源と比べて聴き直してみましょう：先生が隣にいなくても自分の弱点を見つけるのに優れた方法です。

10 bis. 動画によるエクササイズ 🎯（ベータ版）

前のモジュールの逆です：スケールから始めてエクササイズを生成するのではなく、バッキングトラックから始めて、アプリがその上で練習すべきポジションを提案します。

ドロップダウンリストから曲を1つ選びます（まずご自身の動画、次にライブラリ）——キー、モード、スタイル、テンポは自動的に入力され、動画が表示されます。キーまたはモードを変更すると、リストはそのキー・モードのバッキングトラックに絞られ、ラベルに件数が表示されます；✕ すべて表示で全リストに戻ります。あるいは任意の動画に対して、YouTubeリンクを貼り付け、キー、モード、スタイル、テンポを手動で入力すると、アプリはそれに合った2つのバッキングトラックを提案します。

リストされた各ポジション（ハーモニカ＋スケール）には、そのポジションとキーでハーモニカを読み込んですぐにエクササイズを生成するボタンがあります。バッキングトラックを選ぶと🎼ジェネレーターが最初のポジション、1小節にあらかじめ設定されます。

11. ピッチ（音程）認識 🎤（ベータ版）

アプリのマイク系ツールの中で最も汎用性が高いモジュールです：リアルタイムで音程の正確さを確認するのにも、事前に何も準備せずに演奏したメロディを自動的に記譜するのにも役立ちます。

シンプルな聴き取り

🎤 聴き取りを開始し、持続音を演奏してください：アプリは音名、タブ譜の穴（選択したキーに応じたテクニックの色）、そして正確さ（±50セント）を表示します。

リアルタイムでタブ譜に音符を書き込む

「音符をタブ譜に書き込む」：アタックからアタックまでを計測した実際のリズム値による自動記譜——切り離された4分音符は4分音符のまま記譜されます（間隔の約40%未満のアーティキュレーションの間は無視されます；それを超えると実際の休符が記譜され；4拍を超えると、息継ぎとして扱われ何も記譜されません）。最後の音を早く離した場合：切り上げて完全な音価にします。聴き取り終了時、リズムは自動的に補正されます：実際のテンポが推定され、音価が再量子化され、テンポが設定されます。任意のメトロノームはグリッドに合わせられます。Ctrl+Zひとつでセッション全体を取り消せます。

🎯 実践例 — 頭の中でメロディが離れないのに何も書いていないとき：「音符をタブ譜に書き込む」にチェックを入れ、完全に自由に演奏したいならメトロノームのチェックを外し、「🎤 聴き取りを開始」をクリックして演奏します。止めれば、メロディはすでに「マイタブ譜」に入っており、必要なら修正できます。これは外部のバッキングトラック（YouTube、CDなど）の上でも使えます：メトロノームのチェックを外すだけで、曲の音とぶつからなくなります。

その他の使い方：メーターでベンドを確認する、オーバーブローを確認する、リフを耳コピして自動的に記譜させる。

📈 リアルタイム演奏トレース

チューナーとともに展開されます（タイトルをクリックすると折りたためます、🗑で消去）。上部には五線（ト音記号）：各音符が演奏された正確な瞬間に配置され、グラフと連動します；トレース（五線またはカーブ）をクリックすると、その時点の読み取り値がチューナーに送られます（針、音名、タブ譜、周波数、セント）。下部にはスクロールするグラフ（8秒）：あなたの音高が点線で、ダイヤルと同じ色で表示されます——±5セントで緑、±15セントまで橙、それ以上は赤。色付きの水平線は目標音（余白にタブ譜表示）です。縦軸は固定されています：線の間隔は一定のままで、演奏された音符に枠が中心を合わせるだけです。

操作：クリック＝フォーカス、←/→で±1秒（Shift：5秒）、マウスホイール、クリック＆ドラッグ；カーソルを合わせるとスクロールが停止します（⏸バッジ）、縦のカーソルで正確な読み取り（タブ譜、音名、セント）；End/Escでライブに戻ります。⏸ 固定ボタンはマウスを乗せたままにしなくてもカーブを安定して確認できるようスクロールを止めます；▶ 再開でライブに戻ります。約5分間の履歴。

🎚 クロマチック・チューナー

±50セントのダイヤル：緑ゾーン±5（正確）、橙±15まで、それ以上は赤。滑らかな針、目標ゾーンの色を反映する音名ラベル（緑／橙）、対応するタブ譜、周波数。正確 ✓という文字は緑ゾーンでのみ表示されます。停止すると表示は固定され（🗑でリセット）、モジュールはトレースとともに折りたたまれます。選択したハーモニカの音域に限定されます。

🎯 トレーニングモード：特定のベンドを練習するのに便利です。モードにチェックを入れ、リストから目標音を選びます——ベンド、オーバーブロー、オーバードローのみ（練習すべき音）。針は最も近い音を指し続けます（端で固まることは決してありません）。一方、文字で表示される判定は目標に対して測られます：「低すぎ ↓」、「高すぎ ↓」、そして目標に達すると「正確 ✓」。判定はトレーニングモードでのみ存在し、「正確」は針が緑ゾーンにあることも前提とします。

A(ラ)音のキャリブレーション（440Hz、▲▼、415～466）：多くのハーモニカは442～443Hzに調律されています。グローバルで記憶される設定：チューナー、認識、再生はすべて同じ基準ピッチを使用します。まずA音をキャリブレーションしてください。

🎯 タブ譜を演奏 ― 検証付き練習

期待される音が青く点滅します；自分のペースでマイクに向かって演奏してください：正確なら→緑、次へ；間違っていれば→赤、もう一度。最終結果：確定した音符数、間違った音符数、セント単位の平均的な正確さ。どんなタブ譜でも使えます——ジェネレーターと組み合わせれば、セッションごとに新しく、判定付きのエクササイズになります。

ベータ版の制限

• 一度に1音のみ（コードや分割オクターブには対応しません）。
• はっきりした音符が必要；テンポに応じた最小保持時間；±40セントで判定（大まかすぎるベンドは記譜されません）。
• 同じ音を2回続ける場合：はっきり切り離してください。音符間の休符は記譜されません。
• アプリのキーをお使いのハーモニカに合わせてください；静かな環境をお勧めします。

11 bis. スウィング・メーター 🎵（ベータ版）

スウィング・メーターは、8分音符を演奏している間、マイクであなたのスウィング比率を測定します：50%＝バイナリ（イーブン）、66.7%＝ターナリ（スウィング）。これはあなたのアタック間のインターバルに基づいており、オーディオのレイテンシに影響されません——使用前に何もキャリブレーションする必要はありません。

ゲージと分かりやすい判定——イーブンな目標にはプレイスメントOK、三連符系の目標にはスウィングOK——がリアルタイムで目標に合っているかを示し、演奏を止めてもそのメッセージは表示されたままです。目標（イーブン50%またはトリプレット66.7%）を選び、テンポを設定し（ツールバーと同期）、モジュールに選んだスケールで8分音符のエクササイズを生成させることもできます（2、4、6、または8）——または「自由」で好きなように演奏できます。🗑でモジュールをリセットします。

12. エクスポート

4つの形式があり、それぞれ用途が異なります。

エクスポート	内容	用途
.json 💾	すべて：音符、音価、テンポ、キー、モード	確実な保存、共有、アーカイブ
.mid 🎹	音符と音価、GMハーモニカ音源	MuseScore、DAW、バッキングトラック
.xml	正確な楽譜：完全な小節、タイ、三連符、付点——「マイ・コード進行」にグリッドがあれば五線の上にコードシンボルも	MuseScore、Guitar Pro、Sibelius
🖨	タブ譜、1行12音符、キー、テンポ、日付、ロゴ	レッスン資料、PDF

🎯 実践例 — レッスンで見たのとまったく同じ、編集可能なバージョンを生徒に自宅で練習させたいとき：.jsonでエクスポート。スマホや音楽アプリで聴くだけでよいなら：.midでエクスポート。読む用の本物の楽譜を渡したいなら：.xmlでエクスポートしてMuseScoreで開いてください。

13. よくある質問

• 最初のクリックで音が鳴らない（iPhone／iPad）：ブラウザは最初の操作で音声のブロックを解除します——音符をクリックしてください。
• キーを変えると音符も変わりますか？タブ譜自体は決して変わりません；変わるのは名前と音高だけです——ハーモニカを持ち替えるのと同じです。
• セッションが消えた：保存はこのブラウザに固有です（プライベートブラウジングやデータ消去で消えます）——長く残したい場合は.jsonでエクスポートしてください。
• オフラインで使えますか？はい、完全に：単独完結型のファイルです。
• インポートしたMIDIが不完全：選択したキーで演奏不可能な音がリストされます；アプリが最適なキーを提案します。
• インポート時にオーバーブローが拒否される：標準的なリヒター配列のハーモニカには、オーバーブロー1・4・5・6とオーバードロー7・9・10しか存在しません。
• 「ハーモニカの範囲外」：検出された音が選択したキーに存在しません——設定を確認してください。
• ⟳と部分ループの違い：⟳は演奏されているものを繰り返します；範囲を選択した場合（Shift+クリック）はその部分だけです。

14. エフェクト記号とテキストエクスポート

✨ 音符へのエフェクト記号

ノートエディタ（音符をダブルクリック）では、リズムや音価には一切影響しないエフェクト記号を追加できます：演奏の意図をメモするためだけのものです。

まず位置（音符の前か後）を選び、次に希望する記号をクリックします。1つの音符に、前後を問わず複数のエフェクトを付けることができます；それぞれが独立して機能します。

記号	エフェクト
/	下からのアタック（軽いアタック・ベンド）
\	「泣き」の音：音の終わりに軽いベンド
vib	ビブラート
Wa	手による「ワウワウ」エフェクト
DS	ダブルストップ（2音同時）
TBS	タンブロッキングの「スラップ」
TBO	タンブロッキングの「オクターブ」
→	次の音符へのグリッサンド
↔	2音間のトリル

グリッサンドとトリルはアプリの音では再現されません。記号はタブ譜上に（音符の周りにオレンジ色で）表示されます。

エクスポート時：テキスト（.txt）では各記号が独立した要素になります（例：DS TBS +4 vib Wa）；MusicXMLでは、各エフェクトがMuseScore上で音符の下に表示される独立したlyricになります。

📝 テキストエクスポート（.txt）

TXTボタン（ファイルグループ）は、エフェクト記号も含めたタブ譜をプレーンテキストとして、タブ譜の名前でダウンロードします。

用于创建、聆听和练习10孔布鲁斯口琴谱的网页应用。单个文件，无需安装，无需联网：在浏览器中打开 harmonica-trainer.html 即可。界面提供七种语言（应用页脚的国旗图标，选择会被记住——本说明书遵循相同设置）。

💡 本说明书按模块顺序组织，与应用中出现的顺序一致。每一节都会说明该模块是做什么的、怎么用，并至少提供一个实践案例供你立即上手。

1. 第一步

页面顶部的滚动横幅展示 apprendrelharmonica.com 的内容；鼠标悬停时暂停，点击可打开网页。页面底部的网站标志也会出现在打印的谱子上。

一开始就该知道的四个操作

• 点击一个音同时完成播放和记谱。点击虚拟口琴上的每个孔都会播放该音并把它加入谱子——不用去找"添加"按钮。
• ▶（或按空格键）播放已写好的内容。谱子是空的？"试试看：…"按钮会提供一小节布鲁斯乐句，每次显示都不一样。
• 💾 无需手动保存。应用会自动保存在浏览器中：关闭再打开，明天再来，会话原样恢复。
• 📂 大多数模块点击标题即可展开或收起；口琴示意图和"我的谱子"始终保持展开。

🎯 实践案例 —— 第一次打开应用：点击虚拟口琴上的几个孔听听声音，按空格键听一下刚才作的曲子，然后不保存直接关闭标签页。重新打开应用：你的小旋律还在。

1 之二. 自定义布局 🔀

默认情况下，各模块按标准顺序堆叠。如果你主要用两三个工具（比如旋律生成器和节奏工坊），可以把它们挪到一起，避免每次都要滚动页面。

• 用手柄 ⠿ 拖动每张卡片：它会吸附到页面的列上。
• "布局"栏可保存多个命名布局，并从菜单中调用。
• ↺ 恢复原始布局；💾 将你的布局导出为可重新导入的文件。

一切都保存在浏览器中，仅限本设备——如果换电脑，导出你的布局以便在别处找回。

2. 记谱法

应用中的谱子读法和传统纸质谱一样，只是为弯音和超音增加了一些符号。

写法	含义
+4 / -4	吹／吸 4号孔
-3', -3'', -3'''	吸弯音降1、2、3个半音
+8'	吹弯音（8～10号孔）
+6° / -7°	超吹／超吸
z	休止符（用于文本导入）

同一套颜色代码在整个应用中反复出现——在谱子上、虚拟口琴上、实时演奏轨迹上：吹·吸·弯音·超吹·超吸。一旦记住这套代码，你会先看颜色，再看数字。

3. 虚拟口琴

这是应用的核心：一把完整的口琴，调性显示在图表上方。每一列从上到下依次排列：超吹、吹弯音、吹音、吸音、吸弯音、超吸。

• 点击孔的编号会添加对应孔的吹音。
• 鼠标悬停在某一列上会点亮它，方便你一眼看清该孔上所有可用的技巧。
• 显示的音名会随所选调性和八度变化——更改调性，名称会变，但声音的物理位置不变。

3 之二. Keyfinder 调性助手 🔑

Keyfinder 回答的是每位口琴演奏者迟早都会问的问题："这首曲子该用哪把口琴？"——或者反过来："手头这把口琴能弹什么？"它还会显示所选把位的关键音（主音、三度音、五度音、七度音）及在口琴上的位置。

实践案例1：从曲子的调性出发

1. 点击"找口琴"标签页：选择曲子的调性（例如C调）。
2. 选择你想用的把位（例如二把位）。
3. Keyfinder 会告诉你该用哪把口琴，并显示关键音：主音、大三度、小三度、纯五度、小七度、大七度——以及它们在口琴上的位置。

举例：对于用二把位演奏的C调曲子，Keyfinder 会推荐F调口琴，并立即显示主音、三度音、五度音和七度音的位置。

实践案例2：从手头的口琴出发

1. 点击"找调性"标签页：选择你的口琴调性（例如E调）——可同时选择多把口琴。
2. 工具会显示12个可弹奏的调性及对应的把位。
3. 选择适合曲子风格的把位，然后在乐器上定位关键音。

举例：用E调口琴，一把位弹E调，二把位弹B调，三把位弹F#调，以此类推。

被高亮的音——以及它们为何重要

音	作用
主音	该调性的主要参照音
大三度	赋予大调色彩
小三度	赋予小调／布鲁斯色彩
纯五度	稳定的支撑音
小七度	布鲁斯／属和弦色彩
大七度	爵士／大调色彩

简而言之：无论你是从曲子的调性出发还是从乐器出发，Keyfinder 都能几步之内引导你——节省时间，弹得更准更快。

4. 工具栏

工具栏集合了五大类命令，会频繁用到，值得从一开始就熟记。

🎵 播放

• ▶/⏹（空格）：播放或停止谱子。⏸ 暂停（P键）会暂停并记住当前的音——再点一次（或按P）会精确地从那里继续，而⏹则彻底停止并忘记位置。
• 从任意位置开始：点击谱子中的某个音，▶会从那里开始播放（未选中任何内容时，则从头开始）。从曲中间继续播放会跳过弱起小节和倒数，并把和弦网格与当前播放的小节对齐。
• ⟳ 无缝循环——旁边的 ×N 输入框可设置循环次数（播放N次后停止；留空为无限循环）。
• 🎹 柱式和弦：位于循环次数输入框旁，让和弦构建器的和弦整体发声，而非琶音。
• ⏱0 倒数：节拍器只在弱起小节（第0小节）期间响，之后保持静音。
• 速度 40–240，🔊 音量，⏱ 节拍器（重音根据拍号：每4或3拍一次）。
• TAP：用鼠标按节奏点击来设定速度——取最近几次点击的平均值应用到整体速度；RESET 清除点击记录。

🎯 实践案例 —— 你不知道想练习的曲子的确切速度：在手机上听原曲的同时用 TAP 打拍子，应用会推算出 BPM 并直接设置。

播放时，当前音符会在谱子和口琴图上同时亮起——这是一个便于跟随、不迷失的视觉标记。

🏋️ 练习

• 旋律用的🎼 生成器（第7节详述）。
• 🎶 和弦构建器与♬ 和弦进行（第7之二节详述）。
• 🧩 曲目结构（第7之三节详述）。
• 🎙︎ 麦克风探测器（测试）（8 quinquies节详述）与👂 听音记谱（第8之三节详述）。
• 谱子的🔀 打乱（每次点击打乱一次，Ctrl+Z 可撤销）。
• ⇅ 先上行后下行。
• SWING（三连音风格的八分音符：落在拍子"后半拍"上的每次起音都会被延迟到该拍的三分之二处）。
• 🎲 随机时值。
• 渐进速度的+BPM（第6节详述）。

这些模式可以叠加：例如你可以同时打乱一段旋律、并开启摇摆、并启用渐进速度。

🎼 谱子（显示方式）

• TAB / 音名 / 唱名：在谱子、英美音名（C4、Bb3…）或唱名（Do4、Sib3…）之间切换。
• 调性（12把口琴）：名称和音高会随之调整，但谱子本身保持不变——这只是显示上的变化，不是内容变化。
• ▾8 / ▴8：将选中的音符移调一个八度（若未选中任何内容，则整个谱子；使用对应的孔）。若某音没有对应音，则不移动，应用会将其列出。选择方式：Shift+点击选一段范围，Ctrl/Cmd+点击单独选一个音，⇄ 反选 交换已选和未选。
• 1·3b·5 级数：在每个音符下方显示它在参考音阶中的级数——旁边的🎼按钮打开生成器以选择音阶，显示会自动与之对齐。音阶外的音会变灰；和弦构建器的琶音则显示和弦的音程（1、3b、5、7b…）。

📁 文件

• 📚 资料库：命名保存的谱子，存储在此浏览器中——加载、重命名、删除；⬇ 全部导出为可重新导入的 .json。窗口可用鼠标拖动。
• 💾 / 📂：完整的 .json 文件；📂 也可打开 .mid 文件（转换为谱子：时值量化，重建休止符，应用速度，列出无法演奏的音，建议最佳调性）以及 .xml/.musicxml 文件。
• 📋 导入文本谱子（第5节详述）· 🎹 MIDI（GM Harmonica 音源）· XML MusicXML：精确的乐谱——音型与时值始终一致，完整小节，连音线均已写出；MuseScore 不会重写任何内容。· TXT：导出为带效果（压音、超吹超吸等）的纯文本，方便粘贴到消息中。
• 🖨 打印：整洁的排版，白色背景，标志，每行12个音符（通过浏览器的"打印为PDF"生成PDF）。

🎯 实践案例 —— 你在为学生准备课堂讲义：构建好谱子，点击🖨 打印，然后在浏览器对话框中选择"打印为PDF"。生成的PDF保留你的标志，即使黑白打印也依然清晰易读。

✏️ 编辑 与 ♩ 时值

↶/↷（Ctrl+Z / Ctrl+Y），🗑 全部清除，? 帮助，! 重置已打开窗口的显示（当窗口卡住或被移到屏幕外时很有用）。

提供九种节奏时值：全音符、二分音符、四分音符、八分音符、十六分音符、三连音、附点（+50%），以及三种休止符（1、½、¼拍）。所选时值会应用于接下来输入的音符；对已有选区，则会直接修改它。

跨小节的音符：显示时会被拆分，并以 ‿（虚线连接部分）相连——该音符本身仍是一个整体，一口气演奏；MusicXML 导出会写出连音线。

‿ 连音线：连接所选音符——‿ 符号会显示在它们之间。两个音高相同的连音音符会一口气衔接，没有重新起音，MusicXML 导出会写出乐句连线。音符编辑器（双击音符）中的 ‿ 按钮也可以逐个音符实现同样效果。

5. 导入文本谱子 📋

便于导入在论坛、书籍上找到的谱子，或学生用短信发来的谱子——无需全部手动重新输入。

粘贴你的谱子（音符以空格分隔；也接受逗号、换行、|）：+4 -4 +5 -5 +6 -6' -6 z +6 -5 +5 -4 +4。+ 可省略，z 插入休止符，无效元素会被忽略并列出，导入内容会追加在已有内容之后。

6. 练习一个段落

两个工具可帮助你在某个具体点上取得进步，而不必每次都重新弹完整首曲子。

局部循环

点击第一个音，按Shift+点击最后一个音：该范围会高亮显示，▶ 只播放这一段，⟳ 循环播放它。不按Shift点击即可退出。这个范围也可用于一次性更改所有时值或删除。

🎯 实践案例 —— 一段较长的独奏中有个两小节的乐句总弹不好：选中它（Shift+点击），打开⟳，让它循环播放，专心练习这一段，完全不必重弹曲子其余部分。

渐进速度（+BPM）

设置步进量（每次循环增加1–20 BPM）和最大值：每循环一轮，速度就会上升并显示出来。也适用于选中的范围：即使🎹伴奏处于开启状态，选区每循环一次速度也会上升。

经典例子：4个难点音符，从60 BPM开始，步进4，最大120——你从慢速开始，每次成功一轮后应用会自动加速，你自己完全不用去调速度。

7. 旋律生成器 🎼

生成器谱写的是连贯的旋律，而不是随机的音符堆砌：音阶按把位分组——大调与大调五声（一把位）；布鲁斯、混合利底亚、五声（二把位）；小调五声、布鲁斯、多利亚（三把位）；自然小调、小调五声（四把位）；弗里几亚、小调五声、带弯音的自然小调（五把位）；利底亚、带弯音的大调（十二把位）。四个级别（初级：4–8号孔 → 专家级：含超吹），可选1、2或4小节。旋律总是以主音结束，除非你勾选"不以主音结束"。

窗口在你操作时保持打开：反复重新生成（🎼）、聆听、调整，而不会失去对应用其他部分的操作权。点✕或取消关闭它；如果结果不满意，Ctrl+Z 会恢复之前的谱子。

我的设置 —— 就在"给我惊喜"下方，可以把整个窗口的配置命名保存，一键调回：音阶、级别、音域、长度、乐句、拍号、每小节音数、勾选的时值、跟随和弦进行，以及两个注入滑块。💾 保存（使用已有名称会覆盖原设置，不会产生重复项），🗑 删除选中的设置，⬇ 把全部设置导出为 .json，📂 重新导入。此外，你最近一次生成时的设置会自动记住：下次启动应用时，窗口会保持你上次离开时的样子。

一键快速生成

生成器顶部的给我惊喜按钮会替你设置好菜单（你能看到它们在变化）并立即生成：一次点击，一段旋律。再次点击可获得新的抽取结果。详细设置保留在下方，供想精确选择音阶、把位和级别的人使用。

🎯 实践案例 —— 上课前只有5分钟，想快速给初学者展示一个例子：连续点几次"给我惊喜"，直到得到简单又好唱的旋律，完全不用碰任何设置。

阅读并演奏刚生成的内容

记谱法提示"📖 如何读谱？"（吹、吸、弯音、颜色代码）可在编辑菜单的帮助 ? 中找到。一旦有了音符，谱子下方会出现一排图标：▶（红色）播放谱子，⏹（绿色）停止，麦克风图标（蓝色）启动🎯模式（你在麦克风前演奏，应用逐音判定），+ 添加或插入一个音符——在选中音符之后，若无选中则加在末尾——并打开编辑器；再次点击可添加更多，小节线会重新计算。

乐句处理：赋予旋律形态

除了"逐音排列"的旋律外，你还可以指定乐句类型：问答（两个相互呼应的部分）、拱形（先上升后下降）、谷形（先下降后回升）、波浪形（连续起伏）、持续上行或持续下行（乐句只朝一个方向穿越音域）、轻爵士（对某些音的半音接近）或完整比波普（包围音型，八分音符）。选择"无"则由应用自由决定。

上行与下行给出的是整体走向，并不是音阶：旋律线从低到高（或反过来）推进，同时允许小幅回折，因此听起来仍然像音乐。穿越哪一段口琴，由低音 → 高音两个菜单决定。由于最后一个音会落在主音上，可能会略微回折：勾选"不以主音结束"即可让方向一贯到底。

谷形是拱形的反面：乐句从高音区出发，下探，然后重新爬升。波浪形把方向变化一个接一个串起来——每两小节一次起伏——正是训练折返的乐句类型，而许多学生往往被一个方向带着跑。

AAB 布鲁斯 —— 把演唱的曲式写在你的和弦进行上

AAB 布鲁斯乐句会像人们演唱的那样写出一段布鲁斯乐段：乐句 A 占据第 1 至 4 小节，A' 在第 5 至 8 小节原样重复——和弦已经走到 IV，旋律却纹丝不动，张力正是由此而来——接着 B 在第 9 至 12 小节回应并收束。每一个四小节的段落都以一次换气结束：乐句在第 4 小节和第 8 小节落在一个支点上，随后让出空间，就像歌手让乐器来回应。B 比陈述部更密集，收尾的几个音向主音下行。

该乐句需要12 小节的和弦进行并勾选"跟随我的进行"：这是曲式本身的要求。二者缺一时，应用会直接告诉你，而不是生成别的东西。A' 中只有一个音会被修正：落在属七和弦上的大七度（C 调中 F7 上的 mi）下降半音——布鲁斯音则原样保留。

🎯 实践案例 —— 从"和弦进行"载入12 小节布鲁斯预设，发送到"我的进行"，勾选"跟随我的进行"，选择 AAB 布鲁斯：你会得到一段结构完整的乐段，可以让学生视奏或扒谱。

问答现在除了 4 小节，也支持 2 小节：第二小节沿用第一小节的节奏和开头，而问句悬停在属音上。不必用满 4 小节，也能得到一条短小方正的乐句。

🎯 实践案例 —— 和学生练习音域：持续下行、4 小节、中级、音域限定在 4 至 8 孔——得到的是一条走完整个所选音域的下行乐句，而不是一条单纯的下行音阶。

拍号、时值与音域

选择拍号——4/4、3/4（华尔兹）、6/8 或 12/8：整个应用都会随之调整（小节线、节拍器、MIDI 和 MusicXML 导出）。长度：1、2 或 4 小节。

通过只勾选需要的值来限制使用的音符时值——全音符、二分音符、四分音符、附点四分音符、八分音符、十六分音符、三连音或四分音符三连音。

举例：仅全音符表示每小节一个音，或仅二分音符表示每小节两个音——非常适合极简单的乐句或第一个级别。全部勾选＝自由。

如果要求的音符数不足以填满小节——例如4/4拍下只有4个八分音符——应用不会拒绝，而是用休止符补齐：休止符会分散在小节内，而不是堆在末尾，好让旋律有喘息空间。

两个最低音→最高音菜单可将生成的旋律限制在你选择的口琴音域范围内，范围来自所选音阶和级别下可用的音——便于停留在乐器的特定区域。它们会在音阶或级别变化时自动重新填充。

每小节音符数。设置一个最大值：设为6时，应用会使用最多6个音，不一定正好6个。勾选"精确此数量"可强制使用确切数量。

在和弦进行上生成

如果勾选"跟随我的和弦进行"，所选音阶会应用于你的和弦进行（"我的和弦进行"模块）中的和弦，无论其调性如何——便于尝试意想不到的音色（注意不协和音）。每个和弦都保留其自身的时长（完整小节、半小节…）：生成的旋律会自动适应，无需额外设置。注入滑块随后会加入一定比例的音阶外音符和休止符（乐句末尾的换气）。

菜单"在进行上使用的音"决定音阶与和弦之间的取舍。自由把两者混合，由注入滑块控制——这是原有行为，可能会让音阶外的音混入（例如布鲁斯和弦的大三度）。严格音阶与仅共同音都会严格保持在所选音阶之内，没有例外——两者的区别在于选音的方式，而不是可用音的范围。在严格音阶下，当下的和弦完全不产生影响：旋律只按音阶走，不理会和弦。在仅共同音下，当某个音阶音同时也是和弦音时，应用会有机会优先选择它——尤其是在拍点上——但这既非固定也非强制：只是众多选择中的一种可能。这两个选项都会关闭注入滑块，因为它已不再起作用。

🎯 实践案例 —— 2nd position 布鲁斯音阶配布鲁斯进行：自由模式下，和弦大三度的音会混入旋律；切换到严格音阶，无论和弦如何变化，都能从头到尾保持布鲁斯的音色。

我的调式 🧬：创建自己的音阶

可折叠模块，用于创建自己的调式——名称、把位（1至12）、在12个半音中勾选的级数——保存在浏览器中，并在生成器、1·3b·5级数以及摇摆节拍器的音阶选择器中以（★）标记可用。✎ 编辑一个调式，🗑 删除它。

在生成器窗口中，音阶选择器旁边：🗑 从列表中移除当前显示的音阶（选择会被记住），↺ 重新显示所有音阶；⬇ 将你的调式导出为 .json 文件，📂 重新导入它们。

7 之二. 和弦与和弦进行 🎶

三个互补模块，用于以和弦而非单音进行练习：构建单个和弦、串联现成的和弦网格，以及播放/导出当前的和弦网格。

🎶 和弦构建器

练习分组：选择根音、和弦性质（从三和弦到十三和弦）、可选的变化音/张力音（b5、#5、b9、#9、#11、b13——根据性质激活）、可选的低音音符（斜杠和弦，如 C/E）以及琶音形态（上行，或上行加下行）。

拍号选择器（4/4、3/4、6/8、12/8）在构建前设定节拍——与旋律生成器和和弦进行共享；如果谱子已有音符，会要求确认，因为小节线会重新划分。直接以拍数选择和弦时长——4/4拍下为1、2或4；3/4拍下为1或3；6/8拍下为1½或3；12/8拍下为3或6——与"和弦进行"和"曲目结构"中使用的是同一个选择器。

确认会将和弦以琶音形式插入谱子末尾——使用可演奏的最低位置，包含超吹/超吸——窗口保持打开以便连续添加多个和弦；删除最后一个会移除最后添加的和弦。和弦名称会以徽章形式显示在该行开头，🔀 和 🎲 都在每个和弦内部起作用，不会破坏其小节结构。播放时，🎹（播放分组）会切换为块状和弦：每个和弦以钢琴音色整体奏响，而不是琶音。

♬ 和弦进行（预设）

练习分组中的可拖动窗口：约二十种经典和弦进行（流行、爵士、12小节布鲁斯、小调终止式……），可移调到12个调性并在大调/小调之间切换——勾选"仅调号"可只改变显示的调号而不移调和弦。

在插入前，和弦进行是可编辑的：点击某个和弦可更改其根音、性质、张力音、低音音符，以及根据拍子而定的自身时长（1、2或4拍）——每个和弦都保留自己的时长，因此你可以在同一网格中混合一个完整小节和两个半小节。窗口的拍号选择器决定节拍，由此得出完整小节的时长：4/4拍为4拍，3/4拍为3拍，12/8拍为6拍。◀ ▶ 移动和弦，✕ 移除它，+ 添加一个。显示切换名称／级数（罗马数字）。

💾 将你的和弦进行保存到预设列表（★，🗑 删除），⬇ 将你的和弦进行导出为 .json，📂 重新导入。→ 我的和弦进行 会将构建好的网格发送到下方模块，不经过谱子。你保存的曲目结构（🧩模块，7之三节）也会出现在这个列表中，前缀为🧩：选择它们会把整个结构展平进网格，各部分的时长和调性都会保留。

♬ 我的和弦进行

此模块显示接收到的网格：每个色块显示和弦名称，如果与完整小节的时长不同，则在括号中标注时长（例如 G7 (2)）。无论其来源为何——预设、构建器（通过谱子）、或从谱子发送到此模块——时长都会被自动识别并遵循，无需任何手动设置。

• ♬ 伴奏播放：在谱子播放期间，网格会以钢琴音色伴奏，每个和弦都在其真实位置和时长上响起。
• 🪟 当前和弦：打开一个小的可拖动、始终置顶的窗口，大字显示当前和弦及下一个和弦——便于在不离开口琴视线的情况下跟随和弦进行。
• → 谱子：将网格转换为谱子中的琶音，每个和弦一组，各自拥有自己的时长。
• 💾 🎹 XML TXT：仅导出网格本身——JSON、MIDI（块状和弦）、MusicXML（和弦及符号写在五线谱上方，绝不作为音符）、文本（和弦名称）。
• 🗑：清空和弦进行。

🎯 实践案例 —— 你正通过视频通话教学生一个布鲁斯和弦网格：把一个12小节布鲁斯预设发送到"我的和弦进行"，打开🪟 当前和弦，在学生弹奏时让窗口保持可见——他们始终知道自己弹到哪里，不必去读整个网格。

在"我的谱子"标题栏中，→ 我的和弦进行按钮执行相反的操作：它会读取谱子中出现的（通过🎶构建的）和弦琶音，并在"我的和弦进行"中重建网格，包括时长。旁边的💾 🎹 XML TXT图标是完整旋律导出功能的快捷方式——与主工具栏中的相同。

7 之三. 曲目结构 🧩

此模块用于逐部分构建一首曲子完整的和弦网格，而不是单一统一的网格——一旦曲子有和弦不同的主歌和副歌，这个模块就很有用。

可拖动窗口（🧩按钮，练习分组）：前奏、主歌、副歌、桥段、独奏、间奏、过渡、尾奏，或自定义部分——每种类型都有自己的颜色，作为卡片上的边框呈现。添加一个部分会创建一张卡片并立即选中它；名称可编辑，调性和调式可在下方编辑器中设置，并一次性移调该部分的所有和弦。

构建某一部分的网格

每个部分的网格都使用与🎶（7之二节）相同的和弦构建器来构建：+ 打开构建器，确认 将和弦添加到该部分，窗口保持打开以便继续添加。之后，点击一个和弦色块会重新打开构建器，并预填该和弦以便修改它（根音、性质、时长……）而不影响网格的其余部分；色块右侧的小✕可将其移除；色块之间不起眼的+号可在该确切位置插入一个遗漏的和弦——连续的插入会按你输入的顺序依次相连。

重新排列和管理各部分

• ◀ ▶ 将某部分移动一格，或抓住其手柄 ⠿ 进行拖放，放到你想要的位置（蓝色边框会指示插入在鼠标悬停行的前面还是后面）。
• ⧉ 复制一个部分，📋 复制它，📥 粘贴 将其添加到结构末尾，🗑 删除它（需要确认）。
• ↺ 清空 一键清空所有部分（需要确认）：你保存的结构不会受影响。

💾 保存某个结构并命名：它会加入下拉列表（重新加载某个结构时，如果已有另一个正在进行中，会要求确认），旁边的🗑 将其从列表中移除。⬇ 将你保存的所有结构导出为 .json，📂 重新导入它们。你保存的结构也会以🧩前缀出现在"和弦进行"列表（7之二节）中：在那里选择它们会展平整个网格，各部分的时长和调性都会保留。

为特定部分生成旋律

对某个含有和弦的部分🎲 生成一段旋律：旋律生成器🎼会依据其网格、其调性，以及生成器当前的设置（级别、音阶、乐句处理……）进行创作，并将结果精确插入到该部分在"我的谱子"中所在的位置——谱子的其余部分不受影响；重新生成某个部分会替换它，而不是追加。

🎯 实践案例 —— 你正在用前奏／主歌／副歌／独奏构建一首曲子：为前奏生成一段平静的旋律，再为独奏部分单独生成一段更具技巧性的旋律，完全不动其他两个部分。

→ 我的和弦进行 按部分顺序将整个结构展平到7之二节的模块——路径与预设相同。

专用导出：TXT 生成可打印的网格，部分命名清晰，小节按列对齐；XML 生成一个 MusicXML 文件，每个部分从新的一行开始（带有部分标记和调号），和弦符号以国际记谱法显示在五线谱上方——如果"我的谱子"为空，五线谱保持空白（休止符隐藏），如果有内容则显示其旋律。

8. 精细编辑

一旦旋律就位——无论是生成的、导入的，还是逐音输入的——以下是精确调整它的方法。

操作栏一览

从上到下，标题栏中每个控件的作用：

• ⠿：在页面中拖动该模块。
• Ma tablature：模块标题；18 éléments · 4 mesures：音符/休止符与小节的实时计数器。
• ▼8 / ▲8：将整个选区下移/上移一个八度（未选中时对整个谱面生效）。
• Anacrouse：将第一小节声明为弱起。
• ▶（右上角红色图标）：打开该模块的教学视频。
• 💡 提示条：提醒双击音符即可编辑。
• ▶ / ■ / 🎤 / +：播放、停止、麦克风模式、添加音符。
• ⇄ Inverser：反转选区（吸气⇄呼气）。
• ✕ Note：删除最后输入的音符（以及对所选音符的其他操作）。
• 🗑 Tout：删除整份谱面。
• ⇅ Suivre：开启/关闭播放时的自动滚动。
• ♫ Arpèges：切换琶音显示模式。
• Muet：静音播放。
• → Ma progression：切换到关联的和弦进行模块。
• 💾 / 🎹 / XML / TXT：保存谱面，导出为 MIDI、MusicXML、文本。
• ⚠ Compléter la mesure：提示需要补全的不完整小节。
• 小节编号（左侧列）：标出该小节在网格中的位置。
• 音符格：孔位、时值与孔号 — 双击可编辑（音高、时值、休止）。

选择与删除

点击＝选择（新音符会插入在其后）；⌫/Delete 删除；←/→ 移动选区。自动编号的小节线（根据生成器中选择的拍号显示4/4或3/4）；计数器显示元素数和小节数。

音符编辑器（双击）

双击一个音符会打开完整编辑器：更改孔位（1–10）、技巧（只提供该孔实际可演奏的音，并附带其颜色）、时值和附点，将音符转换为休止符（或反之），或删除它。

补全、复制、清除小节

⚠ 补全小节：当最后一小节不完整时，这个按钮会出现在谱子上方。应用会在当前音阶内建议三种可能的结尾——选择其中一种，音符会被添加，小节正好补齐。

复制或清除一个小节。谱子的每一行对应一个小节。行末的两个小按钮可让你复制该小节（副本会插入其后）或一键清除它。

八度移调

八度 ±8。如果音高允许，▾8 / ▴8 可将选区（或整个谱子）升高或降低一个或两个八度；没有对应音的音符不会被移调。

播放时跟随和弦

⇅ 跟随 与 🎵 琶音。当"我的和弦进行"中存在和弦进行时，播放期间其和弦琶音可能被绿色边框围绕：⇅ 跟随 会让谱子朝它们滚动（关闭它以自行滚动），🎵 琶音 会让它们与和弦一起发声（关闭它则只保留钢琴音）。

谱子中的音符来自哪里？

这里会显示来自以下渠道的音符：你在示意图上的点击、麦克风（音高识别模块或麦克风探测器）、旋律生成器、资料库、"我的和弦进行"中的"谱子"按钮、该模块的+按钮，以及"试试看"按钮。

调号（用于导出）

导出的调号是自动确定的：它根据生成旋律的把位，跟随该旋律的主音，以大调或小调呈现——因此，在C调口琴上以三把位演奏的小调五声音阶，会得到D小调（一个降号），而不是口琴本身的调号。若没有生成的旋律，则采用口琴的大调调性。它会出现在MusicXML的第一小节（连同调式）以及MIDI中——MuseScore 会显示一份干净的乐谱。

弱起小节

在谱子的开头输入你的弱起小节，包括任何用于对齐的休止符——例如两个休止符后接两个八分音符——然后点击模块标题栏中的弱起小节：第一小节会变成第0小节，以虚线边框标记。再次点击可取消。它的音符编辑方式与其他音符相同（时值、双击、拖放）。播放时，第0小节只会在开头播放一次：循环⟳只会重复正文部分，而"我的和弦进行"的伴奏只从第1小节开始进入。开启节拍器时，弱起小节之前的空拍会被倒数计入——如果没有弱起小节，你会在开头得到一整个小节的倒数。MusicXML导出会写出真正的弱起小节（缩短的第0小节，去除开头的休止符）；MIDI则保留精确的时序。跨越小节线的音符会留在正文部分。

8 之二. 听写练习 🎧（测试版）

用于训练纯粹的听力：应用会播放一些内容，你需要不看谱子就辨认并弹回来。

使用方法

在调音器下方：选择1到6个音和级别——初级（4–6号孔）、中级（自然音）、高级（弯音，不含超音）、专家级（全部包含）。🎲 会在当前调性中播放一段可唱的乐句（音程≤五度，无重复）。▶ 重听 可随意使用；🎤 用麦克风回答：每个正确的音会填满对应的格子，错误的音会闪红并计为一次错误。揭晓答案 显示正确答案。绝不会写入你的谱子。

分数、统计与徽章

每完成一次成功的听写会获得分数 = 音符数 × 级别 × 100，每错一次扣20分，第一次以外的每次重听扣5分。模块下方显示：已完成的听写数、全对次数、纪录、累计以及当前连续记录（可通过↺重置）。七枚可解锁的徽章——铜／银／金耳朵（10/50/100次听写）、零失误与绝对音感（连续5次和10次全对）、演奏家（一次专家级零失误听写）、气息大师（超过1000分）。全部保存在浏览器中，离线可用。

🎯 实践案例 —— 睡前5分钟，手边没有可以看谱的口琴：开启一次初级听写，用床头的口琴对着麦克风演奏，看着你连续全对的记录一晚晚地增长。

8 之三. 听音记谱 👂（测试版）

类似于听写练习，但侧重于音阶和把位而非孤立的音符——有助于让耳朵习惯特定的音阶色彩。

使用方法

👂 按钮（练习分组）：应用会不显示地播放你选择的音阶/把位（包括你的★调式）中的几个音。设置级别和音符数（2–16），可随意重听，然后在窗口中重建这段乐句：🎤 用麦克风——每个弹出的音会变成一个标记——或手动输入（语法为+4 -4 -3' +6°；点击标记可移除，⌫可全部清除）。确认会在下方以绿/红逐音显示答案：判断正确与否以听感为准（-2 ≡ +3）。绝不会碰你的谱子。

分数与徽章

分数 = 正确音数 × 级别 × 100，每错一次扣20分，第一次以外的每次重听扣5分，在该题首次确认时计分。每1000分升一级；五枚徽章（首次零失误、10次和50次记谱、连续5次零失误、专家级零失误）；↺重置。保存在浏览器中，离线可用。

8-d. 节奏工坊 🥁（测试版）

独立于音准单独训练节奏——非常适合那些音弹得准但节奏"偏了"的学生，反之亦然。

使用方法

🥁按钮（时值组）：应用按级别生成一小节（4/4）的节奏 — 直至 ♪♬♬、♬♬♪、切分 ♬♪♬、休止符、三连音与大切分 — 并在主音上配合节拍器播放（速度限制在60-100）。一小节预备拍后再现它：🎤 用麦克风（旋律或单音均可，注意断开起音）或👆 点击作答（空格键或按钮）。逐音型判定（绿／红），多余起音亦标出；延迟自动补偿 — 只评估节奏位置。

积分与徽章

准确 × 级别 × 100，每漏一个音型 −20，每个多余起音 −10，第二次起每次重听 −5；每1000分升一级，12 枚徽章，↺ 重置。内容包括：已演奏的节奏数（1、3、10）、全对次数（1、3、10）、连续全对（2、5）、一遍就全对（3），以及各级别的全对 — 中级、高级和专家级各 3 次，级别之间从不叠加。作答方式不计入：麦克风与点击完全等同。保存在浏览器中，离线可用。

🎯 实践案例 —— 某个学生总是把八分音符弹早：将级别设为初级，先让他用点击（👆）作答而不是用麦克风，把节奏问题单独隔离出来，不受音准的干扰。

8 quinquies. 麦克风探测器（测试） 🎙︎

🎙︎? 按钮（工具栏）：在写入谱面之前的核查步骤。在你确认之前，任何内容都不会改变。

🎤 启用探测器，开始播放（▶）并跟着伴奏演奏：每个检测到的起音都会显示在列表中，包含演奏位置、对应格、音名、对应的谱面孔位以及以毫秒为单位的偏差。网格（四分音符、八分音符或十六分音符）设定所瞄准的量化精度。

校准延迟

从口琴发出声音的瞬间，到麦克风把它传给应用的瞬间之间，总会有一个小小的延迟——延迟（latency）。如果不校正，它会打乱一切与节奏有关的东西：节奏工坊或 🎯「演奏谱子」模式可能会把一个明明踩在节拍上的音判定为"迟到"，而通过 ✍ 写入谱面… 的自动书写也会让音符和时值略微偏移。摇摆表也会因此受到一点影响，因为它依据的是你各个音之间的时间间隔。只要你不使用计时练习或自动书写功能，延迟就完全不重要。

⏱ 延迟测试（最简单，先做这个）：

1. 点击 ⏱ 延迟测试。
2. 经过短暂倒数后，节拍器会单独播放 8 次咔哒声，没有旋律。
3. 在每次咔哒声上演奏一个清晰、断开的音——孔位无所谓，关键是声音干净，正好卡在节拍上。
4. 8 次咔哒声结束后，应用会把你的每次起音与对应的咔哒声比较，并计算中位偏差。

结果会显示出来（例如"8 次起音 · 延迟中位数 42 ms"），延迟 (ms) 栏会自动填入——不用再做别的。这个设置会在整个应用中被记住。

⌁ 校准（用于在真实条件下微调）：

1. 🎤 启用探测器，开始一次真实的播放（▶）并正常跟着演奏。
2. 每个演奏的音都会加入列表，并显示各自的偏差。
3. 点击 ⌁ 校准：应用会取这一遍的中位偏差，并把它加到已设置的延迟上。

在不同条件下（戴或不戴耳机、换个麦克风、换个房间）重复这个操作，可以进一步微调。

摇摆（后半拍位置）：可手动设置，也可用 ◱ 测量摇摆 从刚才的演奏中推算。它与延迟无关——网格和摇摆只是设定所瞄准的切分精度和三连音感觉。

将旋律或即兴演奏录成谱子

探测器只依据应用自身 ▶ 播放 的时钟来测量你的起音：要让它捕捉到任何内容，播放必须在你演奏的同时运行——哪怕里面只有休止符。

情况一：独自演奏，配合节拍器

1. 在口琴图中选择你的口琴调性。
2. 打开麦克风探测器并启用它（🎤 启用探测器）。
3. 把"我的谱子"填满空小节（只有休止符），设成你想要的速度——需要多少小节就填多少。
4. 开始播放 ▶ 这些无声小节：正是它让节拍器运转，并给探测器提供时间基准。
5. 跟着咔哒声，在上面演奏你的旋律。
6. 点击 ✍ 写入谱面…（详情见下文）。

情况二：同时配合一段 YouTube 视频

和情况一步骤相同，只多了一个限制：在播放这一步，需要手动同时启动 YouTube 视频和无声小节的播放，尽量让两者的起点靠得越近越好。之后你就跟着视频演奏——应用的节拍器现在只用来让探测器的内部时钟运转。

这种手动同步在慢速时效果很好：一拍持续的时间更长，所以同步上的小误差只占一拍中极小的一部分，音符仍然会落在正确的格子里。速度快时，同样大小的误差所占的比重就大得多，音符落入相邻格子的风险也随之增加。

✍ 写入谱面… 会打开"确认这一遍"：逐小节比较，✓ 采用你的演奏，✕ 保留原谱（快捷方式：全部采用 / 全部放弃）。点击"应用"之前不会写入任何内容 — 一次 Ctrl+Z 即可撤销。

9. 键盘快捷键

按键	动作
1–0	吹音，1至10号孔
Shift+1–0	吸音
空格	播放／停止
P	暂停／从当前音符继续
← / →	上一个／下一个选择
Delete	删除选中内容（或最后一个音符）
Shift+点击	范围选择
Ctrl+Z / Y	撤销／重做

支持 AZERTY 和 QWERTY 键盘。

10. 录音 🎙（测试版）

用于保留你演奏的音频记录，而不会转化成谱子——只是一段可以回听或发送的音频文件。

命名文件，选择麦克风（系统默认），⏺ 然后 ⏹：会出现一个播放器，⬇ 下载，🗑 清除 删除录音。webm/opus 单声道格式（约1MB/分钟），随处可播放。

🎯 实践案例 —— 开启某个练习的循环播放，开始录音，跟着弹两三遍，停止，然后回听并与原曲对比：这是在没有老师在场的情况下发现自己缺点的绝佳方法。

10 之二. 视频跟练 🎯（测试版）

与上一模块相反：不是从音阶出发生成练习，而是从一段伴奏音轨出发，应用会建议可以在其上练习的把位。

从下拉列表中选择你的一首曲子（先是你的视频，然后是资料库）——调性、调式、风格和速度会自动填入，视频会显示出来。一旦你更改调性或调式，列表就会缩小为该调性、该调式下的伴奏音轨，标签会显示数量；✕ 显示全部 会恢复完整列表。或者，对于任意一段视频，粘贴其 YouTube 链接并手动填入其调性、调式、风格和速度；应用随后会建议两段与之匹配的伴奏音轨。

对于列出的每个把位（口琴+音阶），都有一个按钮可以加载该口琴并立即生成一个练习，位于该把位和调性上。选择一段伴奏音轨会将🎼生成器预先设置为第一个把位，1个小节。

11. 音高识别 🎤（测试版）

应用中麦克风工具里最为通用的一个：既能实时检查你的音准，也能自动记录你演奏的旋律，事先无需任何准备。

简单聆听

🎤 开始聆听，演奏一个持续音：应用会显示音名、谱面孔位（颜色对应其技巧，取决于所选调性）以及你的音准（±50音分）。

实时写入谱子

"将音符写入谱子"：以逐次起音测得的真实节奏值进行自动记谱——一个断开的四分音符仍会被记为四分音符（约低于间隔40%的分句间隙会被吸收；超过则记为真正的休止符；超过4拍则视为换气，不记谱）。若最后一个音过早松开：会向上取整为完整时值。聆听结束时，节奏会被自动校正：估算真实速度，重新量化时值，设定速度。可选的节拍器会与网格对齐。一次 Ctrl+Z 即可撤销整个会话。

🎯 实践案例 —— 脑海中有段旋律挥之不去，却还没写下来：勾选"将音符写入谱子"，如果想完全自由演奏就取消勾选节拍器，点击"🎤 开始聆听"然后演奏。停止后，你的旋律已经出现在"我的谱子"中，如有需要可再修正。这在跟着外部伴奏音轨（YouTube、CD等）演奏时同样适用：只需取消勾选节拍器，以免与曲子的声音冲突。

其他用途：在测量表上验证一个弯音，确认一个超吹，记下一段即兴乐句而它会自动写好。

📈 实时演奏轨迹

随调音器一起展开（点击标题可折叠，🗑 可清除）。上方是五线谱（高音谱号）：每个音符都精确放置在它被弹奏的那一刻，并与图表对齐；点击轨迹（五线谱或曲线）会把该点的读数发送到调音器（指针、音名、谱面、频率、音分）。下方是滚动图表（8秒）：你的音高以虚线呈现，颜色与表盘一致——±5音分为绿色，±15音分内为橙色，超出则为红色。彩色的水平线代表你的目标音（边栏显示对应谱面）。纵轴是固定的：线条间距保持不变，边框只是围绕演奏的音重新居中。

操作方式：点击＝聚焦，←/→ ±1秒（Shift：5秒），滚轮，点击并拖动；鼠标悬停时滚动会暂停（⏸标记），垂直光标可精确读取（谱面、音名、音分）；End/Esc 返回实时状态。⏸ 冻结按钮可稳定地停止滚动，方便检查曲线而无需一直按住鼠标；▶ 恢复 返回实时状态。约5分钟的历史记录。

🎚 半音调音器

±50音分表盘：绿色区域±5（准确），橙色至±15，超出则为红色。指针经过平滑处理，音名标签会随所处区域变色（绿/橙），对应谱面，频率。准确 ✓ 字样只在绿色区域内出现。停止时，显示会冻结（🗑 重置），模块会随轨迹一起折叠。限定于所选口琴的音域范围。

🎯 训练模式：适合练习某个特定的弯音。勾选该模式，并从列表中选择一个目标音——仅限弯音、超吹和超吸（需要练习的音）。指针会持续指向最接近的音（永远不会卡在极限处），而文字判定则相对于目标来衡量：「不够低 ↓」、「太高 ↓」，达到目标时显示「准确 ✓」。判定文字只在训练模式下出现，且「准确」还需指针处于绿色区域内。

A音校准（440Hz，▲▼，415–466）：许多口琴的调音基准是442–443Hz。这是一个全局且被记住的设置：调音器、识别和播放使用同一个基准音高。请先校准A音。

🎯 演奏谱子——已验证的练习

期望的音符会以蓝色闪烁；按你自己的节奏对着麦克风演奏它：准确→变绿，进入下一个；错误→变红，重来。最终总结：已验证的音符数、错误音符数、平均音分准确度。适用于任何谱子——结合生成器使用：每次都能得到一段全新且经过验证的练习。

测试版的限制

• 一次只能识别一个音（不支持和弦或分裂八度）。
• 需要清晰的音符；根据速度调整的最短持续时间；以±40音分为准（过于模糊的弯音不会被记谱）。
• 同一个音连续两次：请明显地断开它们。音符之间的休止符不会被记谱。
• 请将应用的调性设置为与你口琴一致的调性；建议在安静的环境中使用。

11 之二. 摇摆表 🎵（测试版）

摇摆表会在你演奏八分音符时，通过麦克风测量你的摇摆比例：50% = 直（binary），66.7% = 三连音风格（摇摆）。它依据的是你各次起音之间的时间间隔，因此不受音频延迟影响——使用前无需进行任何校准。

一个仪表和一个清晰的判定结果——直拍目标显示位置正确，三连音目标显示摇摆正确——实时显示你是否达到目标，停止演奏后信息仍会保留。选择目标（直50%或三连音66.7%），设置速度（与工具栏同步），也可以让模块在所选音阶中生成一段练习（2、4、6或8个八分音符）——或选择"自由"随意演奏。🗑 重置该模块。

12. 导出

四种格式，各自适用于不同用途。

导出格式	内容	用途
.json 💾	全部内容：音符、时值、速度、调性、调式	可靠保存、交换、存档
.mid 🎹	音符与时值，GM口琴音色	MuseScore、DAW、伴奏音轨
.xml	精确乐谱：完整小节、连音线、三连音、附点音符——若"我的和弦进行"中有网格，还会在五线谱上方标出和弦符号	MuseScore、Guitar Pro、Sibelius
🖨	谱子，每行12个音符，调性，速度，日期，标志	课堂讲义、PDF

🎯 实践案例 —— 你希望学生在家能重新练习课堂上看到的、完全相同且可编辑的版本：导出为 .json。你只希望他们用手机或音乐应用来听：导出为 .mid。你想给他们一份真正可读的乐谱：导出为 .xml 并在 MuseScore 中打开。

13. 常见问题

• 第一次点击没有声音（iPhone/iPad）：浏览器要在第一次操作时才会解锁音频——点击一个音符即可。
• 更改调性会改变我的音符吗？谱子本身永远不会改变；只有名称和音高会随之调整——就像换了一把口琴一样。
• 会话消失了：保存内容仅限于此浏览器（隐私浏览模式和数据清除会将其删除）——导出为 .json 以便长期保留。
• 可以离线使用吗？可以，完全离线：这是一个独立自足的文件。
• 导入的MIDI不完整：在所选调性中无法演奏的音符会被列出；应用会建议最合适的调性。
• 导入时超吹被拒绝：标准里氏口琴上只存在超吹1、4、5、6以及超吸7、9、10。
• "超出口琴范围"：检测到的音在所选调性中不存在——请检查设置。
• ⟳ 与局部循环的区别：⟳ 会重复正在播放的内容；如果选中了一个范围（Shift+点击），则只重复该段落。

14. 效果符号与文本导出

✨ 音符上的效果符号

在音符编辑器（双击音符）中，你可以添加效果符号，它们对节奏或时值没有任何影响：仅用于标注演奏意图。

先选择位置（音符之前或之后），然后点击你想要的符号。同一个音符可以同时携带多个效果，前后皆可；每个都保持独立。

符号	效果
/	从下方起音（轻微的起音弯音）
\	"哭腔"音：音符结尾处的轻微弯音
vib	颤音
Wa	用手做出的"哇音"效果
DS	双音（两个音同时发声）
TBS	舌堵法"拍击"
TBO	舌堵法"八度"
→	滑向下一个音符
↔	两音之间的颤音（trill）

滑音和颤音不会通过应用的声音重现。这些符号会显示在谱面上（橙色，围绕在音符周围）。

导出时：在文本（.txt）格式中，每个符号都是一个独立的元素（例如 DS TBS +4 vib Wa）；在 MusicXML 中，每个效果都会变成一个独立的 lyric，在 MuseScore 中显示在音符下方。

📝 文本导出（.txt）

TXT按钮（文件分组）会以纯文本形式下载谱子，包含效果符号，文件名与谱子名称相同。

Aplicação web para criar, ouvir e trabalhar tablaturas de gaita diatónica de 10 buracos. Um único ficheiro, sem instalação, sem ligação necessária: abra harmonica-trainer.html no seu navegador. A interface existe em sete idiomas (bandeiras no rodapé da app, escolha memorizada — este manual segue a mesma definição).

💡 Este manual está organizado módulo a módulo, pela ordem em que aparecem na app. Cada secção explica para que serve o módulo, como usá-lo, e propõe pelo menos um caso prático para começar de imediato.

1. Primeiros passos

No topo da página, uma faixa deslizante apresenta os conteúdos de apprendrelharmonica.com; pausa ao passar o cursor, um clique abre a página. O logótipo do site, no fundo da página, assina também as tablaturas impressas.

Quatro reflexos a conhecer desde o início

• Clicar numa nota toca-a e escreve-a ao mesmo tempo. Cada clique na gaita virtual toca a nota e adiciona-a à tablatura — sem necessidade de procurar um botão «adicionar».
• ▶ (ou Espaço) reproduz o que está escrito. Tablatura vazia? O botão «Experimentar: …» propõe um lick de blues de um compasso, diferente de cada vez que aparece.
• 💾 Nada a guardar manualmente. A app guarda automaticamente no navegador: feche, volte amanhã, a sua sessão é restaurada tal como estava.
• 📂 A maioria dos módulos dobra e desdobra com um clique no seu título; o esquema da gaita e «A minha tablatura» ficam sempre abertos.

🎯 Caso prático — Abre a app pela primeira vez: clique em alguns buracos da gaita virtual para ouvir o som, prima Espaço para ouvir o que acabou de compor, e feche o separador sem guardar nada. Volte a abrir a app: a sua pequena melodia continua lá.

1 bis. Disposição personalizada 🔀

Por defeito, os módulos empilham-se numa ordem padrão. Se usar sobretudo duas ou três ferramentas (por exemplo o gerador de melodias e a oficina de ritmo), pode aproximá-las para evitar percorrer a página sempre que precisa delas.

• Arraste cada cartão pela sua pega ⠿: encaixa nas colunas da página.
• A barra «Disposição» guarda várias disposições nomeadas e recupera-as a partir de um menu.
• ↺ volta à disposição original; 💾 exporta as suas disposições para um ficheiro reimportável.

Tudo é guardado no navegador, próprio deste dispositivo — se mudar de computador, exporte a sua disposição para a recuperar noutro lado.

2. A notação

A tablatura da app lê-se como uma tablatura de papel clássica, com alguns sinais adicionais para as inflexões (bends) e overnotes.

Escrita	Significado
+4 / -4	Soprar / puxar no buraco 4
-3', -3'', -3'''	Bend puxado de 1, 2, 3 semitons
+8'	Bend soprado (buracos 8–10)
+6° / -7°	Overblow / overdraw
z	Silêncio (para importação de texto)

O mesmo código de cores reaparece por toda a app — na tablatura, na gaita virtual, no traçado do jogo em direto: soprado · puxado · bend · overblow · overdraw. Uma vez interiorizado este código, lê-se a cor antes do número.

3. A gaita virtual

É o coração da app: uma gaita completa, na tonalidade mostrada acima do esquema. Cada coluna alinha, de cima para baixo: overblows, bends soprados, nota soprada, nota puxada, bends puxados, overdraws.

• Clicar num número de buraco adiciona a nota soprada do buraco correspondente.
• Passar o cursor sobre uma coluna ilumina-a, para detetar de relance todas as técnicas disponíveis nesse buraco.
• Os nomes de notas mostrados seguem a tonalidade e a oitava escolhidas — mude a tonalidade, os nomes mudam, mas a localização física dos sons mantém-se.

3 bis. Keyfinder 🔑

O Keyfinder responde a uma pergunta que todo o gaitista se faz mais cedo ou mais tarde: «que gaita levo para esta música?» — ou o contrário, «o que posso tocar com a gaita que tenho em mãos?». Mostra ainda as notas essenciais da posição escolhida (tónica, terças, quinta, sétimas) e onde as tocar na gaita.

Caso prático 1: parto da tonalidade da música

1. Separador «Encontrar a gaita»: escolha a tonalidade da música (ex.: Dó).
2. Escolha a posição em que quer tocar (ex.: 2ª posição).
3. O Keyfinder indica que gaita usar e mostra as notas-chave: tónica, terça maior, terça menor, quinta justa, sétima menor, sétima maior — com a sua localização na gaita.

Exemplo: para uma música em Dó tocada em segunda posição, o Keyfinder recomenda uma gaita em Fá e mostra de imediato onde estão a tónica, as terças, a quinta e as sétimas.

Caso prático 2: parto da gaita que tenho em mãos

1. Separador «Encontrar a tonalidade»: selecione a tonalidade da sua gaita (ex.: Mi) — várias gaitas podem ser selecionadas ao mesmo tempo.
2. A ferramenta mostra as 12 tonalidades tocáveis com as posições correspondentes.
3. Escolha a posição adequada ao estilo da música, e localize depois as notas essenciais no instrumento.

Exemplo: com uma gaita afinada em Mi, toca-se em Mi na 1ª posição, em Si na 2ª posição, em Fá# na 3ª posição, e assim por diante.

As notas destacadas — e porque importam

Nota	Papel
Tónica	Nota de referência principal da tonalidade
Terça maior	Dá a cor maior
Terça menor	Dá a cor menor / blues
Quinta justa	Nota de apoio estável
Sétima menor	Cor blues / dominante
Sétima maior	Cor jazz / maior

Em resumo: quer parta da tonalidade da música quer do instrumento, o Keyfinder guia-o em poucos cliques — ganha tempo e toca mais afinado, mais depressa.

4. A barra de ferramentas

A barra de ferramentas agrupa cinco famílias de comandos. Aparecem constantemente, por isso vale a pena conhecê-los de cor desde o início.

🎵 Reprodução

• ▶/⏹ (Espaço): reproduz ou para a tablatura. ⏸ Pausa (tecla P) pausa e memoriza a nota em curso — um segundo clique (ou P) retoma exatamente aí, enquanto ⏹ para completamente e esquece a posição.
• Início em qualquer ponto: clique numa nota da tablatura, ▶ começa aí (sem seleção, a reprodução recomeça do início). Retomar a meio da música salta o pickup e a contagem, e sincroniza a grelha de acordes com o compasso a ser tocado.
• ⟳ repete em loop sem interrupção — o campo ×N ao lado fixa um número de repetições (toca N vezes e para; vazio = infinito).
• 🎹 Acordes em bloco: junto ao campo de repetições, toca os acordes do construtor em bloco em vez de em arpejo.
• ⏱0 Contagem: o metrónomo só soa durante o pickup (compasso 0) e depois fica em silêncio.
• Andamento 40–240, 🔊 Volume, ⏱ Metrónomo (tempo forte segundo o compasso: a cada 4 ou 3 pulsações).
• TAP: clique ao ritmo (rato) para fixar o andamento — média dos últimos cliques, aplicada ao andamento geral; RESET apaga os cliques.

🎯 Caso prático — Não sabe o andamento exato de uma música que quer trabalhar: marque-o com TAP enquanto ouve o original no telemóvel, a app deduz o BPM e ajusta-o diretamente.

Durante a reprodução, a nota em curso acende-se na tablatura e na gaita — uma referência visual útil para seguir sem se perder.

🏋️ Exercícios

• 🎼 Gerador de melodias (detalhado no § 7).
• 🎶 Construtor de acordes e ♬ Progressões de acordes (detalhados no § 7 bis).
• 🧩 Estrutura da música (detalhado no § 7 ter).
• 🎙︎ Sensor de microfone (teste) (detalhado no § 8 quinquies) e 👂 Transcrição de ouvido (detalhado no § 8 ter).
• 🔀 Baralhar a tablatura (uma vez por clique, Ctrl+Z para desfazer).
• ⇅ ascendente depois descendente.
• SWING (colcheias ternárias: todo o ataque que caia no «e» do tempo é atrasado para dois terços do tempo).
• 🎲 Durações aleatórias.
• +BPM andamento progressivo (detalhado no § 6).

Estes modos combinam-se: pode, por exemplo, baralhar uma melodia e ativar o swing e o andamento progressivo, tudo ao mesmo tempo.

🎼 Tablatura (visualização)

• TAB / Notas / Dó Ré Mi: alterna entre a tablatura, os nomes anglo-saxónicos (C4, Bb3…) ou latinos (Dó4, Sib3…).
• Tonalidade (12 gaitas): nomes e altura adaptam-se, a tablatura mantém-se idêntica — é uma mudança de visualização, não de conteúdo.
• ▾8 / ▴8: transpõe uma oitava as notas selecionadas (ou toda a tablatura se nada estiver selecionado; buracos equivalentes). Se uma nota não tiver equivalente, não se move e a app lista-a. Seleção: Shift+clique um intervalo, Ctrl/Cmd+clique uma nota isolada, ⇄ Inverter troca selecionadas e não selecionadas.
• 1·3b·5 Graus: mostra por baixo de cada nota o seu grau na escala de referência — o botão vizinho 🎼 abre o gerador para escolher a escala, e a visualização alinha-se automaticamente com ela. As notas fora da escala aparecem a cinzento; os arpejos do construtor de acordes mostram em vez disso os intervalos do acorde (1, 3b, 5, 7b…).

📁 Ficheiro

• 📚 Biblioteca: tablaturas nomeadas, guardadas neste navegador — carregar, renomear, eliminar; ⬇ Exportar tudo como .json reimportável. As janelas deslocam-se com o rato.
• 💾 / 📂: ficheiro .json completo; 📂 também abre ficheiros .mid (convertidos em tablatura: durações quantizadas, silêncios reconstruídos, andamento aplicado, notas não tocáveis listadas, melhor tonalidade sugerida) e ficheiros .xml/.musicxml.
• 📋 Importar uma tablatura de texto (detalhado no § 5) · 🎹 MIDI (instrumento GM Harmonica) · XML MusicXML: partitura exata — figuras e durações coincidem sempre, compassos completos, ligaduras escritas; o MuseScore não reescreve nada. · TXT: exportação em texto simples com os efeitos (bends, overnotes…), prático para colar numa mensagem.
• 🖨 Imprimir: disposição limpa, fundo branco, logótipo, 12 notas por linha (PDF através de «Imprimir para PDF»).

🎯 Caso prático — Está a preparar material de aula para um aluno: construa a tablatura, clique em 🖨 Imprimir, depois «Imprimir para PDF» a partir da caixa de diálogo do navegador. O PDF mantém o seu logótipo e continua legível mesmo impresso a preto e branco.

✏️ Edição e ♩ Durações

↶/↷ (Ctrl+Z / Ctrl+Y), 🗑 apagar tudo, ? ajuda, ! repõe a visualização das janelas abertas (útil se uma janela ficar bloqueada ou mal posicionada fora do ecrã).

Nove valores rítmicos estão disponíveis: semibreve, mínima, semínima, colcheia, semicolcheia, tercina, ponto (+50 %), e três silêncios (1, ½, ¼ de tempo). A duração escolhida aplica-se às próximas notas que introduzir; sobre uma seleção existente, modifica-a diretamente.

Notas a cavalo entre compassos: divididas na visualização e ligadas por ‿ (parte ligada em pontilhado) — a nota mantém-se una, tocada num só sopro; a exportação MusicXML escreve a ligadura.

‿ Ligadura: liga as notas selecionadas — o sinal ‿ mostra-se entre elas. Duas notas ligadas da mesma altura encadeiam-se num só sopro, sem novo ataque, e a exportação MusicXML escreve a ligadura de frase. O botão ‿ do editor de notas (duplo clique numa nota) faz o mesmo, nota a nota.

5. Importar uma tablatura de texto 📋

Útil para recuperar uma tablatura encontrada num fórum, num livro, ou enviada por um aluno como mensagem de texto — sem ter de a reescrever tudo à mão.

Cole as suas tablaturas (notas separadas por espaços; vírgulas, quebras de linha, | aceites): +4 -4 +5 -5 +6 -6' -6 z +6 -5 +5 -4 +4. O + é opcional, z insere um silêncio, os elementos inválidos são ignorados e listados, a importação é adicionada a seguir ao que já existir.

6. Trabalhar uma passagem

Duas ferramentas para progredir num ponto concreto sem ter de repetir a peça inteira sempre que faz uma tentativa.

Loop parcial

Clique na primeira nota, Shift+clique na última: o intervalo fica destacado, ▶ toca só esse trecho, ⟳ repete-o em loop. Um clique sem Shift sai dele. O intervalo serve também para mudar todas as durações ou eliminar de uma vez.

🎯 Caso prático — Uma frase de dois compassos resiste-lhe num solo mais longo: selecione-a (Shift+clique), ative ⟳, e deixe-a repetir enquanto a trabalha, sem nunca voltar a tocar o resto da peça.

Andamento progressivo (+BPM)

Ajuste o passo (1–20 BPM por passagem) e o máximo: a cada volta do loop o andamento sobe e é mostrado. Funciona também numa gama selecionada: o andamento sobe a cada passagem da seleção, incluindo quando o acompanhamento 🎹 está ativo.

Exemplo clássico: 4 notas difíceis, início a 60 BPM, passo de 4, máximo 120 — começa devagar e a app acelera automaticamente após cada passagem bem-sucedida, sem que tenha de tocar no andamento.

7. Gerador de melodia 🎼

O gerador compõe melodias coerentes, não meras sucessões de notas ao acaso: as escalas estão agrupadas por posição — maior e pentatónica maior (1ª); blues, mixolídio, pentatónica (2ª); pentatónica menor, blues, dórico (3ª); menor natural, pentatónica menor (4ª); frígio, pentatónica menor, menor natural com bends (5ª); lídio, maior com bends (12ª). Quatro níveis (Principiante, buracos 4–8 → Especialista com overblows), sobre 1, 2 ou 4 compassos. A melodia termina sempre na tónica, exceto se marcar «Não terminar na tónica».

A janela permanece aberta enquanto trabalha: gere novamente em loop (🎼), ouça, ajuste, sem perder o controlo do resto da app. Feche-a com ✕ ou Cancelar; Ctrl+Z restaura a tablatura anterior se o resultado não lhe convier.

As minhas definições — mesmo por baixo de «Surpreende-me», guarde com um nome toda a configuração da janela e recupere-a com um clique: escala, nível, extensão, comprimento, fraseado, compasso, notas por compasso, durações marcadas, seguimento da progressão e os dois cursores de injeção. 💾 guarda (reutilizar um nome existente substitui a definição antiga em vez de criar uma duplicada), 🗑 apaga a definição selecionada, ⬇ exporta todas as suas definições em .json e 📂 volta a importá-las. Além disso, as definições da sua última geração ficam retidas sozinhas: no arranque seguinte da app, a janela abre tal como a deixou.

Num clique, para ir mais rápido

No topo do gerador, o botão Surpreende-me ajusta os menus por si (vê-os mexer) e gera de imediato: um clique, uma melodia. Clique de novo para um novo sorteio. As definições detalhadas ficam por baixo para quem quiser escolher a escala, a posição e o nível com precisão.

🎯 Caso prático — Tem 5 minutos antes de uma aula e quer um exemplo rápido para mostrar a um principiante: clique em «Surpreende-me» várias vezes seguidas até obter algo simples e cantável, sem tocar em nenhuma definição.

Ler e tocar o que acaba de ser gerado

O lembrete de notação «📖 Como ler a tablatura?» (soprado, puxado, bends, código de cores) está disponível na ajuda ? do menu Edição. Assim que há notas, aparece uma fila de ícones sob a tablatura: ▶ (vermelho) toca a tablatura, ⏹ (verde) para, o ícone do microfone (azul) lança o modo 🎯 (toca no microfone, a app valida nota a nota) e + adiciona ou insere uma nota — a seguir à nota selecionada, senão no final — abrindo o editor; clique novamente para adicionar mais, as barras de compasso recalculam-se.

Fraseado: dar forma à melodia

Para além de uma melodia «nota a nota», pode impor um tipo de fraseado: Pergunta – Resposta (duas partes que se respondem), Arco (subida depois descida), Vale (descida depois subida), Onda (ondulações sucessivas), Subida contínua ou Descida contínua (a frase atravessa o registo num só sentido), Jazz ligeiro (aproximações cromáticas a certas notas) ou Bebop completo (enclosures, colcheias). «Nenhum» deixa a app livre.

Subida e Descida impõem uma direção de conjunto — não é uma escala: a linha vai do grave ao agudo (ou ao contrário) permitindo-se pequenos recuos, o que a mantém musical. Os dois menus nota grave → nota aguda decidem que parte da harmónica é percorrida. Como a última nota assenta na tónica, pode recuar um pouco: marque «Não terminar na tónica» para manter a direção até ao fim.

Vale é o arco ao contrário: a frase parte do agudo, cava e volta a subir. Onda encadeia mudanças de direção — uma ondulação a cada dois compassos —, o fraseado que treina as inversões, ali onde muitos alunos se deixam levar num só sentido.

Blues AAB — a forma cantada, sobre a sua grelha

O fraseado Blues AAB escreve um chorus de blues tal como se canta: a frase A ocupa os compassos 1 a 4, A' repete-a nos compassos 5 a 8 sem se mexer enquanto a grelha passa ao IV — é desse desfasamento que nasce a tensão —, e depois B responde e conclui nos compassos 9 a 12. Cada grupo de quatro termina com uma respiração: a frase pousa num apoio no compasso 4 e no 8, e deixa lugar, como um cantor deixa o instrumento responder. B é mais densa do que o enunciado, e as últimas notas descem até à tónica.

Este fraseado exige uma grelha de 12 compassos e a opção «Seguir A minha progressão» marcada: é a própria forma que o impõe. Se faltar uma das duas, a app diz-lho em vez de gerar outra coisa. Em A' só uma nota é retocada: a 7ª maior que cai sobre um acorde de sétima (o mi sobre um F7, em dó) desce meio tom — as blue notes ficam como estão.

🎯 Caso prático — Carregue o preset Blues de 12 compassos a partir de «Progressões de acordes», envie-o para «A minha progressão», marque «Seguir A minha progressão» e escolha Blues AAB: obtém um chorus completo e estruturado, para um aluno ler ou tirar de ouvido.

Pergunta – Resposta funciona agora em 2 compassos tal como em 4: o segundo compasso retoma o ritmo e o início do primeiro, e a pergunta fica suspensa na dominante. Um lick curto e quadrado, sem passar por 4 compassos.

🎯 Caso prático — Trabalhar o âmbito com um aluno: Descida contínua, 4 compassos, nível Intermédio, âmbito reduzido aos furos 4 a 8 — obtém uma frase que desce todo o registo escolhido sem ser uma simples escala descendente.

Compasso, durações e âmbito

Escolha o compasso — 4/4, 3/4 (valsa), 6/8 ou 12/8: toda a app segue (barras de compasso, metrónomo, exportações MIDI e MusicXML). Comprimento: 1, 2 ou 4 compassos.

Restrinja as durações de nota usadas marcando apenas os valores desejados — semibreve, mínima, semínima, semínima pontuada, colcheia, semicolcheia, tercina ou tercina de semínimas.

Exemplo: apenas semibreve para uma nota por compasso, ou apenas mínima para duas notas por compasso — ideal para um fraseado muito simples ou um primeiro nível. Tudo marcado = livre.

Se o número de notas pedido não bastar para preencher o compasso — 4 colcheias em 4/4, por exemplo — a app completa com silêncios em vez de recusar: são distribuídos pelo compasso, não amontoados no final, para deixar a melodia respirar.

Dois menus nota grave → nota aguda limitam a melodia gerada à porção de gaita escolhida, entre as notas disponíveis para a escala e o nível selecionados — prático para permanecer numa zona precisa do instrumento. Repõem-se automaticamente ao mudar de escala ou de nível.

Número de notas por compasso. Fixe um máximo: em 6, a app usa até 6 notas, não necessariamente 6. Marque «exatamente este número» para impor a contagem exata.

Gerar sobre uma progressão de acordes

Se marcar «Seguir a minha progressão», a escala escolhida aplica-se sobre os acordes da sua progressão (módulo «A minha progressão»), seja qual for a sua tonalidade — bom para testar sonoridades inesperadas (cuidado com as dissonâncias). Cada acorde mantém a sua duração própria (compasso completo, meio compasso…): a melodia gerada ajusta-se a ela automaticamente, sem definição adicional. Os cursores de injeção acrescentam então uma percentagem de notas fora da escala e de silêncios (respirações de fim de frase).

O menu «Notas usadas sobre a progressão» decide entre escala e acordes. Livre mistura as duas, controlado pela injeção — o comportamento original, que pode deixar passar notas fora da escala (a terça maior de um acorde de blues, por exemplo). Escala estrita e Apenas notas comuns mantêm-se ambas estritamente dentro da escala escolhida, sem exceção — a diferença entre as duas está em como a nota é escolhida, não no que está disponível. Em Escala estrita, o acorde do momento não tem qualquer influência: a melodia segue a escala sem lhe dar atenção. Em Apenas notas comuns, sempre que uma nota da escala também é uma nota do acorde, a app tem a possibilidade de a privilegiar — sobretudo nos primeiros tempos —, sem que isso seja sistemático nem obrigatório: é uma escolha possível entre outras, não uma imposição. As duas opções desativam o cursor de injeção, que deixa de ter utilidade.

🎯 Caso prático — Escala de blues, 2ª posição, sobre uma grelha de blues: no modo Livre, notas da terça maior do acorde infiltram-se na melodia; mude para Escala estrita para manter a cor do blues do início ao fim, seja qual for o acorde.

Os meus modos 🧬: criar as suas próprias escalas

Módulo dobrável para criar os seus próprios modos — nome, posição (1ª a 12ª), graus marcados entre os 12 semitons — memorizados no navegador e disponíveis (★) nos seletores de escala do gerador, dos graus 1·3b·5 e do medidor de swing. ✎ edita um modo, 🗑 elimina-o.

Na janela do gerador, ao lado do seletor de escalas: 🗑 retira a escala mostrada da lista (escolha memorizada), ↺ volta a mostrar todas as escalas; ⬇ exporta os seus modos para um ficheiro .json e 📂 reimporta-os.

7 bis. Acordes e progressões 🎶

Três módulos complementares para trabalhar com acordes em vez de notas isoladas: construir um acorde isolado, encadear uma grelha já pronta, e tocar/exportar a grelha em curso.

🎶 Construtor de acordes

Grupo Exercícios: escolha a fundamental, a qualidade (das tríades às 13ª), eventuais alterações/tensões (b5, #5, b9, #9, #11, b13 — ativas segundo a qualidade), uma nota de baixo opcional (acorde «slash», ex.: C/E) e a forma do arpejo (ascendente, ou ascendente-descendente).

O seletor Compasso (4/4, 3/4, 6/8, 12/8) fixa a métrica antes de construir — é partilhado com o gerador de melodias e as progressões; se a tablatura já contiver notas, é pedida confirmação, pois as barras de compasso são reajustadas. Escolha diretamente a duração do acorde, em tempos — 1, 2 ou 4 em 4/4; 1 ou 3 em 3/4; 1½ ou 3 em 6/8; 3 ou 6 em 12/8 — o mesmo seletor que em «Progressões de acordes» e em «Estrutura da música».

Confirmar insere o acorde em arpejo no final da tablatura — posição mais grave tocável, overblows/overdraws incluídos — e a janela permanece aberta para encadear vários acordes seguidos; Eliminar o último retira o último adicionado. O nome do acorde aparece como distintivo no início da sua linha, e 🔀 e 🎲 atuam dentro de cada acorde sem quebrar os seus compassos. Na reprodução, 🎹 (grupo Reprodução) muda para acordes em bloco: cada acorde soa em bloco, com som de piano, em vez do arpejo.

♬ Progressões de acordes (predefinições)

Janela deslocável do grupo Exercícios: cerca de vinte progressões clássicas (pop, jazz, blues de 12 compassos, cadências menores…), transponíveis para as 12 tonalidades e em maior/menor — marque «Só armação» para mudar apenas a armação de clave mostrada sem transpor os acordes.

A progressão é editável antes de inserir: clique num acorde para mudar a sua fundamental, qualidade, tensões, nota de baixo, e a sua duração própria (1, 2 ou 4 tempos consoante o compasso) — cada acorde mantém a sua duração, pelo que pode misturar um compasso completo e dois meios compassos na mesma grelha. O seletor Compasso da janela fixa a métrica, da qual decorre a duração de um compasso completo: 4 tempos em 4/4, 3 em 3/4, 6 em 12/8. ◀ ▶ movem um acorde, ✕ retira-o, + adiciona um. Alternância de visualização Nomes / Graus (numerais romanos).

💾 guarda a sua progressão na lista de predefinições (★, 🗑 para eliminar), ⬇ exporta as suas progressões para .json e 📂 reimporta-as. → A minha progressão envia a grelha construída para o módulo abaixo, sem passar pela tablatura. As suas estruturas de música guardadas (módulo 🧩, § 7 ter) também aparecem nesta lista, com o prefixo 🧩: selecioná-las achata toda a estrutura na grelha, mantendo durações e tonalidades por parte.

♬ A minha progressão

Este módulo mostra a grelha recebida: cada ficha indica o nome do acorde, com a sua duração entre parênteses se diferir de um compasso completo (ex.: G7 (2)). As durações são reconhecidas e respeitadas automaticamente, seja qual for a sua origem — predefinições, construtor (via tablatura), ou envio da tablatura para este módulo — sem qualquer ajuste manual.

• ♬ Acompanhar a reprodução: a grelha toca ao piano durante a reprodução da tablatura, cada acorde na sua posição e duração reais.
• 🪟 Acorde atual: abre uma pequena janela deslocável, sempre em primeiro plano, que mostra em grande o acorde em curso juntamente com o seguinte — prático para seguir a grelha sem tirar os olhos da gaita.
• → Tablatura: converte a grelha em arpejos na tablatura, um grupo por acorde, cada um com a sua própria duração.
• 💾 🎹 XML TXT: exportam apenas a grelha — JSON, MIDI (acordes em bloco), MusicXML (acordes e símbolos escritos acima da pauta, nunca como notas), texto (nomes de acordes).
• 🗑: esvazia a progressão.

🎯 Caso prático — Está a ensinar uma grelha de blues a um aluno por videochamada: envie uma predefinição de blues de 12 compassos para «A minha progressão», abra 🪟 Acorde atual, e mantenha a janela visível enquanto o aluno toca por cima — vê sempre onde está, sem ter de ler toda a grelha.

No cabeçalho de «A minha tablatura», o botão → A minha progressão faz o caminho inverso: relê os arpejos de acordes presentes na tablatura (construídos via 🎶) e reconstrói a grelha em «A minha progressão», durações incluídas. Os ícones 💾 🎹 XML TXT mesmo ao lado são atalhos para as exportações da melodia completa — os mesmos da barra de ferramentas principal.

7 ter. Estrutura da música 🧩

Este módulo serve para construir a grelha de acordes completa de uma música, parte por parte, em vez de uma única grelha uniforme — útil assim que uma música tem uma estrofe e um refrão com acordes diferentes.

Janela deslocável (botão 🧩, grupo Exercícios): Intro, Estrofe, Refrão, Ponte, Solo, Break, Transição, Final, ou uma parte Personalizada — cada tipo tem a sua própria cor, retomada como contorno no cartão. Adicionar uma parte cria um cartão e seleciona-o de imediato; o seu nome é editável, a sua tonalidade e o seu modo ajustam-se no editor abaixo e transpõem todos os seus acordes de uma vez.

Construir a grelha de uma parte

A grelha de cada parte constrói-se com o mesmo construtor de acordes que 🎶 (§ 7 bis): + abre o construtor, Confirmar adiciona o acorde à parte e a janela permanece aberta para encadear mais. Depois, clicar numa ficha de acorde reabre o construtor pré-preenchido com esse acorde para o modificar (fundamental, qualidade, duração…) sem tocar no resto da grelha; o pequeno ✕ à direita da ficha retira-o; e os discretos + entre fichas inserem um acorde esquecido exatamente nesse ponto — inserções sucessivas encadeadas pela ordem em que as digitar.

Reorganizar e gerir as partes

• ◀ ▶ movem uma parte um lugar, ou pegue na sua pega ⠿ para arrastar e largar onde quiser (um contorno azul indica a inserção antes ou depois da linha sobre a qual o cursor passa).
• ⧉ duplica uma parte, 📋 copia-a e 📥 Colar adiciona-a ao fim da estrutura, 🗑 elimina-a (é pedida confirmação).
• ↺ Esvaziar todas as partes com um clique (é pedida confirmação): as suas estruturas guardadas não são afetadas.

💾 Guardar uma estrutura com um nome: junta-se à lista pendente (recarregar uma estrutura pede confirmação se outra já estiver em curso), 🗑 mesmo ao lado remove-a da lista. ⬇ exporta todas as suas estruturas guardadas para .json, 📂 reimporta-as. As suas estruturas guardadas também aparecem, com o prefixo 🧩, na lista de «Progressões de acordes» (§ 7 bis): selecioná-las aí achata toda a grelha, mantendo durações e tonalidades por parte.

Gerar uma melodia sobre uma parte específica

🎲 Gerar uma melodia sobre uma parte (se contiver acordes): o gerador de melodia 🎼 compõe sobre a sua grelha, na sua tonalidade, com as definições atuais do gerador (nível, escala, fraseado…), e insere o resultado exatamente no lugar dessa parte em «A minha tablatura» — o resto da tablatura não é tocado; gerar novamente uma parte substitui-a, não se adiciona.

🎯 Caso prático — Está a construir uma música com Intro / Estrofe / Refrão / Solo: gere uma melodia calma sobre a Intro, depois uma mais técnica só para o Solo, sem nunca tocar nas outras duas partes.

→ A minha progressão achata a estrutura inteira, pela ordem das partes, para o módulo do § 7 bis — mesmo caminho que as predefinições.

Exportações dedicadas: TXT produz uma grelha imprimível, partes nomeadas, compassos alinhados em colunas; XML produz um MusicXML onde cada parte começa numa nova linha (marca de parte e armação de clave), com os símbolos de acordes em notação internacional acima da pauta — a pauta fica vazia (silêncios ocultos) se «A minha tablatura» estiver vazia, ou retoma a sua melodia se tiver uma.

8. Edição fina

Uma vez colocada uma melodia — gerada, importada, ou introduzida nota a nota — eis como a afinar com precisão.

Visão geral da barra de comandos

De cima para baixo, para que serve cada comando do cabeçalho:

• ⠿ move o módulo na página.
• Ma tablature: título do módulo; 18 elementos · 4 compassos: contador de notas/pausas e compassos, atualizado em tempo real.
• ▼8 / ▲8: desce / sobe toda a seleção uma oitava (a tablatura inteira se nada estiver selecionado).
• Anacruse: declara o primeiro compasso como anacruse.
• ▶ ícone vermelho no canto superior direito: abre o vídeo tutorial do módulo.
• 💡 faixa de dica: lembra o duplo clique para editar uma nota.
• ▶ / ■ / 🎤 / +: reprodução, parar, modo microfone, adicionar uma nota.
• ⇄ Inverter: inverte a seleção (aspirado ⇄ soprado).
• ✕ Nota: apaga a última nota inserida (e outras ações sobre a nota selecionada).
• 🗑 Tudo: apaga toda a tablatura.
• ⇅ Seguir: ativa/desativa a rolagem automática durante a reprodução.
• ♫ Arpejos: alterna o modo arpejos.
• Mudo: silencia o som da reprodução.
• → A minha progressão: muda para o módulo de progressão de acordes ligado.
• 💾 / 🎹 / XML / TXT: guarda a tablatura, exporta em MIDI, em MusicXML, em texto.
• ⚠ Completar o compasso: assinala um compasso incompleto a corrigir.
• Número do compasso (coluna esquerda): identifica o compasso na grelha.
• Casa de nota: furo, duração e número do furo — duplo clique para a editar (altura, duração, pausa).

Seleção e eliminação

Clique = seleção (as novas notas inserem-se a seguir); ⌫/Del elimina; ←/→ move a seleção. Barras de compasso automáticas e numeradas (4/4 ou 3/4 consoante a indicação escolhida no gerador); o contador mostra elementos e compassos.

O editor de notas (duplo clique)

Duplo clique numa nota abre um editor completo: mudar o buraco (1–10), a técnica (só se oferecem as notas realmente tocáveis nesse buraco, com a sua cor), a duração e o ponto, converter a nota em silêncio (e vice-versa), ou eliminá-la.

Completar, duplicar, apagar um compasso

⚠ Completar o compasso: quando o último compasso está incompleto, este botão aparece por cima da tablatura. A app propõe três finais possíveis dentro da escala atual — escolha um, as notas são adicionadas e o compasso fica certo.

Duplicar ou apagar um compasso. Cada linha da tablatura corresponde a um compasso. Os dois pequenos botões no final da linha permitem duplicá-lo (uma cópia é inserida logo a seguir) ou apagá-lo com um clique.

Transpor por oitava

Oitavas ±8. Se as alturas o permitirem, ▾8 / ▴8 descem ou sobem a seleção (ou toda a tablatura) uma ou duas oitavas; uma nota sem equivalente não é transposta.

Seguir os acordes durante a reprodução

⇅ Seguir e 🎵 Arpejos. Quando há uma progressão presente em «A minha progressão», os seus arpejos de acordes podem ficar rodeados por um contorno verde durante a reprodução: ⇅ Seguir faz a tablatura deslocar-se até eles (desative para deslocar-se você mesmo), 🎵 Arpejos torna-os audíveis juntamente com o seu acorde (desative para manter só o piano).

De onde vêm as notas da tablatura?

Ali aparecem notas provenientes de: os seus cliques no esquema, o microfone (módulo Reconhecimento de notas ou Sensor de microfone), o gerador de melodia, a biblioteca, o botão «Tablatura» de «A minha progressão», o botão + do módulo, e o botão «Experimentar».

Armação de clave (para as exportações)

A armação de clave das exportações é automática: segue a tónica da melodia gerada segundo a sua posição, em maior ou menor — assim, uma pentatónica menor em 3ª posição numa gaita em Dó dá Ré menor (um bemol), e não a armação da gaita. Sem melodia gerada, é a tonalidade maior da gaita. Aparece no primeiro compasso do MusicXML (com o modo) e no MIDI — o MuseScore mostra uma partitura limpa.

Anacruse

Introduza a sua anacruse no início da tablatura, silêncios de acerto incluídos — por exemplo dois silêncios seguidos de duas colcheias — e clique em Anacruse no cabeçalho do módulo: o primeiro compasso torna-se o compasso 0, marcado com um contorno pontilhado. Clique de novo para anular. As suas notas editam-se como todas as outras (duração, duplo clique, arrastar e largar). Na reprodução, o compasso 0 toca apenas uma vez no início: o loop ⟳ só repete o corpo, e o acompanhamento de «A minha progressão» só entra no compasso 1. Com o metrónomo ativado, os tempos vazios antes da anacruse são contados — e sem anacruse, tem direito a uma contagem de um compasso completo no início. A exportação MusicXML escreve uma anacruse real (compasso 0 encurtado, silêncios iniciais retirados); o MIDI mantém o acerto exato. Uma nota a cavalo sobre a barra permanece no corpo.

8 bis. Ditado musical 🎧 (beta)

Use-o para trabalhar o ouvido puro: a app toca algo, tem de o reconhecer e voltar a tocá-lo sem o ver escrito.

Como funciona

Sob o afinador: escolha de 1 a 6 notas e o nível — Principiante (buracos 4–6), Intermédio (notas naturais), Avançado (bends, sem overnotes), Especialista (tudo incluído). 🎲 toca uma frase cantável (intervalos ≤ quinta, sem repetição), na tonalidade atual. ▶ Reouvir à vontade; 🎤 Responder ao microfone: cada nota certa preenche a sua casa, uma errada pisca a vermelho e conta como erro. Revelar mostra a solução. Nunca escreve na sua tablatura.

Pontuação, estatísticas e distintivos

Cada ditado bem-sucedido dá uma pontuação = notas × nível × 100, menos 20 por erro e 5 por reescuta além da primeira. Sob o módulo: ditados tocados, sem erros, recorde, acumulado e série em curso (reiniciáveis com ↺). Sete distintivos a desbloquear — Ouvido de bronze/prata/ouro (10/50/100 ditados), Sem falhas e Ouvido absoluto (5 e 10 sem falhas seguidas), Virtuoso (um ditado Especialista sem falhas), Mestre do sopro (mais de 1000 pontos). Tudo guardado no navegador, offline.

🎯 Caso prático — 5 minutos antes de dormir, sem gaita à mão para ler uma partitura: inicie um ditado de nível Principiante, toque ao microfone na sua gaita de mesa de cabeceira, e veja a sua série de acertos crescer noite após noite.

8 ter. Transcrição de ouvido 👂 (beta)

Semelhante ao Ditado musical, mas orientado para escala e posição em vez de notas isoladas — útil para habituar o ouvido a uma cor de escala específica.

Como funciona

Botão 👂 (grupo Exercícios): a app toca algumas notas de uma escala/posição à sua escolha (os seus modos ★ incluídos) sem as mostrar. Ajuste o nível e o número de notas (2–16), reouça à vontade, e depois reconstrua a frase na janela: 🎤 ao microfone — cada nota tocada torna-se uma pastilha — ou à mão (sintaxe +4 -4 -3' +6°; clique numa pastilha para a retirar, ⌫ para apagar tudo). Confirmar mostra a solução por baixo, verde/vermelho nota a nota: é certo o que soa certo (-2 ≡ +3). Nunca toca na sua tablatura.

Pontos e distintivos

Pontuação = notas certas × nível × 100, −20 por erro, −5 por reescuta além da primeira, contado na primeira confirmação do sorteio. Um nível a cada 1000 pontos; cinco distintivos (primeiro sem erros, 10 e 50 transcrições, 5 sem erros seguidas, sem erros no nível Especialista); reposição com ↺. Guardado no navegador, offline.

8-d. Oficina de ritmo 🥁 (beta)

Treina o ritmo independentemente da afinação — perfeito para alunos que tocam certo mas «ao lado» do tempo, ou o contrário.

Como funciona

Botão 🥁 (grupo Durações): a aplicação gera um ritmo de um compasso 4/4 segundo o nível — até ♪♬♬ e ♬♬♪, a síncope ♬♪♬, pausas, tercinas e grandes síncopes — e toca-o com metrónomo sobre a fundamental (tempo limitado a 60-100). Após uma contagem de um compasso, reproduza-o: 🎤 ao microfone (melodia ou uma só nota, separando bem os ataques) ou 👆 a tocar (barra de espaço ou botão). Correção figura a figura (verde/vermelho), ataques a mais assinalados; a latência é compensada automaticamente — só conta a colocação rítmica.

Pontos e distintivos

Certas × nível × 100, −20 por figura falhada, −10 por ataque a mais, −5 por reescuta além da primeira; um nível a cada 1000 pontos, doze recompensas, reposição com ↺. Dizem respeito ao número de ritmos tocados (1, 3, 10), aos sem erros (1, 3, 10), aos sem erros seguidos (2, 5), aos conseguidos à primeira audição (3) e aos conseguidos em cada nível — Intermédio, Avançado e Especialista, 3 cada, sem nunca se acumularem de um nível para o outro. O modo de resposta não conta: microfone e toque valem exatamente o mesmo. Guardado no navegador, offline.

🎯 Caso prático — Um aluno tende a tocar as colcheias adiantadas: ajuste o nível para Principiante, faça-o primeiro tocar (👆) em vez de ao microfone, para isolar o problema rítmico sem que a afinação interfira.

8 quinquies. Sensor de microfone (teste) 🎙︎

Botão 🎙︎? (barra de ferramentas): uma etapa de verificação antes de escrever qualquer coisa na tablatura. Nada muda até você validar.

🎤 Armar o sensor, inicie a reprodução (▶) e toque sobre o acompanhamento: cada ataque detectado aparece na lista com a posição tocada, a casa prevista, a nota, o furo correspondente na tablatura e o desvio em milissegundos. A Grelha (semínima, colcheia ou semicolcheia) define a precisão de quantização visada.

Calibrar a latência

Entre o momento em que o som sai da gaita e o momento em que o microfone o faz chegar à aplicação, há sempre um pequeno atraso: a latência. Não corrigida, ela distorce tudo o que envolve ritmo — a Oficina de ritmo ou o modo 🎯 «Tocar a tablatura» podem julgar «atrasada» uma nota tocada exatamente no tempo certo, e a escrita automática via ✍ Escrever na tablatura… coloca notas e durações ligeiramente deslocadas. O Swing-mêtro também pode ser um pouco afetado, já que se baseia nos intervalos de tempo entre as suas notas. Enquanto não usar um exercício cronometrado nem a escrita automática, a latência não tem qualquer importância.

⏱ Teste de latência (o mais simples, faça-o primeiro):

1. Clique em ⏱ Teste de latência.
2. Depois de uma pequena contagem, o metrónomo toca 8 cliques sozinho, sem melodia.
3. Toque uma única nota limpa e destacada a cada clique — o furo não importa, o que conta é um som limpo, certinho no tempo.
4. Terminados os 8 cliques, a aplicação compara cada um dos seus ataques com o clique correspondente e calcula o desvio mediano.

O resultado aparece (ex.: «8 ataques · latência mediana 42 ms») e o campo Latência (ms) preenche-se automaticamente — nada mais a fazer. Ajuste memorizado para toda a aplicação.

⌁ Calibrar (para afinar, em condições reais):

1. 🎤 Arme o sensor, inicie uma reprodução real (▶) e toque normalmente por cima.
2. Cada nota tocada é adicionada à lista, com o seu próprio desvio.
3. Clique em ⌁ Calibrar: a aplicação retoma o desvio mediano desta gravação e soma-o à latência já definida.

Repita a operação em diferentes condições (com ou sem auscultadores, outro microfone, outra sala) para afinar ainda mais.

Swing (posição do «e»): ajustável à mão, ou deduzido do que acabou de tocar com ◱ Medir o swing. Sem relação com a latência — a Grelha e o Swing apenas regulam a precisão de divisão e o feeling ternário visados.

Gravar uma melodia ou uma improvisação em tablatura

O sensor só mede os seus ataques em relação ao relógio da própria reprodução ▶ da aplicação: para que ele capture algo, uma reprodução tem de estar a decorrer enquanto você toca — mesmo que só contenha silêncios.

Caso 1: a solo, com o metrónomo

1. Escolha a tonalidade da sua gaita no esquema da gaita.
2. Abra o Sensor de microfone e arme-o (🎤 Armar o sensor).
3. Preencha «A minha tablatura» com compassos vazios (só silêncios), no andamento pretendido — tantos compassos quantos precisar.
4. Inicie a reprodução ▶ desses compassos silenciosos: é ela que faz o metrónomo funcionar e dá ao sensor a sua referência de tempo.
5. Toque a sua melodia por cima, seguindo o clique.
6. Clique em ✍ Escrever na tablatura… (detalhe abaixo).

Caso 2: ao mesmo tempo que um vídeo do YouTube

Mesmo procedimento do caso 1, com uma restrição a mais: no passo da reprodução, inicie o vídeo do YouTube e a reprodução dos compassos silenciosos ao mesmo tempo, à mão, o mais próximo possível um do outro. Depois toca seguindo o vídeo — o metrónomo da aplicação passa a servir apenas para manter o relógio interno do sensor a funcionar.

Esta sincronização manual funciona muito bem em andamentos lentos: um tempo dura mais, por isso um pequeno desvio de sincronização representa apenas uma fração ínfima do tempo e a nota continua a cair na casa certa. Em andamentos rápidos, o mesmo desvio pesa muito mais, e o risco de a nota cair na casa vizinha aumenta.

✍ Escrever na tablatura… abre «Validar a gravação»: uma comparação compasso a compasso, ✓ mantém a sua gravação ou ✕ mantém a tablatura original (atalhos Manter tudo / Rejeitar tudo). Nada é escrito antes de Aplicar — e um único Ctrl+Z desfaz tudo.

9. Atalhos de teclado

Teclas	Ação
1–0	Nota soprada, buracos 1 a 10
Shift+1–0	Nota puxada
Espaço	Reproduzir / Parar
P	Pausa / Retomar na nota atual
← / →	Seleção anterior / seguinte
Del	Eliminar a seleção (ou a última nota)
Shift+clique	Seleção de um intervalo
Ctrl+Z / Y	Desfazer / Refazer

Funciona em teclados AZERTY e QWERTY.

10. Gravação de áudio 🎙 (beta)

Para guardar um registo sonoro da sua interpretação, sem que se transforme em tablatura — apenas um ficheiro áudio para voltar a ouvir ou enviar.

Nomeie o ficheiro, escolha o microfone (o do sistema por defeito), ⏺ depois ⏹: aparece um leitor, ⬇ descarrega, 🗑 Apagar elimina a gravação. Formato webm/opus mono (≈ 1 MB/min), reproduzível em qualquer lado.

🎯 Caso prático — Inicie a reprodução em loop de um exercício, comece a gravar, toque por cima duas ou três vezes, pare, e depois ouça-se comparando com o original: uma excelente forma de detetar as suas próprias falhas sem um professor ao lado.

10 bis. Exercícios a partir de um vídeo 🎯 (beta)

O módulo inverso do anterior: em vez de partir de uma escala para gerar um exercício, parte de um backing track e a app propõe as posições a trabalhar sobre ele.

Escolha uma das suas músicas na lista pendente (primeiro os seus vídeos, depois a biblioteca) — tonalidade, modo, estilo e andamento preenchem-se sozinhos e o vídeo é mostrado. Assim que tocar em Tonalidade ou Modo, a lista reduz-se aos backing tracks dessa tonalidade nesse modo e a sua etiqueta mostra a contagem; ✕ Mostrar tudo volta à lista completa. Ou, para um vídeo qualquer, cole o seu link do YouTube e indique à mão a sua tonalidade, o seu modo, o seu estilo e o seu andamento; a app propõe então dois dos seus backing tracks correspondentes.

Para cada posição listada (gaita + escala), um botão carrega a gaita e gera de imediato um exercício nessa posição e tonalidade. Escolher um backing track predefine o gerador 🎼 para a primeira posição, em 1 compasso.

11. Reconhecimento de notas 🎤 (beta)

O módulo mais versátil das ferramentas de microfone da app: serve tanto para verificar a sua afinação em direto como para transcrever automaticamente uma melodia que toca, sem nada preparado à partida.

Escuta simples

🎤 Iniciar a escuta, toque uma nota sustida: a app mostra a nota, o furo na tablatura (cor segundo a sua técnica, consoante a tonalidade selecionada) e a sua afinação (±50 cents).

Escrever as notas na tablatura em direto

«Escrever as notas na tablatura»: transcrição automática com o valor rítmico real, medido de ataque a ataque — uma semínima destacada mantém-se uma semínima (o intervalo de articulação absorvido abaixo de ~40 % do intervalo; além disso, é anotado um silêncio real; além de 4 tempos, respiração, nada). Última nota largada cedo: arredondada para o valor completo superior. No final da escuta, o ritmo é recalibrado automaticamente: andamento real estimado, durações requantizadas, Andamento ajustado. Metrónomo opcional acompassado com a grelha. Um único Ctrl+Z desfaz toda a sessão.

🎯 Caso prático — Uma melodia fica-lhe na cabeça sem nada escrito: marque «Escrever as notas na tablatura», desmarque o Metrónomo se quiser tocar completamente livre, clique em «🎤 Iniciar a escuta» e toque. Ao parar, a sua melodia já está em «A minha tablatura», pronta a corrigir se necessário. Também funciona sobre um backing track externo (YouTube, CD...): basta desmarcar o metrónomo para não colidir com o som da música.

Outros usos: verificar um bend no medidor, confirmar um overblow, transcrever um riff que se escreve sozinho.

📈 Traçado do jogo em direto

Desdobra-se junto com o afinador (dobrável ao clicar no seu título, 🗑 para apagar). Em cima, a pauta (clave de sol): cada nota colocada no instante exato em que foi tocada, alinhada com o gráfico; um clique no traçado (pauta ou curva) envia a leitura desse ponto para o afinador (agulha, nota, tablatura, frequência, cents). Em baixo, o gráfico deslizante (8 s): a sua altura em pontilhado, colorida como o mostrador — verde a ±5 cents, laranja até ±15, vermelho além disso. As linhas horizontais coloridas são as suas notas alvo (tablatura na margem). A escala vertical é fixa: o espaçamento das linhas mantém-se constante, o enquadramento apenas se recentra na nota tocada.

Navegação: clique = foco, ←/→ ±1 s (Shift: 5 s), roda do rato, clicar e arrastar; o deslocamento congela ao passar o cursor (distintivo ⏸), cursor vertical com leitura precisa (tablatura, nota, cents); Fim/Esc voltam ao direto. O botão ⏸ Congelar para o deslocamento de forma estável para examinar a curva sem manter o rato sobre ela; ▶ Retomar volta ao direto. ~5 minutos de histórico.

🎚 Afinador cromático

Mostrador ±50 cents: zona verde ±5 (afinado), laranja até ±15, vermelho além disso. Agulha suavizada, etiqueta de nota que assume a cor da zona visada (verde/laranja), tablatura equivalente, frequência. A palavra AFINADO ✓ só aparece na zona verde. Ao parar, a visualização congela (🗑 para repor a zero) e o módulo dobra-se junto com o traçado. Limitado à extensão da gaita selecionada.

🎯 Modo de treino: útil para trabalhar um bend específico. Marque o modo e escolha uma nota alvo na lista — apenas bends, overblows e overdraws (as notas a trabalhar). A agulha continua a indicar a nota mais próxima (nunca fica bloqueada no limite), enquanto o veredito por extenso é medido em relação ao alvo: «NÃO SUFICIENTEMENTE BAIXO ↓», «DEMASIADO ALTO ↓», e «AFINADO ✓» quando o atinge. O veredito só existe no modo de treino, e «AFINADO» pressupõe também a agulha na zona verde.

Calibração do Lá (440 Hz, ▲▼, 415–466): muitas gaitas estão a 442–443 Hz. Ajuste global e memorizado: afinador, reconhecimento e reprodução ao mesmo diapasão. Calibre primeiro o Lá.

🎯 Tocar a tablatura — prática validada

A nota esperada pisca a azul; toque-a ao microfone no seu próprio ritmo: certa → verde, seguinte; errada → vermelha, toca-se de novo. Balanço final: notas validadas, notas erradas, afinação média em cents. Funciona com qualquer tablatura — combinado com o gerador: um exercício novo e corrigido em cada sessão.

Limitações da beta

• Uma nota de cada vez (sem acordes nem oitavas divididas).
• Notas limpas; sustentação mínima adaptada ao andamento; validação a ±40 cents (um bend demasiado impreciso não é transcrito).
• A mesma nota duas vezes: separe-as claramente. Os silêncios entre notas não são transcritos.
• Ajuste a tonalidade da app à da sua gaita; recomenda-se um ambiente calmo.

11 bis. Swing-mêtro 🎵 (beta)

O Swing-mêtro mede ao microfone o seu rácio de swing enquanto toca colcheias: 50 % = binário (direito), 66,7 % = ternário (swing). Baseia-se nos intervalos entre os seus ataques, o que o torna insensível à latência de áudio — não é preciso calibrar nada antes de o usar.

Um indicador e um veredito claro — COLOCAÇÃO OK para um alvo direito, SWING OK para um alvo de tercina — mostram em direto se está no alvo, e a mensagem permanece quando para. Escolha o alvo (Direito 50 % ou Tercina 66,7 %), ajuste o andamento (sincronizado com a barra de ferramentas), e deixe opcionalmente o módulo gerar um exercício de colcheias (2, 4, 6 ou 8) na escala escolhida — ou «livre» para tocar o que quiser. 🗑 repõe o módulo.

12. Exportações

Quatro formatos, cada um para um uso diferente.

Exportação	Conteúdo	Uso
.json 💾	Tudo: notas, durações, andamento, tonalidade, modos	Guarda fiável, troca, arquivo
.mid 🎹	Notas e durações, som de gaita GM	MuseScore, DAW, backing tracks
.xml	Partitura exata: compassos completos, ligaduras, tercinas, pontuadas — e símbolos de acordes acima da pauta se «A minha progressão» contiver uma grelha	MuseScore, Guitar Pro, Sibelius
🖨	Tablatura, 12 notas/linha, tonalidade, andamento, data, logótipo	Material de aula, PDF

🎯 Caso prático — Quer que um aluno volte a trabalhar em casa exatamente a mesma versão vista na aula, editável: exporte para .json. Só quer que a oiça no telemóvel ou numa app de música: exporte para .mid. Quer dar-lhe uma partitura verdadeira para ler: exporte para .xml e abra-a no MuseScore.

13. Perguntas frequentes

• Sem som no primeiro clique (iPhone/iPad): os navegadores desbloqueiam o áudio no primeiro gesto — clique numa nota.
• Mudar de tonalidade muda as minhas notas? A tablatura nunca muda; só os nomes e a altura seguem — como trocar de gaita.
• Sessão desaparecida: a gravação é própria deste navegador (a navegação privada e a limpeza de dados apagam-na) — exporte para .json para durar.
• Offline? Sim, inteiramente: ficheiro autónomo.
• MIDI importado incompleto: as notas não tocáveis na tonalidade escolhida são listadas; a app sugere a melhor tonalidade.
• Overblows rejeitados na importação: só existem os overblows 1, 4, 5, 6 e overdraws 7, 9, 10 numa gaita Richter padrão.
• «Fora da gaita»: a nota detetada não existe na tonalidade selecionada — verifique a definição.
• ⟳ vs. loop parcial: ⟳ repete o que está a ser tocado; com um intervalo selecionado (Shift+clique), apenas a passagem.

14. Sinais de efeitos e exportação de texto

✨ Sinais de efeitos numa nota

No editor de notas (duplo clique numa nota), pode adicionar sinais de efeitos que não têm qualquer incidência sobre o ritmo ou a duração: servem apenas para anotar uma intenção de interpretação.

Escolha primeiro a Posição (Antes ou Depois da nota), depois clique no ou nos Sinais pretendidos. Uma mesma nota pode ter vários efeitos, antes e/ou depois; cada um permanece independente.

Sinal	Efeito
/	Ataque por baixo (ligeiro bend de ataque)
\	Nota «choramingas»: ligeiro bend no fim da nota
vib	Vibrato
Wa	Efeito «wah-wah» com as mãos
DS	Double stop (duas notas juntas)
TBS	Tongue blocking «slap»
TBO	Tongue blocking «na oitava»
→	Glissando para a nota seguinte
↔	Trinado entre duas notas

O glissando e o trinado não são reproduzidos pelo som da app. Os sinais aparecem na tablatura (a laranja, à volta da nota).

Na exportação: em texto (.txt), cada sinal é um elemento separado (ex.: DS TBS +4 vib Wa); em MusicXML, cada efeito torna-se um lyric independente mostrado por baixo da nota no MuseScore.

📝 Exportação de texto (.txt)

O botão TXT (grupo Ficheiro) descarrega a tablatura em texto simples, com os sinais de efeitos, com o nome da tablatura.