Créez, jouez et travaillez vos tablatures d'harmonica

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 six langues (drapeaux du pied de page de l'appli, choix mémorisé — ce manuel suit le même réglage).

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.

• Cliquez les notes de l'harmonica virtuel : chaque clic joue la note et l'ajoute à la tablature.
• ▶ (ou Espace) pour écouter. Tablature vide ? Le bouton « Essayer : … » propose un lick de blues d'une mesure, différent à chaque affichage.
• 💾 Sauvegarde automatique dans le navigateur : fermez, revenez demain, votre session est restaurée.
• 📂 La plupart des modules se déplient ou se replient d'un clic sur leur titre ; le schéma d'harmonica et « Ma tablature » restent toujours ouverts.

1 bis. Mise en page personnalisée 🔀

Agencez les modules à votre façon : glissez chaque carte par sa poignée ⠿ — elles s'aimantent sur les colonnes. La barre « Mise en page » enregistre plusieurs dispositions nommées et les rappelle d'un menu ; ↺ revient à la disposition d'origine, et 💾 exporte vos mises en page en fichier réimportable. Tout est gardé dans le navigateur, propre à cet appareil.

2. La notation

Code couleur partout : soufflé · aspiré · altération · overblow · overdraw.

3. L'harmonica virtuel

La tonalité est 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 ; survoler une colonne l'éclaire. Les noms de notes suivent la tonalité et l'octave choisies.

4. La barre d'outils

🎵 Lecture

• ▶/⏹ (Espace), ⟳ boucle sans coupure — le champ ×N à côté fixe un nombre de boucles (joue N fois puis s'arrête ; vide = infini). 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.

Pendant la lecture, la note en cours s'illumine dans la tablature et sur l'harmonica.

🏋️ Exercices

• 🎼 Générateur de mélodies (§ 7) · 🔀 Mélange de la tablature (une fois par clic, Ctrl+Z pour revenir) · ⇅ montant puis descendant · SWING (croches ternaires) · 🎲 Durées aléatoires · +BPM tempo progressif (§ 6). Les modes se cumulent.

🎼 Tablature

• TAB / Notes / Do Ré Mi : tablature, noms anglo-saxons (C4, Bb3…) ou latins (Do4, Sib3…).
• Tonalité (12 harmonicas) : noms et hauteur s'adaptent, la tablature reste identique.
• ▾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 (groupe Tablature) : 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 (§ 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.
• 🖨 Imprimer : mise en page propre, fond blanc, logo, 12 notes par ligne (PDF via « Imprimer en PDF »).

✏️ Édition & ♩ Durées

↶/↷ (Ctrl+Z / Ctrl+Y), 🗑 tout effacer, ? aide. Neuf valeurs : ronde, blanche, noire, croche, double-croche, triolet, point (+50 %), et trois silences (1, ½, ¼ temps). La durée choisie s'applique aux prochaines notes ; sur une sélection, 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 (groupe Édition) : 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) fait de même note par note.

5. Importer une tablature texte 📋

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.

6. Travailler un passage

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.

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. Exemple : 4 notes difficiles + 60 BPM + pas de 4 + max 120 → ~15 passages sans toucher à rien.

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

Mélodies cohérentes : gammes 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–6 → Expert avec overblows), 1, 2 ou 4 mesures. La mélodie finit sur la tonique, sauf si vous cochez « Ne pas finir sur la tonique ». La fenêtre reste ouverte : régénérez en boucle (🎼), écoutez, ajustez, sans perdre la main sur l'appli ; fermez-la par ✕ ou Annuler. Ctrl+Z restaure. Idée de séance : Intermédiaire + Blues 2^e + 1 mesure + boucle + tempo progressif.

En un clic (débutants). En haut du générateur, des boutons-intentions nommés par envie — « Un blues facile », « Une mélodie joyeuse », « Une impro pop/rock », « Quelque chose de mélancolique », « Surprends-moi » — règlent les menus à votre place (vous les voyez bouger) et génèrent 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.

Lire et jouer ce qui est 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.

Mesure et durées. Choisissez la signature — 4/4 ou 3/4 (valse) : toute l'appli suit (barres de mesure, métronome, exports MIDI et MusicXML). Et restreignez les durées de notes employées en cochant uniquement noire, croche, double-croche ou triolet — par exemple une mélodie en triolets seuls, ou en noires et croches (tout coché = libre).

Mes modes 🧬 (module repliable) : créez 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 🎶

🎶 Constructeur d’accords (groupe Exercices) : choisissez la fondamentale, la qualité (23, des triades aux 13e), les altérations/tensions (b5, #5, b9, #9, #11, b13 — actives selon la qualité), une note de basse optionnelle et la forme (montée ou montée-descente). Valider insère l’accord en arpège — position la plus grave jouable, overblows/overdraws compris — et la fenêtre reste ouverte pour enchaîner ; Supprimer le dernier retire le dernier accord ajouté.

Accords par mesure : 1, 2 ou 4 en 4/4 ; 1 ou 3 en 3/4 ; 1 ou 2 en 6/8 et 12/8 — les durées se répartissent pour remplir exactement la part choisie. 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, le bouton 🎹 (groupe Lecture) bascule en accords plaqués : chaque accord sonne en bloc sur le temps, au son piano, au lieu de l’arpège.

♬ Progressions d’accords (fenêtre du groupe Exercices, déplaçable) : 19 progressions classiques (pop, jazz, blues 12 mesures, cadences mineures…), transposables dans les 12 tonalités, avec aperçu des accords. Insérer pose la progression un accord par mesure ; un seul Ctrl+Z l’annule entièrement. La progression est éditable avant insertion : cliquez un accord pour changer fondamentale, qualité, tensions (b5, b9, #11…) et note de basse ; ◀ ▶ le déplacent, ✕ le retire, + en ajoute un. Bascule d’affichage Noms / Degrés (chiffres romains), et 💾 enregistre votre progression dans la liste des presets (★, 🗑 pour la supprimer) ; ⬇ exporte vos progressions en .json et 📂 les réimporte.

8. Édition fine

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.

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 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.

Armure de tonalité. 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.

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

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.

9. Raccourcis clavier

Claviers AZERTY et QWERTY.

10. Enregistrement audio 🎙 (bêta)

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. Astuce : lecture en boucle + enregistrement, jouez par-dessus, comparez.

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

Le module inverse du précédent : 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. 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)

🎤 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 » : 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.

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. 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

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.

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.

A web app to create, play and practise tablature for the 10-hole diatonic harmonica. One file, no installation, no connection: open harmonica-trainer.html in your browser. The interface is available in six languages (flags in the app footer, choice remembered — this guide follows the same setting).

1. Getting started

At the top, a scrolling banner showcases content from apprendrelharmonica.com; it pauses on hover, a click opens the page. The site logo at the bottom also brands printed tabs.

• Click notes on the virtual harmonica: each click plays the note and adds it to your tab.
• ▶ (or Space) to listen. Empty tab? The “Try: …” button offers a one-bar blues lick, different every time.
• 💾 Auto-save in the browser: close the tab, come back tomorrow, your session is restored.
• 📂 Most modules fold and unfold with a click on their title; the harmonica layout and “My tab” stay open at all times.
• 🔀 Arrange the modules your way: drag them by the ⠿ handle (they snap to the columns); the “Layout” bar saves and recalls several arrangements (↺ restores the original layout). Everything is kept in the browser.

1 bis. Custom layout 🔀

Arrange the modules your way: drag each card by its ⠿ handle — they snap onto the columns. The "Layout" bar saves several named arrangements and recalls them from a menu; ↺ returns to the original layout, and 💾 exports your layouts to a re-importable file. Everything is kept in the browser, specific to this device.

2. Notation

Colour code everywhere: blow · draw · bend · overblow · overdraw.

3. The virtual harmonica

The key is shown above the diagram. Each column stacks, top to bottom: overblows, blow bends, blow note, draw note, draw bends, overdraws. Clicking a hole number adds the blow note; hovering a column highlights it. Note names follow the selected key and octave.

4. The toolbar

🎵 Playback

• ▶/⏹ (Space), ⟳ gapless loop — the ×N field next to it sets a number of loops (plays N times then stops; empty = infinite). Tempo 40–240, 🔊 Volume, ⏱ Metronome (accent depending on the time signature: every 4 or 3 beats).
• TAP: click in rhythm (mouse) to set the tempo — average of the last clicks, applied to the global tempo; RESET clears the clicks.

During playback, the current note lights up in the tab and on the harmonica.

🏋️ Practice

• 🎼 Generator (§ 7) · 🔀 Shuffle the tab (once per click, Ctrl+Z to undo) · ⇅ up then down · SWING (shuffled eighths) · 🎲 Random durations · +BPM progressive tempo (§ 6). Modes combine.

🎼 Tab

• TAB / Notes / Do Ré Mi: tablature, letter names (C4, Bb3…) or solfège (Do4, Sib3…).
• Key (12 harmonicas): names and pitch adapt, the tab itself never changes.
• ▾8 / ▴8: transposes the selected notes one octave (or the whole tab if nothing is selected; equivalent holes). If a note has no equivalent, nothing changes and they are listed. Selection: Shift+click a range, Ctrl/Cmd+click individual notes, ⇄ Invert swaps selected and unselected.
• 1·3b·5 Degrees (Tab group): shows under each note its degree in the reference scale — the neighbouring 🎼 button opens the generator to pick the scale, and the display aligns with it automatically. Out-of-scale notes are greyed; arpeggios from the chord builder show the chord’s intervals (1, 3b, 5, 7b…).

📁 File

• 📚 Library: named tabs stored in this browser — load, rename, delete; ⬇ Export all to a re-importable .json. Dialogs can be dragged by their title.
• 💾 / 📂: full .json file; 📂 also opens .mid (converted to tab: quantised durations, rests rebuilt, tempo applied, unplayable notes listed, best key suggested) and .xml/.musicxml.
• 📋 Import text tab (§ 5) · 🎹 MIDI (GM Harmonica) · XML MusicXML: exact notation — note shapes and durations always agree, full measures, written ties; MuseScore never rewrites your rhythm.
• 🖨 Print: clean layout, white background, logo, 12 notes per line (PDF via “Print to PDF”).

✏️ Editing & ♩ Durations

↶/↷ (Ctrl+Z / Ctrl+Y), 🗑 clear all, ? help. Nine values: whole, half, quarter, eighth, sixteenth, triplet, dot (+50 %), and three rests (1, ½, ¼ beat). The chosen duration applies to the next notes; with a selection, it changes it directly.

Notes crossing a barline are split on screen and joined with ‿ (tied part dashed) — the note stays a single note, played in one breath; MusicXML export writes the tie.

‿ Slur (Editing group): ties the selected notes — the ‿ sign appears between them. Two slurred notes of the same pitch are played in a single breath, without re-attack, and the MusicXML export writes the slur. The ‿ button in the note editor (double-click) does the same note by note.

5. Importing a text tab 📋

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

6. Working on a passage

Partial loop

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

Progressive tempo (+BPM)

Set the step (1–20 BPM per pass) and the ceiling: each loop raises the tempo, shown live. Example: 4 hard notes + 60 BPM + step 4 + max 120 → ~15 passes hands-free.

7. Melody generator 🎼

Musically coherent melodies: scales 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–6 → Expert with overblows), 1, 2 or 4 bars. The melody ends on the tonic unless you tick "Don't end on the tonic". The window stays open: regenerate in a loop (🎼), listen, adjust, without losing control of the app; close it with ✕ or Cancel. Ctrl+Z restores. Session idea: Intermediate + 2nd-position blues + 1 bar + loop + progressive tempo.

One click (beginners). At the top of the generator, intent buttons named by mood — "An easy blues", "A cheerful tune", "A pop/rock riff", "Something melancholic", "Surprise me" — set the menus for you (you see them move) and generate right away: one click, one melody. Click again for a new draw. The detailed settings stay below for anyone who wants to pick scale, position and level precisely.

Read and play what's generated. The "📖 How to read the tab?" notation reminder (blow, draw, bends, colour code) is available in the ? help of the Edit menu. As soon as there are notes, a row of icons appears below the tab: ▶ (red) plays the tab, ⏹ (green) stops, the mic icon (blue) launches 🎯 mode (you play into 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, the bar lines recompute.

Time signature and durations. Pick the signature — 4/4 or 3/4 (waltz): the whole app follows (barlines, metronome, MIDI and MusicXML exports). And restrict the note durations used by ticking only quarter, eighth, sixteenth or triplet — for example a melody in triplets only, or in quarters and eighths (all ticked = free).

My modes 🧬 (collapsible module): create your own modes — name, position (1st to 12th), degrees ticked among the 12 semitones — stored 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 as a .json file and 📂 imports them back.

7 bis. Chords & progressions 🎶

🎶 Chord builder (Exercises group): pick the root, the quality (23, from triads to 13ths), alterations/tensions (b5, #5, b9, #9, #11, b13 — enabled per quality), an optional bass note and the shape (ascending or up & down). Add inserts the chord as an arpeggio — lowest playable position, overblows/overdraws included — and the window stays open to chain chords; Remove last deletes the last added chord.

Chords per bar: 1, 2 or 4 in 4/4; 1 or 3 in 3/4; 1 or 2 in 6/8 and 12/8 — durations are spread to fill the chosen share exactly. The chord name appears as a badge at the start of its line, and both 🔀 and 🎲 work inside each chord without breaking its bars. During playback, the 🎹 button (Playback group) switches to block chords: each chord sounds as one piano hit on the beat instead of an arpeggio.

♬ Chord progressions (movable window in the Exercises group): 19 classic progressions (pop, jazz, 12-bar blues, minor cadences…), transposable to all 12 keys, with a chord preview. Insert lays the progression one chord per bar; a single Ctrl+Z undoes it all. The progression is editable before insertion: click a chord to change root, quality, tensions (b5, b9, #11…) and bass note; ◀ ▶ move it, ✕ removes it, + adds one. Toggle the display between Names / Degrees (Roman numerals), and 💾 saves your progression to the presets list (★, 🗑 to delete it); ⬇ exports your progressions as .json and 📂 imports them back.

8. Fine editing

Click = select (new notes are inserted after it); ⌫/Del deletes; ←/→ moves the selection. Automatic numbered barlines (4/4 or 3/4 depending on the signature chosen in the generator); the counter shows items and measures.

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

⚠ Fill the bar: when the last bar is incomplete, this button appears above the tablature. The app offers three possible endings in the current scale — pick one, the notes are added and the bar comes out exact.

Key signature. The key signature of 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 key signature. Without a generated melody, it is the harmonica's major key. It appears in the first measure of the MusicXML (with the mode) and in the MIDI — MuseScore shows a clean score.

8 b. Ear training 🎧 (beta)

Below the tuner: pick 1 to 6 notes and a level — Beginner (holes 4–6), Intermediate (natural notes), Advanced (bends, no overnotes), Expert (everything). 🎲 plays a singable phrase (intervals ≤ a fifth, no repeats) in the current key. ▶ Play again freely; 🎤 Answer with the mic: each correct note fills its box, a wrong one flashes red and counts an error. Reveal shows the answer. Never writes into your tab.

Score, statistics and badges. Each passed dictation gives a score = notes × level × 100, minus 20 per error and 5 per replay beyond the first. Below the module: dictations played, flawless, best, total and current streak (reset with ↺). Seven badges to unlock — Bronze/Silver/Golden ear (10/50/100 dictations), Smooth run and Perfect pitch (5 and 10 flawless in a row), Virtuoso (one flawless Expert dictation), Breath master (over 1000 points). Everything is kept in the browser, offline.

9. Keyboard shortcuts

10. Audio recording 🎙 (beta)

Name the file, pick the mic (system default), ⏺ then ⏹: a player appears, ⬇ downloads, 🗑 Clear erases the recording. Mono webm/opus (≈ 1 MB/min), plays everywhere. Tip: loop the tab + record, play along, compare.

10 bis. Practice from a video 🎯 (beta)

The reverse of the previous module: start from a backing track and the app suggests the positions to practice over it. Pick one of your tracks from the drop-down list (your videos first, then the library) — key, mode, style and tempo fill in by themselves and the video appears. Or, for any video, paste its YouTube link and enter its key, mode, style and tempo by hand; the app then suggests two matching backing tracks of yours. For each listed position (harp + scale), a button loads the harmonica and immediately generates an exercise in that position and key. Picking a backing track pre-sets the 🎼 generator to the first position, in 1 bar.

11. Note recognition 🎤 (beta)

🎤 Start listening, play a held note: the app shows the note, its tab hole (coloured by technique, for the selected key) and your intonation (±50 cents).

“Write notes into the tab”: automatic transcription with real rhythmic values, measured onset to onset — a detached quarter stays a quarter (articulation gaps under ~40 % of the interval are absorbed; beyond that, a true musical rest is written; beyond 4 beats, it is a breath, nothing is written). A final note released early is rounded up to the next plain value. When you stop, the rhythm is auto-refitted: real tempo estimated, durations re-quantised, Tempo set. Optional metronome on the grid. A single Ctrl+Z undoes the session.

Uses: check a bend on the gauge, confirm an overblow, transcribe a riff that writes itself.

📈 Live pitch trace

Unfolds with the tuner (foldable via its title, 🗑 to clear). Top, the staff (treble clef): each note placed at the exact moment it was played, aligned with the graph; clicking the staff sends that note's reading to the tuner. Bottom, the scrolling graph (8 s): your pitch as dotted lines (green ±5 cents, orange ±15, red beyond), semitone lines labelled with playable tabs, coloured by technique. The vertical scale is fixed: line spacing stays constant, the frame simply recenters on the played note.

Navigation: click = focus, ←/→ ±1 s (Shift: 5 s), mouse wheel, click-and-drag; scrolling freezes on hover (⏸ badge), vertical cursor with a precise readout (tab, note, cents); End/Esc return to live. The ⏸ Freeze button stops scrolling steadily so you can examine the curve without keeping the mouse on 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, a note pill that takes the colour of the targeted zone (green/orange), tab equivalent, frequency. The word IN TUNE ✓ appears only in the green zone. When stopped, the display freezes (🗑 to reset) and the module folds along with the trace. Bounded to the selected harmonica's range.

🎯 Practice mode: handy for working on a specific bend. Tick the mode and choose a target note from the list — only bends, overblows and overdraws (the notes worth practising). The needle still shows the nearest note (it never pins), while the spelled-out verdict measures against the target: “NOT LOW ENOUGH ↓”, “TOO HIGH ↓”, and “IN TUNE ✓” when you reach it. The verdict exists only in practice 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 share the same pitch reference. Calibrate A first.

🎯 Play the tab — validated practice

The expected note blinks blue; play it into the mic at your own pace: right → green, next; wrong → red, retry. Final report: validated notes, mistakes, average intonation in cents. Works with any tab — combined with the generator, a fresh graded exercise every session.

Beta limits

• One note at a time (no chords or split octaves).
• Clean attacks; minimum hold adapts to tempo; validation within ±40 cents (a sloppy bend is not transcribed).
• Same note twice: clearly detach them. Rests between notes are not transcribed.
• Set the app key to your harmonica's key; a quiet room helps.

11 bis. Swing meter 🎵 (beta)

The Swing meter measures your swing ratio from the mic while you play eighth notes: 50% = straight (binary), 66.7% = triplet (swing). It relies on the intervals between your attacks, which makes it immune to audio latency. A gauge and a plain verdict — PLACEMENT OK for a straight target, SWING OK for a triplet target — show live whether you are on target, and the message stays on screen 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

13. FAQ

• No sound on first click (iPhone/iPad): browsers unlock audio on the first gesture — click a note.
• Changing key changed my notes? The tab never changes; only names and pitch follow — like swapping harmonicas.
• Session gone: auto-save lives in this browser (private browsing and data cleaning erase it) — export .json to keep it.
• Offline? Yes, fully: a self-contained file.
• MIDI import missing notes: 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.
• “Off harmonica”: the detected note doesn't exist in the selected key — check the setting.
• ⟳ vs partial loop: ⟳ repeats whatever plays; with a range (Shift+click), only that passage.

14. Effect signs and text export

✨ Effect signs on a note

In the note editor (double-click a note), you can add effect signs that have no impact 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 stays independent.

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

On export: in text (.txt), each sign is a separate token (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 the effect signs, named after the tab.

Web-App zum Erstellen, Anhören und Üben von Tabulaturen für die 10-Kanal-diatonische Mundharmonika. Eine Datei, keine Installation, keine Verbindung: Öffnen Sie harmonica-trainer.html im Browser. Die Oberfläche gibt es in sechs Sprachen (Flaggen in der Fußzeile der App, Auswahl wird gespeichert — dieses Handbuch folgt derselben Einstellung).

1. Erste Schritte

Oben zeigt ein Laufband Inhalte von apprendrelharmonica.com; es pausiert beim Überfahren, ein Klick öffnet die Seite. Das Logo unten ziert auch gedruckte Tabulaturen.

• Klicken Sie Töne auf der virtuellen Mundharmonika: Jeder Klick spielt den Ton und fügt ihn der Tabulatur hinzu.
• ▶ (oder Leertaste) zum Anhören. Leere Tabulatur? Der Knopf „Ausprobieren: …“ bietet einen eintaktigen Blues-Lick, jedes Mal anders.
• 💾 Automatisches Speichern im Browser: Schließen, morgen wiederkommen — die Sitzung ist wiederhergestellt.
• 📂 Die meisten Module klappen per Klick auf ihren Titel auf und zu; das Mundharmonika-Schema und „Meine Tabulatur“ bleiben stets offen.
• 🔀 Ordnen Sie die Module nach Belieben an: ziehen Sie sie am Griff ⠿ (sie rasten an den Spalten ein); die Leiste „Layout“ speichert und ruft mehrere Anordnungen ab (↺ stellt das ursprüngliche Layout wieder her). Alles bleibt im Browser gespeichert.

1 bis. Individuelles Layout 🔀

Ordnen Sie die Module nach Ihrem Geschmack an: Ziehen Sie jede Karte am ⠿-Griff — sie rasten an den Spalten ein. Die Leiste „Layout“ speichert mehrere benannte Anordnungen und ruft sie über ein Menü ab; ↺ stellt das ursprüngliche Layout wieder her, und 💾 exportiert Ihre Layouts in eine wieder importierbare Datei. Alles wird im Browser gespeichert, spezifisch für dieses Gerät.

2. Die Notation

Farbcode überall: Blasen · Ziehen · Bend · Overblow · Overdraw.

3. Die virtuelle Mundharmonika

Die Tonart steht über dem Schema. Jede Spalte zeigt von oben nach unten: Overblows, Blas-Bends, Blaston, Ziehton, Zieh-Bends, Overdraws. Ein Klick auf eine Kanalnummer fügt den Blaston hinzu; das Überfahren einer Spalte hebt sie hervor. Tonnamen folgen Tonart und Oktave.

4. Die Werkzeugleiste

🎵 Wiedergabe

• ▶/⏹ (Leertaste), ⟳ nahtlose Schleife — das Feld ×N daneben legt eine Anzahl der Schleifen fest (spielt N-mal, dann Stopp; leer = unendlich). Tempo 40–240, 🔊 Lautstärke, ⏱ Metronom (Akzent je nach Taktart: alle 4 oder 3 Schläge).
• TAP: im Takt klicken (Maus), um das Tempo festzulegen — Mittel der letzten Klicks, auf das globale Tempo angewendet; RESET löscht die Klicks.
• BORDUN: gehaltener Ton (12 Auswahl, tiefe Oktave) für Intonation und Positionen. Bei der Tonerkennung ausschalten.

Während der Wiedergabe leuchtet der aktuelle Ton in Tabulatur und Mundharmonika.

🏋️ Übungen

• 🎼 Generator (§ 7) · 🔀 Mischen der Tabulatur (einmal pro Klick, Strg+Z zum Zurück) · ⇅ auf- dann absteigend · SWING (ternäre Achtel) · 🎲 Zufallsdauern · +BPM progressives Tempo (§ 6). Modi kombinierbar.

🎼 Tabulatur

• TAB / Notes / Do Ré Mi: Tabulatur, Buchstabennamen (C4, Bb3…) oder Solmisation (Do4, Sib3…).
• Tonart (12 Mundharmonikas): Namen und Tonhöhe passen sich an, die Tabulatur bleibt gleich.
• ▾8 / ▴8: transponiert die ausgewählten Noten um eine Oktave (oder die ganze Tabulatur, wenn nichts ausgewählt ist; äquivalente Kanäle). Fehlt ein Äquivalent, ändert sich nichts und sie werden aufgelistet. Auswahl: Umschalt+Klick für einen Bereich, Strg/Cmd+Klick für einzelne Noten, ⇄ Umkehren vertauscht ausgewählt und nicht ausgewählt.
• 1·3b·5 Stufen (Gruppe Tabulatur): zeigt unter jedem Ton seine Stufe in der Bezugstonleiter — die benachbarte Taste 🎼 öffnet den Generator zur Tonleiter-Wahl, und die Anzeige richtet sich automatisch danach. Leiterfremde Töne sind ausgegraut; Arpeggien aus dem Akkord-Baukasten zeigen die Intervalle des Akkords (1, 3b, 5, 7b…).

📁 Datei

• 📚 Bibliothek: benannte Tabulaturen in diesem Browser — laden, umbenennen, löschen; ⬇ Alles exportieren als re-importierbares .json. Fenster lassen sich am Titel verschieben.
• 💾 / 📂: vollständige .json-Datei; 📂 öffnet auch .mid (Umwandlung in Tabulatur: quantisierte Dauern, rekonstruierte Pausen, übernommenes Tempo, unspielbare Töne gelistet, beste Tonart vorgeschlagen) und .xml/.musicxml.
• 📋 Textimport (§ 5) · 🎹 MIDI (GM Harmonica) · XML MusicXML: exakte Partitur — Notenwerte und Dauern stimmen stets überein, volle Takte, geschriebene Haltebögen; MuseScore schreibt nichts um.
• 🖨 Drucken: saubere Seite, weißer Hintergrund, Logo, 12 Töne pro Zeile (PDF über „Als PDF drucken“).

✏️ Bearbeiten & ♩ Dauern

↶/↷ (Strg+Z / Strg+Y), 🗑 alles löschen, ? Hilfe. Neun Werte: ganze, halbe, Viertel-, Achtel-, Sechzehntelnote, Triole, Punkt (+50 %), und drei Pausen (1, ½, ¼ Schlag). Die gewählte Dauer gilt für die nächsten Töne; bei einer Auswahl ändert sie diese direkt.

Töne über den Taktstrich werden am Bildschirm geteilt und mit ‿ verbunden (gebundener Teil gestrichelt) — der Ton bleibt ein einziger Ton, in einem Atem gespielt; der MusicXML-Export schreibt den Haltebogen.

‿ Bindebogen (Gruppe Bearbeiten): verbindet die ausgewählten Töne — das Zeichen ‿ erscheint dazwischen. Zwei gebundene Töne gleicher Höhe werden in einem Atemzug gespielt, ohne neuen Ansatz; der MusicXML-Export schreibt den Bogen. Die Taste ‿ im Noten-Editor (Doppelklick) tut dasselbe Ton für Ton.

5. Text-Tabulatur importieren 📋

Fügen Sie Ihre Tabulaturen ein (Töne durch Leerzeichen getrennt; Kommas, Zeilenumbrüche, | erlaubt): +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 übersprungen und gelistet, der Import wird angehängt.

6. Eine Passage üben

Teilschleife

Ersten Ton klicken, Umschalt+Klick auf den letzten: Der Bereich wird markiert, ▶ spielt nur ihn, ⟳ wiederholt ihn. Klick ohne Umschalt beendet. Der Bereich erlaubt auch Dauern-Änderung oder Löschen in einem Zug.

Progressives Tempo (+BPM)

Schritt (1–20 BPM pro Durchlauf) und Maximum einstellen: Bei jeder Runde steigt das Tempo, live angezeigt. Beispiel: 4 schwere Töne + 60 BPM + Schritt 4 + max. 120 → ~15 Durchläufe ohne Eingriff.

7. Melodie-Generator 🎼

Stimmige Melodien: nach Position gruppierte Skalen — 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 Kanäle 4–6 → Experte mit Overblows), 1, 2 oder 4 Takte. Die Melodie endet auf der Tonika, außer Sie aktivieren „Nicht auf der Tonika enden“. Das Fenster bleibt offen: in Schleife neu generieren (🎼), hören, anpassen, ohne die Kontrolle über die App zu verlieren; mit ✕ oder Abbrechen schließen. Strg+Z stellt wieder her. Übungsidee: Mittelstufe + Blues 2. Position + 1 Takt + Schleife + progressives Tempo.

Ein Klick (für Anfänger). Oben im Generator stellen Absichts-Schaltflächen mit Namen nach Stimmung — „Ein einfacher Blues“, „Eine fröhliche Melodie“, „Ein Pop-/Rock-Riff“, „Etwas Melancholisches“, „Überrasch mich“ — die Menüs für Sie ein (Sie sehen sie sich bewegen) und erzeugen sofort: ein Klick, eine Melodie. Erneut klicken für einen neuen Wurf. Die detaillierten Einstellungen bleiben darunter für alle, die Skala, Position und Niveau genau wählen möchten.

Lesen und spielen, was erzeugt wird. Die Notations-Erinnerung „📖 Wie liest man die Tabulatur?“ (blasen, ziehen, Bendings, Farbcode) ist in der Hilfe ? des Menüs Bearbeiten verfügbar. Sobald Noten vorhanden sind, erscheint unter der Tabulatur eine Symbolleiste: ▶ (rot) spielt die Tabulatur, ⏹ (grün) stoppt, das Mikrofon-Symbol (blau) startet den 🎯-Modus (Sie spielen ins Mikro, die App prüft Ton für Ton) und + fügt eine Note hinzu oder ein — nach der ausgewählten Note, sonst am Ende — und öffnet den Editor; erneut klicken für weitere, die Taktstriche werden neu berechnet.

Taktart und Notenwerte. Wählen Sie die Taktart — 4/4 oder 3/4 (Walzer): Die ganze App folgt (Taktstriche, Metronom, MIDI- und MusicXML-Export). Und beschränken Sie die verwendeten Notenwerte, indem Sie nur Viertel, Achtel, Sechzehntel oder Triole ankreuzen — etwa eine Melodie nur aus Triolen oder aus Vierteln und Achteln (alle angehakt = frei).

Meine Modi 🧬 (einklappbares Modul): Erstellen Sie eigene Modi — Name, Position (1. bis 12.), Stufen aus den 12 Halbtönen — im Browser gespeichert und (★) in den Tonleiter-Auswahlen 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 wird gemerkt), ↺ zeigt alle wieder an; ⬇ exportiert Ihre Modi als .json-Datei und 📂 importiert sie zurück.

7 bis. Akkorde & Progressionen 🎶

🎶 Akkord-Baukasten (Gruppe Übungen): Grundton, Qualität (23, von Dreiklängen bis 13er), Alterationen/Tensions (b5, #5, b9, #9, #11, b13 — je nach Qualität aktiv), optionaler Basston und Form (aufsteigend oder auf & ab). Hinzufügen fügt den Akkord als Arpeggio ein — tiefste spielbare Lage, Overblows/Overdraws inbegriffen — und das Fenster bleibt zum Verketten offen; Letzten entfernen löscht den zuletzt hinzugefügten Akkord.

Akkorde pro Takt: 1, 2 oder 4 im 4/4; 1 oder 3 im 3/4; 1 oder 2 im 6/8 und 12/8 — die Dauern füllen den gewählten Anteil exakt. Der Akkordname erscheint als Badge am Zeilenanfang, und 🔀 wie 🎲 wirken innerhalb jedes Akkords, ohne seine Takte zu zerstören. Bei der Wiedergabe schaltet die Taste 🎹 (Gruppe Wiedergabe) auf Blockakkorde um: Jeder Akkord erklingt als Klavier-Block auf der Zählzeit statt als Arpeggio.

♬ Akkordfolgen (verschiebbares Fenster der Gruppe Übungen): 19 klassische Progressionen (Pop, Jazz, 12-Takt-Blues, Moll-Kadenzen…), in alle 12 Tonarten transponierbar, mit Akkord-Vorschau. Einfügen setzt die Progression mit einem Akkord pro Takt; ein einziges Strg+Z macht alles rückgängig. Die Progression ist vor dem Einfügen bearbeitbar: Akkord anklicken, um Grundton, Qualität, Tensions (b5, b9, #11…) und Basston zu ändern; ◀ ▶ verschieben ihn, ✕ entfernt ihn, + fügt einen hinzu. Anzeige umschaltbar zwischen Namen / Stufen (römische Ziffern), und 💾 speichert Ihre Progression in der Preset-Liste (★, 🗑 zum Löschen); ⬇ exportiert Ihre Progressionen als .json und 📂 importiert sie zurück.

8. Feinbearbeitung

Klick = Auswahl (neue Töne folgen dahinter); ⌫/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.

Doppelklick auf eine Note öffnet einen vollständigen Editor: Kanal (1–10), Technik (nur auf diesem Kanal spielbare Noten, farbcodiert), Wert und Punkt ändern, Note in Pause umwandeln (und zurück) oder löschen.

⚠ Takt auffüllen: Ist der letzte Takt unvollständig, erscheint diese Taste über der Tabulatur. Die App schlägt drei mögliche Schlüsse in der aktuellen Tonleiter vor — einen wählen, die Töne werden angefügt und der Takt geht genau auf.

Tonart. Die Tonart der Exporte ist automatisch: Sie folgt der Tonika der generierten Melodie je nach Position, in Dur oder Moll — eine Moll-Pentatonik in 3. Position auf einer C-Mundharmonika ergibt also d-Moll (ein ♭), nicht die Tonart der Mundharmonika. Ohne generierte Melodie ist es die Dur-Tonart der Mundharmonika. Sie erscheint im ersten Takt des MusicXML (mit Modus) und in der MIDI-Datei — MuseScore zeigt eine saubere Partitur.

8 b. Gehörbildung 🎧 (Beta)

Unter dem Stimmgerät: 1 bis 6 Töne und Stufe wählen — Anfänger (Kanäle 4–6), Mittelstufe (Naturtöne), Fortgeschritten (Bendings, ohne Overnotes), Experte (alles inklusive). 🎲 spielt eine singbare Phrase (Intervalle ≤ Quinte, keine Wiederholung) in der aktuellen Tonart. ▶ Nochmal hören beliebig oft; 🎤 Mit dem Mikrofon antworten: Jeder richtige Ton füllt sein Feld, ein falscher blinkt rot und zählt als Fehler. Auflösen zeigt die Lösung. Schreibt nie in Ihre Tabulatur.

Punktzahl, Statistik und Abzeichen. Jedes bestandene Diktat ergibt eine Punktzahl = Töne × Stufe × 100, minus 20 pro Fehler und 5 pro Wiedergabe nach der ersten. Unter dem Modul: gespielte Diktate, fehlerfrei, Rekord, gesamt und aktuelle Serie (Zurücksetzen mit ↺). Sieben Abzeichen — Bronze-/Silber-/Goldenes Ohr (10/50/100 Diktate), Reibungslos und Absolutes Gehör (5 und 10 fehlerfrei in Folge), Virtuose (ein fehlerfreies Experten-Diktat), Atem-Meister (über 1000 Punkte). Alles bleibt im Browser, offline.

9. Tastaturkürzel

10. Audioaufnahme 🎙 (Beta)

Datei benennen, Mikrofon wählen (Systemstandard), ⏺ dann ⏹: Ein Player erscheint, ⬇ lädt herunter, 🗑 Leeren löscht die Aufnahme. Mono webm/opus (≈ 1 MB/min), überall abspielbar. Tipp: Tabulatur in Schleife + Aufnahme, mitspielen, vergleichen.

10 bis. Übung anhand eines Videos 🎯 (Beta)

Die Umkehrung des vorigen Moduls: Gehen Sie von einem Backingtrack aus, und die App schlägt die Positionen zum Üben darüber vor. Wählen Sie einen Ihrer Titel aus der Auswahlliste (Ihre Videos zuerst, dann die Bibliothek) — Tonart, Modus, Stil und Tempo werden von selbst ausgefüllt und das Video erscheint. Oder fügen Sie für ein beliebiges Video seinen YouTube-Link ein und geben Sie Tonart, Modus, Stil und Tempo von Hand an; die App schlägt dann zwei passende Backingtracks von Ihnen vor. Für jede aufgeführte Position (Harp + Skala) lädt eine Schaltfläche die Mundharmonika und erzeugt sofort eine Übung in dieser Position und Tonart. Die Wahl eines Backingtracks stellt den 🎼-Generator auf die erste Position ein, in 1 Takt.

11. Tonerkennung 🎤 (Beta)

🎤 Hören starten, gehaltenen Ton spielen: Die App zeigt den Ton, den Kanal in Tabulatur (Farbe der Technik, je nach gewählter Tonart) und Ihre Intonation (±50 Cent).

„Töne in die Tabulatur schreiben“: automatische Transkription mit echten rhythmischen Werten, gemessen von Einsatz zu Einsatz — eine abgesetzte Viertel bleibt eine Viertel (Artikulationslücken unter ~40 % des Intervalls werden absorbiert; darüber wird eine echte Pause notiert; über 4 Schlägen ist es ein Atemzug, nichts wird notiert). Ein früh losgelassener Schlusston wird auf den nächsten glatten Wert aufgerundet. Beim Stoppen wird der Rhythmus automatisch nachjustiert: echtes Tempo geschätzt, Dauern requantisiert, Tempo gesetzt. Optionales Metronom auf dem Raster. Ein einziges Strg+Z macht die Sitzung rückgängig.

Einsatz: einen Bend an der Anzeige prüfen, einen Overblow bestätigen, einen Riff abnehmen, der sich von selbst schreibt.

📈 Live-Tonhöhenverlauf

Klappt mit dem Stimmgerät auf (am Titel faltbar, 🗑 zum Löschen). Oben die Notenzeile (Violinschlüssel): jeder Ton genau im Moment seines Spiels platziert, am Graphen ausgerichtet; ein Klick auf die Notenzeile schickt die Werte dieses Tons ans Stimmgerät. Unten der laufende Graph (8 s): Ihre Tonhöhe als Punktlinien (grün ±5 Cent, orange ±15, rot darüber), Halbtonlinien mit Tabulatur der spielbaren Töne, Farbe nach Technik. Die vertikale Skala ist fest: der Linienabstand bleibt konstant, der Rahmen zentriert sich nur auf den gespielten Ton.

Navigation: Klick = Fokus, ←/→ ±1 s (Umschalt: 5 s), Mausrad, Klicken-und-Ziehen; der Lauf hält beim Überfahren an (⏸-Abzeichen), vertikaler Cursor mit genauer Anzeige (Tabulatur, Ton, Cent); Ende/Esc zurück zum Live-Bild. Die Schaltfläche ⏸ Anhalten stoppt den Lauf stabil, um die Kurve zu untersuchen, ohne die Maus daraufzuhalten; ▶ Fortsetzen kehrt zum Live-Bild zurück. ~5 Minuten Verlauf.

🎚 Chromatisches Stimmgerät

±50-Cent-Skala: grüne Zone ±5 (sauber), orange bis ±15, rot darüber. Geglättete Nadel, eine Tonpille, die die Farbe der angepeilten Zone annimmt (grün/orange), Tabulatur-Äquivalent, Frequenz. Das Wort SAUBER ✓ erscheint nur in der grünen Zone. Beim Stoppen friert die Anzeige ein (🗑 zum Zurücksetzen) und das Modul klappt mit dem Verlauf zu. Auf den Tonumfang der gewählten Mundharmonika begrenzt.

🎯 Übungsmodus: nützlich, um ein bestimmtes Bending zu üben. Modus anhaken und einen Zielton aus der Liste wählen — nur Bendings, Overblows und Overdraws (die zu übenden Töne). Die Nadel zeigt weiterhin den nächstgelegenen Ton (sie steht nie am Anschlag), während das ausgeschriebene Urteil zum Ziel gemessen wird: „NICHT TIEF GENUG ↓“, „ZU HOCH ↓“ und „SAUBER ✓“, wenn Sie ihn erreichen. Das Urteil gibt es nur im Übungsmodus, und „sauber“ setzt zusätzlich die Nadel in der grünen Zone voraus.

Kammerton-Kalibrierung (440 Hz, ▲▼, 415–466): Viele Mundharmonikas sind auf 442–443 Hz gestimmt. Globale, gespeicherte Einstellung: Stimmgerät, Erkennung und Wiedergabe teilen denselben Bezugston. Zuerst das A kalibrieren.

🎯 Tabulatur spielen — geprüftes Üben

Der erwartete Ton blinkt blau; spielen Sie ihn im eigenen Tempo ins Mikrofon: richtig → grün, weiter; falsch → rot, nochmal. Abschlussbericht: bestätigte Töne, Fehler, mittlere Intonation in Cent. Funktioniert mit jeder Tabulatur — mit dem Generator: jede Sitzung eine neue korrigierte Übung.

Beta-Grenzen

• Ein Ton auf einmal (keine Akkorde, keine Split-Oktaven).
• Klare Ansätze; Mindestdauer passt sich dem Tempo an; Bestätigung bei ±40 Cent (ein zu ungenauer Bend wird nicht transkribiert).
• Zweimal derselbe Ton: deutlich absetzen. Pausen zwischen Tönen werden nicht transkribiert.
• Tonart der App auf die der Mundharmonika stellen; ruhige Umgebung hilft.

11 bis. Swing-Meter 🎵 (Beta)

Das Swing-Meter misst über das Mikrofon Ihr Swing-Verhältnis, während Sie Achtelnoten spielen: 50 % = gerade (binär), 66,7 % = Triole (Swing). Es beruht auf den Abständen zwischen Ihren Anschlägen und ist dadurch unempfindlich gegen Audiolatenz. Eine Anzeige und ein klares Urteil — PLACEMENT OK bei geradem Ziel, SWING OK bei Triolen-Ziel — zeigen live, ob Sie im Ziel sind, und die Meldung bleibt stehen, wenn Sie aufhören. 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 Achtelnoten (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

13. Häufige Fragen

• Kein Ton beim ersten Klick (iPhone/iPad): Browser geben Audio erst nach der ersten Geste frei — einen Ton anklicken.
• Tonartwechsel ändert meine Töne? Die Tabulatur ändert sich nie; nur Namen und Tonhöhe folgen — wie ein Harmonikawechsel.
• Sitzung verschwunden: Die Speicherung gehört zu diesem Browser (privates Surfen und Datenlöschung entfernen sie) — als .json exportieren.
• Offline? Ja, vollständig: eigenständige Datei.
• MIDI-Import unvollständig: In der gewählten Tonart unspielbare Töne werden gelistet; die App schlägt die beste Tonart vor.
• Overblows beim Import abgelehnt: Auf einem Standard-Richter existieren nur Overblows 1, 4, 5, 6 und Overdraws 7, 9, 10.
• „Außerhalb der Mundharmonika“: Der erkannte Ton existiert in der gewählten Tonart nicht — Einstellung prüfen.
• ⟳ vs. Teilschleife: ⟳ wiederholt das Gespielte; mit Bereich (Umschalt+Klick) nur die Passage.

14. Effektzeichen und Textexport

✨ Effektzeichen an einer Note

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

Wählen Sie zuerst die Position (Davor oder Danach), dann klicken Sie die gewünschten Zeichen an. Eine einzelne Note kann mehrere Effekte tragen, davor und/oder danach; jeder bleibt unabhängig.

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

Beim Export: als Text (.txt) ist jedes Zeichen ein eigenes Element (z. B. DS TBS +4 vib Wa); in MusicXML wird jeder Effekt zu einem unabhängigen lyric, das in MuseScore unter der Note erscheint.

📝 Textexport (.txt)

Die Schaltfläche TXT (Gruppe Datei) lädt die Tabulatur als reinen Text mit den Effektzeichen herunter, benannt nach der Tabulatur.

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

1. Primeros pasos

Arriba, una cinta deslizante presenta los contenidos de apprendrelharmonica.com; se pausa al pasar el ratón, un clic abre la página. El logotipo, abajo, también firma las tablaturas impresas.

• Haga clic en las notas de la armónica virtual: cada clic toca la nota y la añade a la tablatura.
• ▶ (o Espacio) para escuchar. ¿Tablatura vacía? El botón «Probar: …» propone un lick de blues de un compás, distinto cada vez.
• 💾 Guardado automático en el navegador: cierre, vuelva mañana, su sesión se restaura.
• 📂 La mayoría de los módulos se despliegan o repliegan con un clic en su título; el esquema de la armónica y « Mi tablatura » permanecen siempre abiertos.
• 🔀 Organice los módulos a su manera: arrástrelos por el tirador ⠿ (se imantan a las columnas); la barra « Disposición » guarda y recupera varias disposiciones (↺ restaura la disposición original). Todo se guarda en el navegador.

1 bis. Disposición personalizada 🔀

Organiza los módulos a tu manera: arrastra cada tarjeta por su asa ⠿ — se imantan en las columnas. La barra «Disposición» guarda varias disposiciones con nombre y las recupera desde un menú; ↺ vuelve a la disposición original, y 💾 exporta tus disposiciones a un archivo reimportable. Todo se guarda en el navegador, propio de este dispositivo.

2. La notación

Código de colores en toda la aplicación: soplado · aspirado · bend · overblow · overdraw.

3. La armónica virtual

La tonalidad se muestra sobre el esquema. Cada columna alinea, de arriba abajo: overblows, bends soplados, nota soplada, nota aspirada, bends aspirados, overdraws. Hacer clic en un número de celda añade la nota soplada; pasar por una columna la ilumina. Los nombres siguen la tonalidad y la octava elegidas.

4. La barra de herramientas

🎵 Reproducción

• ▶/⏹ (Espacio), ⟳ bucle sin cortes — el campo ×N de al lado fija un número de bucles (suena N veces y se detiene; vacío = infinito). Tempo 40–240, 🔊 Volumen, ⏱ Metrónomo (acento según el compás: cada 4 o 3 pulsos).
• TAP: haga clic al ritmo (ratón) para fijar el tempo — promedio de los últimos clics, aplicado al tempo general; RESET borra los clics.
• BORDÓN: nota sostenida (12 opciones, octava grave) para trabajar afinación y posiciones. Apáguelo durante el reconocimiento de notas.

Durante la reproducción, la nota actual se ilumina en la tablatura y en la armónica.

🏋️ Ejercicios

• 🎼 Generador (§ 7) · 🔀 Mezclar la tablatura (una vez por clic, Ctrl+Z para volver) · ⇅ ascendente y descendente · SWING (corcheas ternarias) · 🎲 Duraciones aleatorias · +BPM tempo progresivo (§ 6). Los modos se combinan.

🎼 Tablatura

• TAB / Notes / Do Ré Mi: tablatura, nombres anglosajones (C4, Bb3…) o latinos (Do4, Sib3…).
• Tonalidad (12 armónicas): nombres y altura se adaptan, la tablatura no cambia.
• ▾8 / ▴8: transpone las notas seleccionadas una octava (o toda la tablatura si no hay selección; celdas equivalentes). Si una nota no tiene equivalente, nada cambia y se listan. Selección: Mayús+clic un rango, Ctrl/Cmd+clic notas sueltas, ⇄ Invertir intercambia seleccionadas y no seleccionadas.
• 1·3b·5 Grados (grupo Tablatura): muestra bajo cada nota su grado en la escala de referencia — el botón 🎼 contiguo abre el generador para elegir la escala, y la vista se alinea automáticamente con ella. Las notas fuera de la escala aparecen en gris; los arpegios del constructor de acordes muestran los intervalos del acorde (1, 3b, 5, 7b…).

📁 Archivo

• 📚 Biblioteca: tablaturas con nombre en este navegador — cargar, renombrar, borrar; ⬇ Exportar todo en .json reimportable. Las ventanas se arrastran por su título.
• 💾 / 📂: archivo .json completo; 📂 abre también .mid (conversión a tablatura: duraciones cuantizadas, silencios reconstruidos, tempo aplicado, notas no tocables listadas, mejor tonalidad sugerida) y .xml/.musicxml.
• 📋 Importar texto (§ 5) · 🎹 MIDI (GM Harmonica) · XML MusicXML: partitura exacta — figuras y duraciones siempre coinciden, compases completos, ligaduras escritas; MuseScore no reescribe nada.
• 🖨 Imprimir: maquetación limpia, fondo blanco, logotipo, 12 notas por línea (PDF mediante «Imprimir en PDF»).

✏️ Edición & ♩ Duraciones

↶/↷ (Ctrl+Z / Ctrl+Y), 🗑 borrar todo, ? ayuda. Nueve valores: redonda, blanca, negra, corchea, semicorchea, tresillo, puntillo (+50 %), y tres silencios (1, ½, ¼ tiempo). La duración elegida se aplica a las próximas notas; con una selección, la modifica directamente.

Notas a caballo entre compases: divididas en pantalla y unidas con ‿ (parte ligada punteada) — la nota sigue siendo una sola, tocada de un soplo; la exportación MusicXML escribe la ligadura.

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

5. Importar una tablatura de texto 📋

Pegue sus tablaturas (notas separadas por espacios; comas, saltos y | aceptados): +4 -4 +5 -5 +6 -6' -6 z +6 -5 +5 -4 +4. El + es opcional, z inserta un silencio, los elementos inválidos se omiten y listan, la importación se añade al final.

6. Trabajar un pasaje

Bucle parcial

Clic en la primera nota, Mayús+clic en la última: el rango se resalta, ▶ solo lo toca, ⟳ lo repite. Un clic sin Mayús sale. El rango también permite cambiar todas las duraciones o borrar de una vez.

Tempo progresivo (+BPM)

Ajuste el paso (1–20 BPM por pasada) y el máximo: cada vuelta sube el tempo, mostrado en vivo. Ejemplo: 4 notas difíciles + 60 BPM + paso 4 + máx. 120 → ~15 pasadas sin tocar nada.

7. Generador de melodías 🎼

Melodías coherentes: escalas agrupadas por posición — mayor y pentatónica mayor (1.ª); blues, mixolidio, pentatónica (2.ª); pentatónica menor, blues, dórico (3.ª); menor natural, pentatónica menor (4.ª); frigio, pentatónica menor, menor natural con bends (5.ª); lidio, mayor con bends (12.ª). Cuatro niveles (Principiante celdas 4–6 → Experto con overblows), 1, 2 o 4 compases. La melodía termina en la tónica, salvo que marque «No terminar en la tónica». La ventana permanece abierta: regenere en bucle (🎼), escuche, ajuste, sin perder el control de la aplicación; ciérrela con ✕ o Cancelar. Ctrl+Z restaura. Idea de sesión: Intermedio + blues 2.ª posición + 1 compás + bucle + tempo progresivo.

Un clic (principiantes). Arriba en el generador, unos botones de intención nombrados por estado de ánimo — «Un blues fácil», «Una melodía alegre», «Un riff pop/rock», «Algo melancólico», «Sorpréndeme» — ajustan los menús por ti (los ves moverse) y generan al instante: un clic, una melodía. Vuelve a hacer clic para otro sorteo. Los ajustes detallados quedan debajo para quien quiera elegir escala, posición y nivel con precisión.

Leer y tocar lo generado. El recordatorio de notación «📖 ¿Cómo leer la tablatura?» (soplar, aspirar, bends, código de color) está disponible en la ayuda ? del menú Edición. En cuanto hay notas, aparece bajo la tablatura una fila de iconos: ▶ (rojo) reproduce la tablatura, ⏹ (verde) detiene, el icono de micrófono (azul) lanza el modo 🎯 (tocas al micro y la app valida nota por nota) y + añade o inserta una nota — tras la nota seleccionada, si no al final — abriendo el editor; vuelve a pulsar para añadir más, las barras de compás se recalculan.

Compás y duraciones. Elija el compás — 4/4 o 3/4 (vals): toda la app lo sigue (barras de compás, metrónomo, exportaciones MIDI y MusicXML). Y restrinja las duraciones de notas usadas marcando solo negra, corchea, semicorchea o tresillo — por ejemplo una melodía solo de tresillos, o de negras y corcheas (todo marcado = libre).

Mis modos 🧬 (módulo plegable): crea tus propios modos — nombre, posición (1ª a 12ª), grados marcados entre los 12 semitonos — memorizados en el navegador y disponibles (★) en los selectores de escalas del generador, de los grados 1·3b·5 y del Swing-metro. ✎ edita un modo, 🗑 lo elimina.

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

7 bis. Acordes y progresiones 🎶

🎶 Constructor de acordes (grupo Ejercicios): elige la fundamental, la calidad (23, de tríadas a 13as), las alteraciones/tensiones (b5, #5, b9, #9, #11, b13 — activas según la calidad), una nota de bajo opcional y la forma (ascendente o subida y bajada). Añadir inserta el acorde en arpegio — posición más grave tocable, overblows/overdraws incluidos — y la ventana queda abierta para encadenar; Quitar el último borra el último acorde añadido.

Acordes por compás: 1, 2 o 4 en 4/4; 1 o 3 en 3/4; 1 o 2 en 6/8 y 12/8 — las duraciones se reparten para llenar exactamente la parte elegida. El nombre del acorde aparece como insignia al inicio de su línea, y tanto 🔀 como 🎲 actúan dentro de cada acorde sin romper sus compases. Durante la lectura, el botón 🎹 (grupo Lectura) cambia a acordes plaqué: cada acorde suena en bloque sobre el tiempo, con sonido de piano, en vez del arpegio.

♬ Progresiones de acordes (ventana desplazable del grupo Ejercicios): 19 progresiones clásicas (pop, jazz, blues de 12 compases, cadencias menores…), transponibles a las 12 tonalidades, con vista previa de los acordes. Insertar coloca la progresión un acorde por compás; un solo Ctrl+Z la deshace por completo. La progresión es editable antes de insertarla: haz clic en un acorde para cambiar fundamental, calidad, tensiones (b5, b9, #11…) y nota de bajo; ◀ ▶ lo mueven, ✕ lo quita, + añade uno. Alterna la vista Nombres / Grados (números romanos), y 💾 guarda tu progresión en la lista de presets (★, 🗑 para eliminarla); ⬇ exporta tus progresiones en .json y 📂 las reimporta.

8. Edición fina

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

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

⚠ 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 en la escala actual — elige uno, las notas se añaden y el compás queda exacto.

Armadura. 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 en una armónica en C 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.

8 bis. Dictado musical 🎧 (beta)

Bajo el afinador: elija de 1 a 6 notas y el nivel — Principiante (celdas 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. ▶ Escuchar de nuevo sin límite; 🎤 Responder al micrófono: cada nota correcta llena su casilla, una errónea parpadea en rojo y cuenta un error. Revelar muestra la solución. Nunca escribe en su tablatura.

Puntuación, estadísticas e insignias. Cada dictado superado da una puntuación = notas × nivel × 100, menos 20 por error y 5 por reescucha tras la primera. Bajo el módulo: dictados jugados, sin fallos, récord, total y racha actual (reinicio con ↺). Siete insignias — Oído de bronce/plata/oro (10/50/100 dictados), Sin tropiezos 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 se guarda en el navegador, sin conexión.

9. Atajos de teclado

10. Grabación de audio 🎙 (beta)

Nombre el archivo, elija el micrófono (sistema por defecto), ⏺ y luego ⏹: aparece un reproductor, ⬇ descarga, 🗑 Borrar elimina la grabación. Mono webm/opus (≈ 1 MB/min), legible en todas partes. Consejo: bucle de la tablatura + grabación, toque encima, compare.

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

El módulo inverso del anterior: parta de un backing track y la app propone las posiciones para trabajar encima. Elija uno de sus temas en la lista desplegable (sus vídeos primero, luego la biblioteca) — tonalidad, modo, estilo y tempo se rellenan solos y el vídeo aparece. O, para cualquier vídeo, pegue su enlace de YouTube e indique a mano su tonalidad, su modo, su estilo y su tempo; la app propone entonces dos backing tracks suyos que coincidan. Para cada posición listada (armónica + escala), un botón carga la armónica y genera enseguida un ejercicio en esa posición y tonalidad. Elegir un backing track preconfigura el generador 🎼 en la primera posición, en 1 compás.

11. Reconocimiento de notas 🎤 (beta)

🎤 Empezar a escuchar, toque una nota sostenida: la aplicación muestra la nota, su celda en tablatura (color de su técnica, según la tonalidad elegida) y su afinación (±50 cents).

«Escribir las notas en la tablatura»: transcripción automática con el valor rítmico real, medido de ataque a ataque — una negra destacada sigue siendo una negra (los huecos de articulación bajo ~40 % del intervalo se absorben; más allá, se escribe un verdadero silencio; más de 4 tiempos es una respiración, no se escribe nada). La última nota soltada pronto se redondea al valor pleno superior. Al parar, el ritmo se reajusta automáticamente: tempo real estimado, duraciones recuantizadas, Tempo ajustado. Metrónomo opcional sobre la rejilla. Un solo Ctrl+Z anula la sesión.

Usos: verificar un bend en el indicador, confirmar un overblow, transcribir un riff que se escribe solo.

📈 Trazado del toque en directo

Se despliega con el afinador (plegable 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 en el pentagrama envía la lectura de esa nota al afinador. Abajo, el gráfico deslizante (8 s): su altura en líneas punteadas (verde ±5 cents, naranja ±15, rojo más allá), líneas de semitonos con la tablatura de las notas tocables, color por técnica. La escala vertical es fija: el espaciado de líneas se mantiene constante, el marco solo se recentra en la nota tocada.

Navegación: clic = foco, ←/→ ±1 s (Mayús: 5 s), rueda, clic y arrastre; el desplazamiento se congela al pasar el ratón (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

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

🎯 Modo entrenamiento: útil para trabajar un bend concreto. Marque el modo y elija una nota objetivo de la lista — solo bends, overblows y overdraws (las notas a trabajar). La aguja sigue indicando la nota más cercana (nunca se bloquea), mientras que el veredicto escrito se mide respecto al objetivo: «FALTA BAJAR ↓», «MUY ALTO ↓» y «AFINADO ✓» cuando lo alcanza. El veredicto solo existe en modo entrenamiento, y «afinado» exige además que la aguja esté 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 al mismo diapasón. Calibre primero el La.

🎯 Tocar la tablatura — trabajo validado

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

Límites de la beta

• Una nota a la vez (sin acordes ni octavas split).
• Notas francas; duración mínima adaptada al tempo; validación a ±40 cents (un bend impreciso no se transcribe).
• Dos veces la misma nota: sepárelas claramente. Los silencios entre notas no se transcriben.
• Ajuste la tonalidad de la aplicación a la de su armónica; un entorno tranquilo ayuda.

11 bis. Medidor de swing 🎵 (beta)

El medidor de swing mide tu proporción de swing con el micro mientras tocas corcheas: 50 % = recto (binario), 66,7 % = tresillo (swing). Se basa en los intervalos entre tus ataques, lo que lo hace inmune a la latencia de audio. Un indicador y un veredicto en claro — PLACEMENT OK para un objetivo recto, SWING OK para un objetivo de tresillo — muestran en directo si estás en el objetivo, y el mensaje permanece cuando te detienes. Elige el objetivo (Recto 50 % o Tresillo 66,7 %), ajusta el tempo (sincronizado con la barra de herramientas) y, si quieres, deja que el módulo genere un ejercicio de corcheas (2, 4, 6 u 8) en la escala elegida — o «libre» para tocar lo que quieras. 🗑 reinicia el módulo.

12. Exportaciones

13. Preguntas frecuentes

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

14. Signos de efecto y exportación de texto

✨ Signos de efecto en una nota

En el editor de notas (doble clic en una nota), puede añadir signos de efecto que no afectan al ritmo ni a la duración: solo anotan una intención de interpretación.

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

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).

Al exportar: en texto (.txt), cada signo es un elemento separado (ej. DS TBS +4 vib Wa); en MusicXML, cada efecto se convierte en un lyric independiente que aparece bajo la nota en MuseScore.

📝 Exportación de texto (.txt)

El botón TXT (grupo Archivo) descarga la tablatura como texto sin formato, con los signos de efecto, con el nombre de la tablatura.

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

1. はじめに

上部のスクロールバナーは apprendrelharmonica.com のコンテンツを紹介します。マウスを乗せると停止し、クリックでページが開きます。下部のサイトロゴはタブ譜の印刷にも入ります。

• バーチャルハーモニカの音をクリック：クリックごとに音が鳴り、タブ譜に追加されます。
• ▶（または スペース）で再生。タブ譜が空のとき？ 「試す：…」ボタンが1小節のブルース・リックを提案します（毎回異なります）。
• 💾 ブラウザに自動保存：閉じても翌日戻ればセッションが復元されます。
• 📂 ほとんどのモジュールはタイトルをクリックして開閉できます。ハーモニカ配列図と「マイタブ」は常に開いたままです。
• 🔀 モジュールを自由に配置：⠿ ハンドルでドラッグ（列に吸着）。「レイアウト」バーで複数の配置を保存・呼び出し（↺ で元の配置に戻す）。すべてブラウザに保存されます。

1 bis. レイアウトのカスタマイズ 🔀

モジュールを自由に配置：各カードを ⠿ ハンドルでドラッグすると、列に吸着します。「レイアウト」バーは名前付きの配置を複数保存し、メニューから呼び出せます。↺ で元の配置に戻り、💾 でレイアウトを再インポート可能なファイルに書き出します。すべてこの端末のブラウザーに保存されます。

2. 記譜法

色分けは全体共通：吹き · 吸い · ベンド · オーバーブロー · オーバードロー。

3. バーチャルハーモニカ

キーは図の上に表示されます。各列は上から下へ：オーバーブロー、吹きベンド、吹き音、吸い音、吸いベンド、オーバードロー。穴番号をクリックすると吹き音が追加され、列にマウスを乗せると点灯します。音名は選択したキーとオクターブに従います。

4. ツールバー

🎵 再生

• ▶/⏹（スペース）、⟳ 途切れないループ — 隣の ×N 欄で繰り返し回数を指定（N回再生して停止、空欄＝無限）。テンポ 40〜240、🔊 音量、⏱ メトロノーム（拍子に応じて4拍または3拍ごとにアクセント）。
• TAP：リズムに合わせてクリック（マウス）してテンポを設定 — 直近のクリックの平均が全体テンポに適用されます。RESET でクリックを消去。

再生中、現在の音がタブ譜とハーモニカ上で点灯します。

🏋️ 練習

• 🎼 ジェネレーター（§ 7）· 🔀 シャッフル（クリックごとに一度、Ctrl+Zで戻す）· ⇅ 上行から下行 · SWING（3連符化した8分音符）· 🎲 ランダム音価 · +BPM 漸進テンポ（§ 6）。各モードは併用できます。

🎼 タブ譜

• TAB / Notes / Do Ré Mi：タブ譜、英米式音名（C4, Bb3…）、ラテン式音名（Do4, Sib3…）。
• キー（12種のハーモニカ）：音名と音高は変わりますが、タブ譜自体は変わりません。
• ▾8 / ▴8：選択した音を1オクターブ移調（何も選択していなければタブ譜全体／対応する穴へ）。対応がない音があれば何も変えず一覧表示します。選択：Shift+クリックで範囲、Ctrl/Cmd+クリックで個別、⇄ 反転で選択／非選択を入れ替え。
• 1·3b·5 度数（タブ譜グループ）：各音符の下に基準スケール内の度数を表示します — 隣の 🎼 ボタンでジェネレーターを開いてスケールを選ぶと、表示が自動的に連動します。スケール外の音はグレー表示、コードビルダーのアルペジオはコードのインターバル（1, 3b, 5, 7b…）を表示します。

📁 ファイル

• 📚 ライブラリ：このブラウザに名前付きで保存 — 読み込み・名前変更・削除。⬇ すべてエクスポートで再読み込み可能な .json に。ウィンドウはタイトルでドラッグできます。
• 💾 / 📂：完全な .json ファイル。📂 は .mid も開きます（タブ譜へ変換：音価を量子化、休符を再構築、テンポを適用、演奏不可の音を一覧、最適なキーを提案）および .xml/.musicxml。
• 📋 読み込み テキストタブ譜（§ 5）· 🎹 MIDI（GM Harmonica）· XML MusicXML：正確な楽譜 — 音符の形と音価が常に一致、小節は満たされ、タイも書き込まれ、MuseScore がリズムを書き換えません。
• 🖨 印刷：すっきりしたレイアウト、白背景、ロゴ、1行12音（「PDFに印刷」でPDF化）。

✏️ 編集 & ♩ 音価

↶/↷（Ctrl+Z / Ctrl+Y）、🗑 全消去、? ヘルプ。9つの値：全音符、2分、4分、8分、16分音符、3連符、付点（+50%）、3つの休符（1・½・¼拍）。選んだ音価は次の音に適用。選択中なら直接変更します。

小節線をまたぐ音：画面上で分割され ‿ で結ばれます（タイ部分は点線）— 音は1つのまま、一息で演奏されます。MusicXML エクスポートはタイを書き込みます。

‿ スラー（編集グループ）：選択した音符をつなぎます — 音符の間に ‿ 記号が表示されます。同じ高さのつながれた2音は、吹き直しなしにひと息で演奏され、MusicXML 書き出しにもスラーが記録されます。エディタ（ダブルクリック）の ‿ ボタンでも1音ずつ設定できます。

5. テキストタブ譜の読み込み 📋

タブ譜を貼り付け（音はスペース区切り。カンマ・改行・| も可）：+4 -4 +5 -5 +6 -6' -6 z +6 -5 +5 -4 +4。+ は省略可、z は休符を挿入、無効な要素はスキップして一覧表示、読み込みは末尾に追加されます。

6. パッセージを練習する

部分ループ

最初の音をクリック、Shift+最後の音をクリック：範囲がハイライトされ、▶ はそこだけ再生、⟳ でループ。Shiftなしのクリックで解除。範囲は全音価の一括変更や一括削除にも使えます。

漸進テンポ（+BPM）

ステップ（1回ごとに1〜20 BPM）と上限を設定：1ループごとにテンポが上がり、リアルタイム表示。例：難しい4音 + 60 BPM + ステップ4 + 上限120 → 操作なしで約15回かけて上昇。

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

音楽的にまとまったメロディ：ポジション別にまとめたスケール — メジャー＆メジャーペンタ（1st）；ブルース・ミクソリディアン・ペンタ（2nd）；マイナーペンタ・ブルース・ドリアン（3rd）；自然的短音階・マイナーペンタ（4th）；フリジアン・マイナーペンタ・ベンドありの自然的短音階（5th）；リディアン・ベンドありのメジャー（12th）。4レベル（初級 4〜6番穴 → エキスパート オーバーブロー含む）、1・2・4小節。「主音で終わらない」にチェックしない限り、メロディは主音で終わります。ウィンドウは開いたまま：ループで再生成（🎼）、試聴、調整がアプリを操作しながら可能；✕ またはキャンセルで閉じます。Ctrl+Z で復元。練習例：中級 + 2nd ポジション・ブルース + 1小節 + ループ + 漸進テンポ。

ワンクリック（初心者向け）。 ジェネレーターの上部にある意図ボタンは気分で名づけられています — 「やさしいブルース」「明るいメロディ」「ポップ／ロックのリフ」「もの悲しい感じ」「おまかせ」。クリックするとメニューが自動で設定され（動くのが見えます）、すぐに生成されます。ワンクリックで一曲。もう一度押せば別の生成になります。詳細設定は下に残っているので、スケール・ポジション・レベルを細かく選びたい人も使えます。

生成したものを読んで吹く。 記譜法のリマインダー「📖 タブ譜の読み方」（吹く、吸う、ベンド、配色）は、編集メニューのヘルプ ? で見られます。音符があると、タブ譜の下にアイコンの列が現れます：▶（赤）でタブ譜を再生、⏹（緑）で停止、マイクアイコン（青）で 🎯 モードを起動（マイクに吹き込むと一音ずつ判定）、+ で音符を追加・挿入（選択音の後、なければ末尾）してエディターを開きます。もう一度押せばさらに追加でき、小節線は自動的に再計算されます。

拍子と音価。拍子を選びます — 4/4 または 3/4（ワルツ）。アプリ全体が従います（小節線、メトロノーム、MIDI・MusicXML エクスポート）。さらに、使う音符の長さを制限できます。四分・八分・十六分・三連符のうち必要なものだけにチェック — 例えば三連符だけ、または四分音符と八分音符だけのメロディ（すべてチェック＝自由）。

マイモード 🧬（折りたたみ式モジュール）：独自のモードを作成 — 名前、ポジション（第1〜第12）、12半音から度数を選択 — ブラウザに保存され、ジェネレーター・1·3b·5度数・スウィングメーターのスケール選択に（★付きで）表示されます。✎ で編集、🗑 で削除。

ジェネレーターのウィンドウでは、スケール選択の横に：🗑 で表示中のスケールをリストから外し（選択は記憶）、↺ で全スケールを再表示；⬇ でマイモードを .json ファイルに書き出し、📂 で読み込みます。

7 bis. コードと進行 🎶

🎶 コードビルダー（エクササイズグループ）：ルート、コードの種類（トライアドから13thまで23種）、変化音・テンション（b5, #5, b9, #9, #11, b13 — 種類に応じて有効）、任意のベース音、形（上行または上行・下行）を選びます。追加でコードがアルペジオとして挿入され — 演奏可能な最低ポジション、オーバーブロー／オーバードロー込み — ウィンドウは開いたまま次のコードへ；最後を削除で直前のコードを取り消せます。

1小節あたりのコード数：4/4 では 1・2・4、3/4 では 1・3、6/8 と 12/8 では 1・2 — 音価は選んだ区画をちょうど埋めるよう配分されます。コード名は行頭にバッジ表示され、🔀 も 🎲 も各コードの内部で働き、小節を崩しません。 再生時、🎹 ボタン（再生グループ）でブロックコードに切り替え：各コードはアルペジオではなく、拍に合わせてピアノ音で同時に鳴ります。

♬ コード進行（エクササイズグループの移動可能なウィンドウ）：定番進行19種（ポップ、ジャズ、12小節ブルース、マイナーカデンツ…）を12のキーに移調可能、コードのプレビュー付き。挿入で1小節1コードで配置され、Ctrl+Z 一回で全体を取り消せます。 挿入前に進行を編集できます：コードをクリックしてルート・種類・テンション（b5, b9, #11…）・ベース音を変更、◀ ▶ で移動、✕ で削除、+ で追加。表示は名前／度数（ローマ数字）で切り替え、💾 で自分の進行をプリセット一覧に保存（★、🗑 で削除）；⬇ で進行を .json に書き出し、📂 で読み込みます。

8. 細かい編集

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

音をダブルクリックすると完全なエディターが開きます：穴（1〜10）、奏法（その穴で実際に出せる音のみ、色分け表示）、音価と付点の変更、音符↔休符の変換、削除。

⚠ 小節を補完：最後の小節が不完全なとき、このボタンがタブ譜の上に表示されます。アプリが現在のスケール内で3通りの終わり方を提案します — 1つ選ぶと音符が追加され、小節がちょうど埋まります。

調号。エクスポートの調号は自動です：生成したメロディの主音（ポジションに応じて長調または短調）に従います——たとえば C ハーモニカの 3rd ポジションのマイナーペンタトニックはニ短調（♭1つ）になり、ハーモニカの調号にはなりません。メロディを生成していない場合は、ハーモニカの長調になります。MusicXML の最初の小節（モード付き）と MIDI に書き込まれ、MuseScore ではきれいな楽譜になります。

8-b. 聴音 🎧（ベータ）

チューナーの下：1〜6音とレベルを選択 — 初級（4〜6番穴）、中級（ナチュラル音）、上級（ベンドあり、オーバーノートなし）、エキスパート（すべて含む）。🎲 が歌えるフレーズ（音程は5度以内、反復なし）を現在のキーで再生。▶ もう一度聴くは何度でも。🎤 マイクで答える：正しい音はマスを埋め、間違いは赤く点滅してミスを1つ加算。答えを見るで解答を表示。タブ譜には決して書き込みません。

スコア・統計・バッジ。 成功した聴音ごとにスコア＝音数 × レベル × 100、ミス1回ごとに −20、2回目以降の再生1回ごとに −5。モジュールの下に：実施回数、ノーミス、記録、累計、連続中（↺ でリセット）。7つのバッジ — ブロンズ／シルバー／ゴールドの耳（10/50/100回）、快調・絶対音感（ノーミス5・10連続）、名人（エキスパートをノーミス）、ブレスの達人（1回で1000点超え）。すべてブラウザ内・オフラインで保存。

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

10. オーディオ録音 🎙（ベータ）

ファイル名を付け、マイクを選び（既定はシステム）、⏺ から ⏹：プレーヤーが現れ、⬇ でダウンロード、🗑 消去 で録音を削除。モノラル webm/opus（約1 MB/分）、どこでも再生可。コツ：タブ譜をループ再生＋録音、重ねて演奏し、聴き比べる。

10 bis. 動画に合わせて練習 🎯（ベータ）

前のモジュールの逆方向です。バッキングトラックから始めると、アプリがその上で練習するポジションを提案します。ドロップダウンリストからあなたの曲を選ぶと（あなたの動画が先、次にライブラリ）、キー・モード・スタイル・テンポが自動入力され、動画が表示されます。任意の動画の場合はYouTube リンクを貼り、キー・モード・スタイル・テンポを手入力します。するとアプリが、一致するあなたのバッキングトラックを2つ提案します。表示された各ポジション（ハープ＋スケール）のボタンで、ハーモニカを読み込み、そのポジションとキーで練習をすぐに生成します。バッキングトラックを選ぶと、🎼 ジェネレーターが最初のポジション・1小節にあらかじめ設定されます。

11. 音認識 🎤（ベータ）

🎤 認識を開始し、音を伸ばして演奏：アプリが音名、タブ譜の穴（選択キーに応じて奏法色付き）、音程（±50セント）を表示します。

「タブ譜に音を書き込む」：実際の音価で自動採譜、アタックからアタックまでで測定 — 切って演奏した4分音符も4分音符のまま（アーティキュレーションの隙間は音程の約40%未満なら吸収；それ以上は本当の休符として記譜；4拍を超えるとブレスとみなし何も書きません）。早く離した最後の音は1つ上のきりのよい値に丸めます。停止すると、リズムが自動的に再調整されます：実テンポを推定し、音価を再量子化し、テンポを設定。任意のメトロノームがグリッドに合わせます。1回の Ctrl+Z でセッション全体を取り消し。

用途：メーターでベンドを確認、オーバーブローを確認、ひとりでに書けるリフの採譜。

📈 リアルタイム演奏トレース

チューナーと一緒に開きます（タイトルで折りたたみ、🗑 で消去）。上部の五線譜（ト音記号）：各音は演奏した正確な瞬間に置かれ、グラフと揃います。五線譜をクリックするとその音の値がチューナーに送られます。下部のスクロールグラフ（8秒）：あなたの音高を点線で（緑 ±5セント、橙 ±15、それ以上は赤）、半音線に演奏可能な音のタブ譜、奏法による色分け。縦軸の目盛りは固定：線の間隔は一定で、枠は演奏中の音に合わせて中央へ寄るだけです。

操作：クリック＝フォーカス、←/→ ±1秒（Shift：5秒）、ホイール、クリック＆ドラッグ。スクロールはマウスを乗せると停止（⏸ バッジ）、縦カーソルが正確な値（タブ譜・音名・セント）を表示。End/Esc でライブに戻ります。⏸ 固定ボタンは、マウスを乗せ続けなくても曲線を観察できるようスクロールを安定して止めます。▶ 再開でライブに戻ります。約5分の履歴。

🎚 クロマチックチューナー

±50セントのダイヤル：緑ゾーン ±5（ジャスト）、橙は±15まで、それ以上は赤。なめらかな針、狙ったゾーンの色になる音名のピル（緑／橙）、タブ譜の対応、周波数。ジャスト ✓の文字は緑ゾーンでのみ表示されます。停止すると表示が固定され（🗑 でリセット）、モジュールはトレースと一緒に折りたたまれます。選択中のハーモニカの音域に制限されます。

🎯 トレーニングモード：特定のベンドを練習するのに便利です。モードにチェックし、リストから目標音を選びます — ベンド・オーバーブロー・オーバードローのみ（練習対象の音）。針は最も近い音を示し続け（決して振り切れません）、文字の判定は目標を基準に測られます：「まだ高い ↓」「高すぎ ↓」、達成すると「ジャスト ✓」。判定はトレーニングモードのみで、「ジャスト」は針が緑のゾーンにあることも条件です。

基準音Aの校正（440 Hz、▲▼、415〜466）：多くのハーモニカは442〜443 Hz です。全体に適用され記憶される設定：チューナー、認識、再生が同じ基準音に揃います。まずAを校正してください。

🎯 タブ譜を演奏 — 採点付き練習

期待される音が青く点滅。自分のペースでマイクに演奏：正解 → 緑、次へ；不正解 → 赤、もう一度。最終レポート：合格音、ミス、平均音程（セント）。どんなタブ譜でも使え、ジェネレーターと組み合わせれば毎回新しい採点付き課題に。

ベータ版の制限

• 一度に1音のみ（和音やスプリットオクターブは不可）。
• はっきりしたアタックで。最短の保持時間はテンポに応じて変化。判定は±40セント以内（雑なベンドは採譜されません）。
• 同じ音を2回：はっきり区切ってください。音と音の間の休符は採譜されません。
• アプリのキーをハーモニカのキーに合わせてください。静かな環境が効果的です。

11 bis. スイングメーター 🎵 (ベータ)

スイングメーターは、8分音符を吹いている間にマイクからあなたのスイング比を測定します：50 %＝ストレート（イーブン）、66.7 %＝三連（スイング）。アタック間の間隔にもとづくため、オーディオ遅延の影響を受けません。メーターと明確な判定——ストレート目標なら PLACEMENT OK、三連目標なら SWING OK——が目標内かどうかをリアルタイムに示し、止めてもメッセージは残ります。目標（ストレート 50 % または三連 66.7 %）を選び、テンポ（ツールバーと同期）を設定し、必要なら選んだスケールで 8分音符（2・4・6・8）の練習を生成させることもできます——または「フリー」で好きに吹けます。🗑 でモジュールをリセットします。

12. エクスポート

13. よくある質問

• 最初のクリックで音が出ない（iPhone/iPad）：ブラウザは最初の操作で音声を有効化します — 音を1つクリックしてください。
• キーを変えたら音が変わった？ タブ譜は変わりません。音名と音高だけが従います — ハーモニカを持ち替えるのと同じです。
• セッションが消えた：自動保存はこのブラウザに保存されます（プライベートモードやデータ削除で消えます）— .json でエクスポートを。
• オフライン？ はい、完全に：自己完結型ファイルです。
• MIDI読み込みで音が欠ける：選択キーで演奏不可の音は一覧表示され、アプリが最適なキーを提案します。
• 読み込み時にオーバーブローが拒否される：標準リヒターではオーバーブロー 1・4・5・6、オーバードロー 7・9・10 のみ存在します。
• 「ハーモニカ外」：検出された音が選択キーに存在しません — 設定を確認してください。
• ⟳ と部分ループの違い：⟳ は再生中のものを繰り返します。範囲（Shift+クリック）があればそのパッセージのみ。

14. 奏法記号とテキスト書き出し

✨ 音符の奏法記号

音符エディタ（音符をダブルクリック）で、リズムや長さに影響しない奏法記号を追加できます。演奏の意図を書き留めるだけのものです。

まず位置（音符の前または後）を選び、次に必要な記号をクリックします。1つの音符に、前・後それぞれ複数の効果を付けられ、各記号は独立しています。

グリッサンドとトリルはアプリの音では再現されません。記号はタブ譜に（オレンジ色で、音符の周りに）表示されます。

書き出し時：テキスト（.txt）では各記号が独立した要素になり（例：DS TBS +4 vib Wa）、MusicXMLでは各効果が独立した lyric となり、MuseScore で音符の下に表示されます。

📝 テキスト書き出し（.txt）

TXT ボタン（ファイルグループ）で、奏法記号付きのタブ譜をプレーンテキストとして、タブ譜の名前で書き出します。

用于创建、播放和练习十孔全音阶口琴谱的网页应用。单一文件，无需安装、无需联网：在浏览器中打开 harmonica-trainer.html 即可。界面支持六种语言（应用底部的语言按钮选择，选择会被记住 — 本手册随之同步）。

1. 开始使用

页面顶部的滚动横幅展示 apprendrelharmonica.com 的内容；鼠标悬停时暂停，点击打开页面。底部的网站徽标也会出现在打印的谱子上。

• 点击虚拟口琴上的音符：每次点击发声并添加到谱子。
• ▶（或 空格）播放。谱子为空？"试试：…"按钮提供一个一小节的布鲁斯乐句，每次都不同。
• 💾 浏览器内自动保存：关闭后明天再来，会话即可恢复。
• 📂 大多数模块可点击标题展开或收起；口琴音位图和“我的谱子”始终保持展开。
• 🔀 按你的方式排列模块：用 ⠿ 手柄拖动（吸附到各列）；“布局”栏可保存并调用多种布局（↺ 恢复初始布局）。全部保存在浏览器中。

1 bis. 自定义布局 🔀

按你的喜好排列模块：用 ⠿ 手柄拖动每张卡片，它们会吸附到列上。“布局”栏可保存多个命名布局并从菜单调用；↺ 恢复初始布局，💾 将你的布局导出为可重新导入的文件。全部保存在本设备的浏览器中。

2. 记谱法

全程颜色编码：吹 · 吸 · 压音 · 超吹 · 超吸。

3. 虚拟口琴

调性显示在示意图上方。每一列自上而下排列：超吹、吹气压音、吹音、吸音、吸气压音、超吸。点击孔号会添加该孔的吹音；悬停某列会高亮显示。音名随所选调性和八度变化。

4. 工具栏

🎵 播放

• ▶/⏹（空格）、⟳ 无缝循环 — 旁边的 ×N 输入框可设定循环次数（播放 N 次后停止；留空＝无限）。速度 40–240、🔊 音量、⏱ 节拍器（按拍号每 4 拍或 3 拍重音）。
• TAP：跟着节奏点击（鼠标）来设定速度 — 取最近几次点击的平均值，应用到全局速度；RESET 清除点击。
• 持续音：保持的长音（12 种，低八度），用于练习音准和把位。音符识别时请关闭。

播放时，当前音符会在谱子和口琴上点亮。

🏋️ 练习

• 🎼 生成器（§ 7）· 🔀 打乱谱子（每次点击一次，Ctrl+Z 撤销）· ⇅ 先上行后下行 · SWING（三连化八分音符）· 🎲 随机时值 · +BPM 渐进速度（§ 6）。各模式可叠加。

🎼 谱子

• TAB / Notes / Do Ré Mi：口琴谱、英美式音名（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 口琴）· XML MusicXML：精确乐谱 — 音符形态与时值始终一致、小节填满、写入连音线；MuseScore 不会重写节奏。
• 🖨 打印：版面整洁、白底、徽标、每行 12 个音（通过"打印为 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 点击即退出。该范围还可一次性更改所有时值或一并删除。

渐进速度（+BPM）

设置步进（每遍 1–20 BPM）和上限：每循环一遍速度上升，实时显示。示例：4 个难音 + 60 BPM + 步进 4 + 上限 120 → 无需操作约 15 遍逐步加速。

7. 旋律生成器 🎼

音乐上连贯的旋律：按把位分组的音阶 — 大调与大调五声（第 1）；布鲁斯、混合利底亚、五声（第 2）；小调五声、布鲁斯、多利亚（第 3）；自然小调、小调五声（第 4）；弗里几亚、小调五声、含压音的自然小调（第 5）；利底亚、含压音的大调（第 12）。四个级别（初级 4–6 孔 → 专家 含超吹），1、2 或 4 小节。除非勾选"不以主音结束"，否则旋律结束于主音。窗口保持打开：可循环重新生成（🎼）、试听、调整，同时不失去对应用的操作；用 ✕ 或取消关闭。Ctrl+Z 恢复。练习思路：中级 + 第 2 把位布鲁斯 + 1 小节 + 循环 + 渐进速度。

一键生成（适合初学者）。 生成器顶部有按心情命名的意图按钮 — "简单布鲁斯""欢快旋律""流行/摇滚即兴""忧郁一点的""随便来一个" — 会替你设置好菜单（你能看到它们变化）并立即生成：一键一曲。再次点击即换一条。详细设置仍在下方，方便想精确选择音阶、把位和难度的人。

读谱并吹奏所生成的内容。 记谱法提示“📖 如何读谱？”（吹、吸、压音、配色）可在“编辑”菜单的帮助 ? 中查看。一旦有音符，谱子下方就会出现一排图标：▶（红）播放谱子、⏹（绿）停止、麦克风图标（蓝）启动 🎯 模式（对着麦克风吹奏，应用逐音判定），+ 添加或插入音符（在所选音符之后，否则在末尾）并打开编辑器；再次点击可继续添加，小节线会自动重新计算。

拍号与时值。选择拍号 — 4/4 或 3/4（华尔兹）：整个应用都会跟随（小节线、节拍器、MIDI 和 MusicXML 导出）。还可限制所用的音符时值，只勾选四分、八分、十六分或三连音 — 例如只用三连音，或只用四分和八分音符的旋律（全部勾选＝自由）。

我的调式 🧬（可折叠模块）：创建自己的调式 — 名称、把位（第1至第12）、在12个半音中勾选级数 — 保存在浏览器中，并（★）出现在生成器、1·3b·5 级数和摇摆计的音阶选择器里。✎ 编辑调式，🗑 删除。

在生成器窗口中，音阶选择器旁：🗑 将当前音阶从列表移除（选择会被记住），↺ 重新显示所有音阶；⬇ 将您的调式导出为 .json 文件，📂 重新导入。

7 bis. 和弦与进行 🎶

🎶 和弦构建器（练习组）：选择根音、和弦性质（从三和弦到13和弦共23种）、变化音与张力音（b5, #5, b9, #9, #11, b13 — 按性质启用）、可选低音以及形态（上行或上行下行）。添加将和弦以琶音插入 — 最低可演奏把位，含超吹/超吸 — 窗口保持打开以便连续添加；删除上一个撤销最近添加的和弦。

每小节和弦数：4/4 为 1、2 或 4；3/4 为 1 或 3；6/8 和 12/8 为 1 或 2 — 时值会精确填满所选份额。和弦名称以徽章显示在其行首，🔀 和 🎲 都在每个和弦内部生效，不破坏小节。 播放时，🎹 按钮（播放组）可切换为柱式和弦：每个和弦在拍点上以钢琴音色整体奏出，而非琶音。

♬ 和弦进行（练习组的可移动窗口）：19 种经典进行（流行、爵士、12小节布鲁斯、小调终止式…），可移调至 12 个调，含和弦预览。插入按每小节一个和弦放置进行；一次 Ctrl+Z 即可全部撤销。 插入前可编辑进行：点击和弦更改根音、性质、张力音（b5, b9, #11…）和低音；◀ ▶ 移动，✕ 删除，+ 添加。可在名称／级数（罗马数字）之间切换显示，💾 可将您的进行保存到预设列表（★，🗑 删除）；⬇ 可将您的进行导出为 .json，📂 重新导入。

8. 精细编辑

点击 = 选中（新音符插入其后）；⌫/Delete 删除；←/→ 移动选区。自动显示带编号的小节线（4/4 或 3/4，取决于生成器中选择的拍号）；计数器显示元素数和小节数。

双击音符打开完整编辑器：更改孔位（1–10）、技法（仅提供该孔实际可演奏的音，按颜色区分）、时值与附点，将音符转为休止符（或反之），或删除。

⚠ 补全小节：当最后一个小节不完整时，此按钮会出现在谱子上方。应用会在当前音阶内提供三种可能的结尾 — 选择其一，音符即被添加，小节恰好补满。

调号。导出的调号是自动的：它根据生成旋律的把位，按其主音（大调或小调）确定——例如 C 调口琴第三把位的小调五声音阶为 D 小调（一个降号），而非口琴本身的调号。若未生成旋律，则为口琴的大调。它会写入 MusicXML 的第一小节（含调式）和 MIDI 文件——这样 MuseScore 显示的乐谱干净整洁。

8-b. 听音训练 🎧（测试版）

调音器下方：选择 1 至 6 个音和级别 — 初级（4–6 孔）、中级（自然音）、高级（含压音，不含超吹超吸）、专家（全部包含）。🎲 以当前调性播放一个可唱的乐句（音程不超过五度、不重复）。▶ 再听一遍不限次数；🎤 用麦克风作答：每个正确音填入其格，错误音闪红并计一次错误。显示答案给出解答。绝不会写入你的谱子。

得分、统计与徽章。 每次成功听音获得得分＝音数 × 级别 × 100，每次错误 −20，第一次之后每次重播 −5。模块下方：练习次数、全对、纪录、累计、当前连胜（用 ↺ 重置）。七枚徽章 — 青铜／白银／黄金之耳（10/50/100 次）、顺畅与绝对音感（连续 5 和 10 次全对）、大师（专家级全对一次）、气息大师（单次超过 1000 分）。全部保存在浏览器中，离线可用。

9. 键盘快捷键

10. 录音 🎙（测试版）

命名文件，选择麦克风（默认系统），⏺ 然后 ⏹：出现播放器，⬇ 下载，🗑 清除 删除录音。单声道 webm/opus（约 1 MB/分钟），各处皆可播放。提示：循环播放谱子＋录音，跟着吹，再对比。

10 bis. 跟着视频练习 🎯（测试版）

上一模块的逆向：从伴奏开始，应用会推荐可在其上练习的把位。从下拉列表中选择你的曲目（你的视频在前，然后是曲库）— 调性、调式、风格和速度会自动填入，并显示视频。或者，对于任意视频，粘贴其 YouTube 链接并手动填写它的调性、调式、风格和速度；应用随即推荐两个与之匹配的你的伴奏。对于列出的每个把位（口琴＋音阶），都有一个按钮可载入口琴并立即在该把位和调性生成一条练习。选择伴奏会把🎼 生成器预设到第一个把位、1 小节。

11. 音符识别 🎤（测试版）

🎤 开始监听，吹一个持续音：应用显示音名、对应的谱子孔（按所选调性以技法配色）以及你的音准（±50 音分）。

"将音符写入谱子"：以真实时值自动记谱，按起音到起音测量 — 断奏的四分音符仍是四分音符（衔接间隙若小于音程的约 40% 则被吸收；超过则记为真正的休止符；超过 4 拍视为换气，不记任何内容）。过早松开的最后一个音会向上取整到较大的整值。停止时，节奏自动重新校准：估算真实速度、重新量化时值、设定速度。可选节拍器对齐网格。一次 Ctrl+Z 撤销整个会话。

用途：在仪表上检查压音、确认超吹、记录乐句，谱子自动生成。

📈 实时演奏轨迹

随调音器一同展开（点击标题折叠，🗑 清除）。上方为五线谱（高音谱号）：每个音放在演奏的精确时刻，与图表对齐；点击五线谱会将该音的读数发送到调音器。下方为滚动图表（8 秒）：你的音高以虚线显示（绿 ±5 音分、橙 ±15、更大为红），半音线标注可演奏音的谱子，按技法配色。纵轴刻度固定：线间距保持不变，画面只是重新居中到所奏的音。

导航：点击 = 聚焦，←/→ ±1 秒（Shift：5 秒）、滚轮、点击拖动；悬停时滚动冻结（⏸ 标记），垂直光标显示精确读数（谱子、音名、音分）；End/Esc 回到实时。⏸ 冻结按钮可稳定停止滚动，无需一直把鼠标放在上面即可查看曲线；▶ 恢复回到实时。约 5 分钟历史。

🎚 半音阶调音器

±50 音分表盘：绿区 ±5（准），橙区至 ±15，更大为红。平滑指针，随所瞄准区域变色的音名色块（绿／橙）、谱子对应、频率。"准 ✓"仅在绿区显示。停止时显示冻结（🗑 重置），模块随轨迹一同折叠。限于所选口琴的音域。

🎯 训练模式：适合练习某个特定的压音。勾选此模式，从列表中选择一个目标音 — 仅含压音、超吹和超吸（需要练习的音）。指针仍指示最近的音（绝不会卡到底），而文字判断以目标为基准："还不够低 ↓""偏高 ↓"，达到时显示"准 ✓"。判断仅在训练模式出现，且"准"还要求指针处于绿色区域。

标准音 A 校准（440 Hz，▲▼，415–466）：许多口琴定在 442–443 Hz。全局且记忆的设置：调音器、识别、播放共用同一基准。请先校准 A。

🎯 演奏谱子 — 带批改的练习

期待的音蓝色闪烁；按自己的节奏对麦克风演奏：正确 → 绿，下一个；错误 → 红，重来。最终报告：通过的音、错误、平均音准（音分）。适用于任何谱子 — 配合生成器：每次都有新的带批改的练习。

测试版限制

• 一次一个音（不支持和弦或分裂八度）。
• 吹奏清晰；最短保持时间随速度变化；判定在 ±40 音分内（过于随意的压音不会记谱）。
• 同一个音两次：请明显断开。音与音之间的休止不记谱。
• 将应用调性设为你口琴的调性；安静的环境更有帮助。

11 bis. 摇摆感测量 🎵 (测试版)

摇摆感测量会在你吹奏八分音符时，通过麦克风测量你的摇摆比例：50%＝平直（二连），66.7%＝三连（摇摆）。它基于你每次起音之间的间隔，因此不受音频延迟影响。一个刻度表和明确的判定——平直目标为 PLACEMENT OK，三连目标为 SWING OK——实时显示你是否达标，停止吹奏后信息仍会保留。选择目标（平直 50% 或三连 66.7%），设置速度（与工具栏同步），也可让模块在所选音阶中生成一段练习（2、4、6 或 8 个八分音符）——或选“自由”随意吹奏。🗑 可重置该模块。

12. 导出

13. 常见问题

• 首次点击无声（iPhone/iPad）：浏览器在首次操作时解锁音频 — 点击一个音即可。
• 换调后我的音变了？ 谱子从不改变；只有音名和音高随之变化 — 就像换一把口琴。
• 会话不见了：自动保存属于本浏览器（隐私模式和清理数据会清除它）— 请导出为 .json。
• 离线可用？ 是的，完全可以：自包含文件。
• 导入的 MIDI 缺音：在所选调性下无法演奏的音会被列出；应用会建议最佳调性。
• 导入时超吹被拒绝：标准 Richter 口琴只有超吹 1、4、5、6 和超吸 7、9、10。
• "超出口琴"：检测到的音在所选调性中不存在 — 请检查设置。
• ⟳ 与部分循环的区别：⟳ 重复正在播放的内容；若有范围（Shift+点击），仅该乐段。

14. 效果记号与文本导出

✨ 音符上的效果记号

在音符编辑器中（双击音符），可以添加效果记号，它们不影响节奏或时值，仅用于标注演奏意图。

先选择位置（音符之前或之后），再点击所需的记号。同一个音符可以带多个效果，在前和/或在后；每个都相互独立。

滑音和颤音不会被应用的声音重现。记号显示在谱子上（橙色，围绕音符）。

导出时：在文本（.txt）中，每个记号是独立的元素（如 DS TBS +4 vib Wa）；在 MusicXML 中，每个效果会成为独立的 lyric，在 MuseScore 中显示在音符下方。

📝 文本导出（.txt）

TXT 按钮（文件组）将谱子连同效果记号导出为纯文本，以谱子名称命名。

Aplicativo web para criar, ouvir e praticar tablaturas de gaita diatônica de 10 furos. Um único arquivo, sem instalação, sem conexão: abra harmonica-trainer.html no seu navegador. A interface existe em sete idiomas (botões de idioma no rodapé do app, escolha memorizada — este manual segue o mesmo ajuste).

1. Primeiros passos

No topo, uma faixa rolante apresenta os conteúdos de apprendrelharmonica.com; pausa ao passar o mouse, um clique abre a página. O logotipo, embaixo, também assina as tablaturas impressas.

• Clique nas notas da gaita virtual: cada clique toca a nota e a adiciona à tablatura.
• ▶ (ou Espaço) para ouvir. Tablatura vazia? O botão "Tente: …" propõe um lick de blues de um compasso, diferente a cada vez.
• 💾 Salvamento automático no navegador: feche, volte amanhã, sua sessão é restaurada.
• 📂 A maioria dos módulos abre e fecha com um clique no título; o esquema da gaita e « Minha tablatura » permanecem sempre abertos.
• 🔀 Organize os módulos do seu jeito: arraste-os pela alça ⠿ (eles se imantam às colunas); a barra « Layout » salva e recupera várias disposições (↺ restaura a disposição original). Tudo fica salvo no navegador.

1 bis. Layout personalizado 🔀

Organize os módulos do seu jeito: arraste cada cartão pela alça ⠿ — eles se encaixam nas colunas. A barra "Layout" salva várias disposições nomeadas e as recupera por um menu; ↺ volta ao layout original, e 💾 exporta seus layouts para um arquivo reimportável. Tudo é guardado no navegador, específico deste dispositivo.

2. A notação

Código de cores em todo o app: soprado · aspirado · bend · overblow · overdraw.

3. A gaita virtual

A tonalidade aparece acima do esquema. Cada coluna alinha, de cima para baixo: overblows, bends soprados, nota soprada, nota aspirada, bends aspirados, overdraws. Clicar no número de um furo adiciona a nota soprada; passar o mouse sobre uma coluna a destaca. Os nomes seguem a tonalidade e a oitava escolhidas.

4. A barra de ferramentas

🎵 Reprodução

• ▶/⏹ (Espaço), ⟳ loop sem cortes — o campo ×N ao lado define um número de repetições (toca N vezes e para; vazio = infinito). Andamento 40–240, 🔊 Volume, ⏱ Metrônomo (acento conforme o compasso: a cada 4 ou 3 tempos).
• TAP: clique no ritmo (mouse) para definir o andamento — média dos últimos cliques, aplicada ao andamento geral; RESET apaga os cliques.
• PEDAL: nota sustentada (12 opções, oitava grave) para trabalhar afinação e posições. Desligue-o durante o reconhecimento de notas.

Durante a reprodução, a nota atual acende na tablatura e na gaita.

🏋️ Exercícios

• 🎼 Gerador (§ 7) · 🔀 Embaralhar a tablatura (uma vez por clique, Ctrl+Z para voltar) · ⇅ ascendente e depois descendente · SWING (colcheias ternárias) · 🎲 Durações aleatórias · +BPM andamento progressivo (§ 6). Os modos se combinam.

🎼 Tablatura

• TAB / Notes / Do Ré Mi: tablatura, nomes anglo-saxões (C4, Bb3…) ou latinos (Dó4, Sib3…).
• Tonalidade (12 gaitas): nomes e altura se adaptam, a tablatura não muda.
• ▾8 / ▴8: transpõe as notas selecionadas uma oitava (ou toda a tablatura se nada estiver selecionado; furos equivalentes). Se uma nota não tiver equivalente, nada muda e elas são listadas. Seleção: Shift+clique um intervalo, Ctrl/Cmd+clique notas avulsas, ⇄ Inverter troca selecionadas e não selecionadas.
• 1·3b·5 Graus (grupo Tablatura): mostra sob cada nota o seu grau na escala de referência — o botão 🎼 ao lado abre o gerador para escolher a escala, e a vista alinha-se automaticamente com ela. As notas fora da escala ficam acinzentadas; os arpejos do construtor de acordes mostram os intervalos do acorde (1, 3b, 5, 7b…).

📁 Arquivo

• 📚 Biblioteca: tablaturas nomeadas neste navegador — carregar, renomear, excluir; ⬇ Exportar tudo em .json reimportável. As janelas se arrastam pela barra de título.
• 💾 / 📂: arquivo .json completo; 📂 também abre .mid (conversão em tablatura: durações quantizadas, pausas reconstruídas, andamento aplicado, notas não tocáveis listadas, melhor tonalidade sugerida) e .xml/.musicxml.
• 📋 Importar texto (§ 5) · 🎹 MIDI (GM Harmonica) · XML MusicXML: partitura exata — figuras e durações sempre coincidem, compassos completos, ligaduras escritas; o MuseScore não reescreve nada.
• 🖨 Imprimir: layout limpo, fundo branco, logotipo, 12 notas por linha (PDF via "Imprimir em PDF").

✏️ Edição & ♩ Durações

↶/↷ (Ctrl+Z / Ctrl+Y), 🗑 apagar tudo, ? ajuda. Nove valores: semibreve, mínima, semínima, colcheia, semicolcheia, tercina, ponto (+50%), e três pausas (1, ½, ¼ tempo). A duração escolhida aplica-se às próximas notas; com uma seleção, modifica-a diretamente.

Notas que cruzam a barra de compasso: divididas na tela e unidas por ‿ (parte ligada pontilhada) — a nota continua sendo uma só, tocada num sopro; a exportação MusicXML escreve a ligadura.

‿ Ligadura (grupo Edição): liga as notas selecionadas — o sinal ‿ aparece entre elas. Duas notas ligadas da mesma altura são tocadas num só sopro, sem reataque, e a exportação MusicXML escreve a ligadura. O botão ‿ do editor (duplo clique) faz o mesmo nota a nota.

5. Importar uma tablatura de texto 📋

Cole suas tablaturas (notas separadas por espaços; vírgulas, quebras e | aceitos): +4 -4 +5 -5 +6 -6' -6 z +6 -5 +5 -4 +4. O + é opcional, z insere uma pausa, elementos inválidos são ignorados e listados, a importação é acrescentada ao final.

6. Trabalhar uma passagem

Loop parcial

Clique na primeira nota, Shift+clique na última: o intervalo é destacado, ▶ toca só ele, ⟳ o repete. Um clique sem Shift sai. O intervalo também permite mudar todas as durações ou excluir de uma vez.

Andamento progressivo (+BPM)

Defina o passo (1–20 BPM por volta) e o máximo: a cada loop o andamento sobe, exibido ao vivo. Exemplo: 4 notas difíceis + 60 BPM + passo 4 + máx. 120 → ~15 voltas sem mexer em nada.

7. Gerador de melodias 🎼

Melodias coerentes: escalas 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 (Iniciante furos 4–6 → Expert com overblows), 1, 2 ou 4 compassos. A melodia termina na tônica, salvo se marcar "Não terminar na tônica". A janela permanece aberta: regenere em loop (🎼), ouça, ajuste, sem perder o controle do app; feche com ✕ ou Cancelar. Ctrl+Z restaura. Ideia de sessão: Intermediário + blues 2ª posição + 1 compasso + loop + andamento progressivo.

Um clique (iniciantes). No topo do gerador, botões de intenção nomeados por clima — "Um blues fácil", "Uma melodia alegre", "Um riff pop/rock", "Algo melancólico", "Surpreenda-me" — ajustam os menus por você (você os vê mexer) e geram na hora: um clique, uma melodia. Clique de novo para outro sorteio. Os ajustes detalhados ficam abaixo para quem quiser escolher escala, posição e nível com precisão.

Ler e tocar o que é gerado. O lembrete de notação "📖 Como ler a tablatura?" (soprar, aspirar, bends, código de cor) está disponível na ajuda ? do menu Edição. Assim que há notas, aparece abaixo da tablatura uma fileira de ícones: ▶ (vermelho) toca a tablatura, ⏹ (verde) para, o ícone de microfone (azul) abre o modo 🎯 (você toca no microfone e o app valida nota por nota) e + adiciona ou insere uma nota — após a nota selecionada, senão no fim — abrindo o editor; clique de novo para adicionar mais, as barras de compasso são recalculadas.

Compasso e durações. Escolha o compasso — 4/4 ou 3/4 (valsa): todo o app acompanha (barras de compasso, metrônomo, exportações MIDI e MusicXML). E restrinja as durações das notas usadas marcando apenas semínima, colcheia, semicolcheia ou tercina — por exemplo uma melodia só de tercinas, ou de semínimas e colcheias (tudo marcado = livre).

Os meus modos 🧬 (módulo dobrável): crie os seus próprios modos — nome, posição (1ª a 12ª), graus marcados entre os 12 meios-tons — memorizados no navegador e disponíveis (★) nos seletores de escalas do gerador, dos graus 1·3b·5 e do Swing-metro. ✎ edita um modo, 🗑 apaga-o.

Na janela do gerador, ao lado do seletor de escalas: 🗑 remove a escala mostrada da lista (escolha memorizada), ↺ volta a mostrar todas; ⬇ exporta os seus modos num ficheiro .json e 📂 reimporta-os.

7 bis. Acordes e progressões 🎶

🎶 Construtor de acordes (grupo Exercícios): escolha a fundamental, a qualidade (23, de tríades a 13as), as alterações/tensões (b5, #5, b9, #9, #11, b13 — ativas conforme a qualidade), uma nota de baixo opcional e a forma (ascendente ou sobe e desce). Adicionar insere o acorde em arpejo — posição mais grave tocável, overblows/overdraws incluídos — e a janela fica aberta para encadear; Remover o último apaga o último acorde adicionado.

Acordes por compasso: 1, 2 ou 4 em 4/4; 1 ou 3 em 3/4; 1 ou 2 em 6/8 e 12/8 — as durações repartem-se para preencher exatamente a parte escolhida. O nome do acorde aparece como selo no início da sua linha, e tanto 🔀 como 🎲 atuam dentro de cada acorde sem quebrar os compassos. Na leitura, o botão 🎹 (grupo Leitura) muda para acordes em bloco: cada acorde soa em bloco no tempo, com som de piano, em vez do arpejo.

♬ Progressões de acordes (janela móvel do grupo Exercícios): 19 progressões clássicas (pop, jazz, blues de 12 compassos, cadências menores…), transponíveis para as 12 tonalidades, com pré-visualização dos acordes. Inserir coloca a progressão um acorde por compasso; um único Ctrl+Z anula tudo. A progressão é editável antes de inserir: clique num acorde para mudar fundamental, qualidade, tensões (b5, b9, #11…) e nota do baixo; ◀ ▶ movem-no, ✕ remove-o, + adiciona um. Alterne a vista Nomes / Graus (números romanos), e 💾 guarda a sua progressão na lista de presets (★, 🗑 para a apagar); ⬇ exporta as suas progressões em .json e 📂 reimporta-as.

8. Edição fina

Clique = seleção (as novas notas são inseridas depois); ⌫/Del exclui; ←/→ move a seleção. Barras de compasso automáticas numeradas (4/4 ou 3/4 conforme o compasso escolhido no gerador); o contador indica elementos e compassos.

Duplo clique numa nota abre um editor completo: mudar o furo (1–10), a técnica (apenas as notas realmente tocáveis nesse furo, com sua cor), o valor e o ponto, converter a nota em pausa (e vice-versa) ou excluí-la.

⚠ Completar o compasso: quando o último compasso está incompleto, este botão aparece acima da tablatura. A app propõe três finais possíveis na escala atual — escolha um, as notas são adicionadas e o compasso fica exato.

Armadura de clave. A armadura das exportações é automática: segue a tônica da melodia gerada conforme a sua posição, em maior ou menor — assim, uma pentatônica menor na 3ª posição numa gaita em C dá Ré menor (um bemol), e não a armadura 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.

8-b. Ditado musical 🎧 (beta)

Abaixo do afinador: escolha de 1 a 6 notas e o nível — Iniciante (furos 4–6), Intermediário (notas naturais), Avançado (bends, sem overnotes), Expert (tudo incluído). 🎲 toca uma frase cantável (intervalos ≤ quinta, sem repetição) na tonalidade atual. ▶ Ouvir de novo sem limite; 🎤 Responder ao microfone: cada nota correta preenche sua casa, uma errada pisca em vermelho e conta um erro. Revelar mostra a solução. Nunca escreve na sua tablatura.

Pontuação, estatísticas e insígnias. Cada ditado concluído dá uma pontuação = notas × nível × 100, menos 20 por erro e 5 por reescuta após a primeira. Abaixo do módulo: ditados jogados, sem erro, recorde, total e sequência atual (redefinir com ↺). Sete insígnias — Ouvido de bronze/prata/ouro (10/50/100 ditados), Sem tropeços e Ouvido absoluto (5 e 10 sem erro seguidos), Virtuoso (um ditado Expert sem erro), Mestre do sopro (mais de 1000 pontos). Tudo guardado no navegador, offline.

9. Atalhos de teclado

10. Gravação de áudio 🎙 (beta)

Nomeie o arquivo, escolha o microfone (sistema por padrão), ⏺ depois ⏹: aparece um player, ⬇ baixa, 🗑 Limpar apaga a gravação. Mono webm/opus (≈ 1 MB/min), reproduzível em qualquer lugar. Dica: loop da tablatura + gravação, toque por cima, compare.

10 bis. Exercícios a partir de um vídeo 🎯 (beta)

O módulo inverso do anterior: parta de um backing track e o app propõe as posições para trabalhar por cima. Escolha um dos seus temas na lista suspensa (os seus vídeos primeiro, depois a biblioteca) — tonalidade, modo, estilo e andamento preenchem-se sozinhos e o vídeo aparece. Ou, para um vídeo qualquer, cole o link do YouTube e indique à mão a sua tonalidade, o seu modo, o seu estilo e o seu andamento; o app propõe então dois backing tracks seus correspondentes. Para cada posição listada (gaita + escala), um botão carrega a gaita e gera logo um exercício nessa posição e tonalidade. Escolher um backing track pré-configura o gerador 🎼 na primeira posição, em 1 compasso.

11. Reconhecimento de notas 🎤 (beta)

🎤 Começar a ouvir, toque uma nota sustentada: o app mostra a nota, seu furo na tablatura (cor da técnica, conforme a tonalidade escolhida) e sua afinação (±50 cents).

"Escrever as notas na tablatura": transcrição automática com o valor rítmico real, medido de ataque a ataque — uma semínima destacada continua semínima (as lacunas de articulação abaixo de ~40% do intervalo são absorvidas; além disso, uma pausa musical real é escrita; acima de 4 tempos é uma respiração, nada é escrito). A última nota solta cedo é arredondada para o valor cheio superior. Ao parar, o ritmo é reajustado automaticamente: andamento real estimado, durações requantizadas, Andamento ajustado. Metrônomo opcional na grade. Um único Ctrl+Z desfaz a sessão.

Usos: verificar um bend no medidor, confirmar um overblow, transcrever um riff que se escreve sozinho.

📈 Traçado do toque ao vivo

Abre-se com o afinador (dobrável no título, 🗑 para limpar). Em cima, a pauta (clave de sol): cada nota colocada no instante exato em que foi tocada, alinhada com o gráfico; um clique na pauta envia a leitura dessa nota ao afinador. Embaixo, o gráfico rolante (8 s): sua altura em linhas pontilhadas (verde ±5 cents, laranja ±15, vermelho além), linhas de semitons com a tablatura das notas tocáveis, cor por técnica. A escala vertical é fixa: o espaçamento das linhas permanece constante, o quadro apenas recentra na nota tocada.

Navegação: clique = foco, ←/→ ±1 s (Shift: 5 s), roda, clicar e arrastar; a rolagem congela ao passar o mouse (selo ⏸), cursor vertical com leitura precisa (tablatura, nota, cents); End/Esc voltam ao ao vivo. O botão ⏸ Congelar para a rolagem de forma estável para examinar a curva sem manter o mouse em cima; ▶ Retomar volta ao ao vivo. ~5 minutos de histórico.

🎚 Afinador cromático

Mostrador ±50 cents: zona verde ±5 (afinado), laranja até ±15, vermelho além. Ponteiro suavizado, uma pastilha de nota que assume a cor da zona visada (verde/laranja), equivalente em tablatura, frequência. A palavra AFINADO ✓ aparece só na zona verde. Ao parar, o visor congela (🗑 para zerar) e o módulo se dobra junto com o traçado. Limitado à tessitura da gaita selecionada.

🎯 Modo 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). O ponteiro continua a indicar a nota mais próxima (nunca trava), enquanto o veredito por extenso se mede em relação ao alvo: "FALTA DESCER ↓", "MUITO ALTO ↓" e "AFINADO ✓" quando você o atinge. O veredito só existe no modo treino, e "afinado" exige também o ponteiro na zona verde.

Calibração do Lá (440 Hz, ▲▼, 415–466): muitas gaitas estão em 442–443 Hz. Ajuste global e memorizado: afinador, reconhecimento e reprodução no mesmo diapasão. Calibre primeiro o Lá.

🎯 Tocar a tablatura — prática validada

A nota esperada pisca em azul; toque-a ao microfone no seu ritmo: certa → verde, próxima; errada → vermelho, repete. Relatório final: notas validadas, erros, afinação média em cents. Funciona com qualquer tablatura — com o gerador: um novo exercício corrigido a cada sessão.

Limites da beta

• Uma nota por vez (sem acordes ou oitavas em split).
• Ataques nítidos; duração mínima adaptada ao andamento; validação em ±40 cents (um bend impreciso não é transcrito).
• Duas vezes a mesma nota: separe-as claramente. As pausas entre notas não são transcritas.
• Ajuste a tonalidade do app à da sua gaita; um ambiente silencioso ajuda.

11 bis. Medidor de swing 🎵 (beta)

O medidor de swing mede pelo microfone a sua proporção de swing enquanto você toca colcheias: 50% = reto (binário), 66,7% = tercina (swing). Baseia-se nos intervalos entre os seus ataques, o que o torna imune à latência de áudio. Um medidor e um veredito claro — PLACEMENT OK para um alvo reto, SWING OK para um alvo de tercina — mostram ao vivo se você está no alvo, e a mensagem permanece quando você para. Escolha o alvo (Reto 50% ou Tercina 66,7%), ajuste o andamento (sincronizado com a barra de ferramentas) e, se quiser, deixe o módulo gerar um exercício de colcheias (2, 4, 6 ou 8) na escala escolhida — ou "livre" para tocar o que quiser. 🗑 reinicia o módulo.

12. Exportações

13. Perguntas frequentes

• Sem som no primeiro clique (iPhone/iPad): os navegadores desbloqueiam o áudio no primeiro gesto — clique numa nota.
• Mudar de tonalidade mudou minhas notas? A tablatura nunca muda; só os nomes e a altura seguem — como trocar de gaita.
• Sessão sumiu: o salvamento pertence a este navegador (navegação privada e limpeza de dados o apagam) — exporte em .json.
• Offline? Sim, totalmente: arquivo autônomo.
• MIDI importado com notas faltando: as notas não tocáveis na tonalidade escolhida são listadas; o app sugere a melhor tonalidade.
• Overblows recusados na importação: num Richter padrão só existem os overblows 1, 4, 5, 6 e os overdraws 7, 9, 10.
• "Fora da gaita": a nota detectada não existe na tonalidade selecionada — verifique o ajuste.
• ⟳ vs loop parcial: ⟳ repete o que está tocando; com um intervalo (Shift+clique), apenas a passagem.

14. Sinais de efeito e exportação de texto

✨ Sinais de efeito numa nota

No editor de notas (duplo clique numa nota), você pode adicionar sinais de efeito que não afetam o ritmo nem 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(s) Sinal(is) desejado(s). Uma mesma nota pode ter vários efeitos, antes e/ou depois; cada um permanece independente.

O glissando e o trinado não são reproduzidos pelo som do app. Os sinais aparecem na tablatura (em laranja, ao redor da nota).

Na exportação: em texto (.txt), cada sinal é um elemento separado (ex.: DS TBS +4 vib Wa); em MusicXML, cada efeito vira um lyric independente exibido abaixo da nota no MuseScore.

📝 Exportação de texto (.txt)

O botão TXT (grupo Arquivo) baixa a tablatura como texto puro, com os sinais de efeito, com o nome da tablatura.