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.

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, Tempo 40–240, 🔊 Volume, ⏱ Métronome (temps fort toutes les 4 pulsations).
• BOURDON : note tenue (12 choix, octave grave) pour travailler justesse et positions. À couper pendant la reconnaissance de notes.
• ACCOMP : accompagnement piano — une progression d'accords de 4 mesures en boucle, dans la tonalité déduite de la mélodie générée. Quatre styles avec de vrais patrons de jeu (pas des accords plaqués) : Country/Folk (basse-accord), Blues (shuffle, basse qui marche), Jazz (accords syncopés aérés), Ballade mélancolique (accords tenus + arpège). Calé sur le tempo et le swing de l'appli ; jouez votre mélodie ou improvisez par-dessus. Casque conseillé pendant la reconnaissance de notes.

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

🏋️ Exercices

• 🎼 Générateur de mélodies (§ 8) · 🔀 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 toute la tablature d'une octave (trous équivalents). Si des notes n'ont pas d'équivalent, rien ne bouge et l'appli les liste.

📁 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.
• Accords à l'export : si vous avez activé l'ACCOMP au moins une fois, la grille d'accords est ajoutée aux exports — au-dessus des mesures à l'impression/PDF, comme symboles d'accord au-dessus de la portée en MusicXML, et comme piste d'accompagnement dédiée en MIDI.
• 🖨 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.

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. Liens de partage (anciens)

Le bouton de partage a été retiré ; les liens …#t=… déjà envoyés continuent de charger leur tablature. Utilisez désormais 💾 .json ou MIDI/XML.

8. 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é. Sous la tablature, un dépliant « 📖 Comment lire la tablature ? » rappelle en continu la notation (+4 souffler, -4 aspirer, les altérations, le code couleur). Et un bouton « 🎯 Essaie de la jouer ! » lance directement le mode 🎯 sur la mélodie affichée : vous la jouez au micro, l'appli valide note à note.

9. Édition fine

Clic = sélection (les nouvelles notes s'insèrent après) ; ⌫/Suppr supprime ; ←/→ déplace la sélection. Barres de mesure 4/4 automatiques avec numéro ; 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.

Armure de tonalité. À côté du titre « Ma tablature », un sélecteur fixe l'armure écrite dans les exports : Auto (déduite de l'harmonica, ou de la gamme générée) ou une tonique précise (les 12 tonalités d'harmonica) en majeur ou mineur, indépendamment de la tonalité de l'harmonica. Cette armure apparaît dans la première mesure du MusicXML (avec le mode) et dans le fichier MIDI — MuseScore affiche alors une partition propre, sans altérations superflues.

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

10. Raccourcis clavier

Claviers AZERTY et QWERTY.

11. Enregistrement audio 🎙 (bêta)

Nommez le fichier, choisissez le micro (système par défaut), ⏺ puis ⏹ : un lecteur apparaît, ⬇ télécharge. Format webm/opus mono (≈ 1 Mo/min), lisible partout. Astuce : lecture en boucle + enregistrement, jouez par-dessus, comparez.

12. 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, lecture et bourdon 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é.

13. Exports

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

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.

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, Tempo 40–240, 🔊 Volume, ⏱ Metronome (accent every 4 beats).
• DRONE: a sustained note (12 choices, low octave) to work on intonation and positions. Turn it off during note recognition.
• ACCOMP: piano accompaniment — a looping 4-bar chord progression, in the key inferred from the generated melody. Four styles with real playing patterns (not block chords): Country/Folk, Blues (shuffle, walking bass), Jazz (airy syncopated chords), Melancholic ballad (held chords + arpeggio). Locked to the app's tempo and swing; play your melody or improvise over it. Starting playback starts the accompaniment, and vice versa. Headphones recommended during note recognition.
• Chords on export: if you have switched ACCOMP on at least once, the chord grid is added to exports — above the measures when printing/PDF, as chord symbols above the staff in MusicXML, and as a dedicated accompaniment track in MIDI.

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

🏋️ Practice

• 🎼 Generator (§ 8) · 🔀 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 whole tab one octave (equivalent holes). If some notes have no equivalent, nothing changes and they are listed.

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

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. Share links (legacy)

The share button has been removed; previously sent …#t=… links still load their tab. Use 💾 .json or MIDI/XML instead.

8. 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. Below the tab, a "📖 How to read the tab?" drop-down keeps the notation in view (+4 blow, -4 draw, bends, colour code). And a "🎯 Try playing it!" button launches 🎯 mode straight on the displayed melody: you play it into the mic, the app validates note by note.

9. Fine editing

Click = select (new notes are inserted after it); ⌫/Del deletes; ←/→ moves the selection. Automatic 4/4 barlines with numbers; 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.

Key signature. Next to the "My tab" title, a selector sets the key signature written in exports: Auto (inferred from the harmonica, or the generated scale) or a specific tonic (the 12 harmonica keys) in major or minor, independently of the harmonica's key. This signature appears in the first measure of the MusicXML (with the mode) and in the MIDI file — MuseScore then shows a clean score, free of needless accidentals.

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

10. Keyboard shortcuts

11. Audio recording 🎙 (beta)

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

12. 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, playback and drone 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.

13. Exports

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

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.

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, Tempo 40–240, 🔊 Lautstärke, ⏱ Metronom (Akzent alle 4 Schläge).
• BORDUN: gehaltener Ton (12 Auswahl, tiefe Oktave) für Intonation und Positionen. Bei der Tonerkennung ausschalten.
• ACCOMP: Klavierbegleitung — eine loopende 4-Takt-Akkordfolge in der aus der erzeugten Melodie abgeleiteten Tonart. Vier Stile mit echten Spielmustern (keine plattgedrückten Akkorde): Country/Folk, Blues (Shuffle, laufender Bass), Jazz (luftige synkopierte Akkorde), Melancholische Ballade (gehaltene Akkorde + Arpeggio). An Tempo und Swing der App gekoppelt; spielen Sie Ihre Melodie oder improvisieren Sie darüber. Die Wiedergabe startet die Begleitung und umgekehrt. Bei der Tonerkennung Kopfhörer empfohlen.
• Akkorde beim Export: Wenn Sie ACCOMP mindestens einmal eingeschaltet haben, wird das Akkordraster den Exporten hinzugefügt — über den Takten beim Druck/PDF, als Akkordsymbole über dem System in MusicXML und als eigene Begleitspur im MIDI.

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

🏋️ Übungen

• 🎼 Generator (§ 8) · 🔀 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 ganze Tabulatur um eine Oktave (äquivalente Kanäle). Fehlen Äquivalente, ändert sich nichts und sie werden aufgelistet.

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

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. Teilen-Links (alt)

Der Teilen-Knopf wurde entfernt; bereits verschickte …#t=…-Links laden weiterhin ihre Tabulatur. Nutzen Sie nun 💾 .json oder MIDI/XML.

8. 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. Unter der Tabulatur hält ein Ausklapp-Bereich „📖 Wie liest man die Tabulatur?“ die Notation im Blick (+4 blasen, -4 ziehen, Bendings, Farbcode). Und eine Schaltfläche „🎯 Versuch, sie zu spielen!“ startet den 🎯-Modus direkt auf der angezeigten Melodie: Sie spielen sie ins Mikro, die App prüft Ton für Ton.

9. Feinbearbeitung

Klick = Auswahl (neue Töne folgen dahinter); ⌫/Entf löscht; ←/→ verschiebt die Auswahl. Automatische 4/4-Taktstriche mit Nummern; 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.

Tonart. Neben dem Titel „Meine Tabulatur“ legt ein Auswahlfeld die im Export geschriebene Tonart fest: Auto (aus der Mundharmonika oder der generierten Skala abgeleitet) oder eine bestimmte Tonika (die 12 Mundharmonika-Tonarten) in Dur oder Moll, unabhängig von der Tonart der Mundharmonika. Diese Tonart erscheint im ersten Takt des MusicXML (mit Modus) und in der MIDI-Datei — MuseScore zeigt dann eine saubere Partitur ohne überflüssige Vorzeichen.

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

10. Tastaturkürzel

11. Audioaufnahme 🎙 (Beta)

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

12. 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, Wiedergabe und Bordun 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.

13. Exporte

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

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.

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, Tempo 40–240, 🔊 Volumen, ⏱ Metrónomo (acento cada 4 pulsos).
• BORDÓN: nota sostenida (12 opciones, octava grave) para trabajar afinación y posiciones. Apáguelo durante el reconocimiento de notas.
• ACOMP: acompañamiento de piano — una progresión de acordes de 4 compases en bucle, en la tonalidad deducida de la melodía generada. Cuatro estilos con patrones reales de interpretación (no acordes en bloque): Country/Folk, Blues (shuffle, bajo caminante), Jazz (acordes sincopados y aireados), Balada melancólica (acordes sostenidos + arpegio). Sincronizado con el tempo y el swing de la app; toca tu melodía o improvisa encima. Iniciar la reproducción inicia el acompañamiento, y viceversa. Auriculares recomendados durante el reconocimiento de notas.
• Acordes en la exportación: si has activado ACOMP al menos una vez, la rejilla de acordes se añade a las exportaciones — encima de los compases al imprimir/PDF, como símbolos de acorde sobre el pentagrama en MusicXML, y como pista de acompañamiento dedicada en MIDI.

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

🏋️ Ejercicios

• 🎼 Generador (§ 8) · 🔀 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 toda la tablatura una octava (celdas equivalentes). Si faltan equivalentes, nada cambia y se listan.

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

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. Enlaces de compartir (antiguos)

El botón se ha retirado; los enlaces …#t=… ya enviados siguen cargando su tablatura. Use ahora 💾 .json o MIDI/XML.

8. 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. Bajo la tablatura, un desplegable «📖 ¿Cómo leer la tablatura?» mantiene a la vista la notación (+4 soplar, -4 aspirar, los bends, el código de color). Y un botón «🎯 ¡Intenta tocarla!» lanza el modo 🎯 directamente sobre la melodía mostrada: la tocas al micro y la app valida nota por nota.

9. Edición fina

Clic = selección (las nuevas notas se insertan después); ⌫/Supr borra; ←/→ mueve la selección. Barras de compás 4/4 automáticas con número; 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.

Armadura. Junto al título «Mi tablatura», un selector fija la armadura escrita en las exportaciones: Auto (deducida de la armónica o de la escala generada) o una tónica concreta (las 12 tonalidades de armónica) en mayor o menor, con independencia de la tonalidad de la armónica. Esta armadura aparece en el primer compás del MusicXML (con el modo) y en el archivo MIDI — MuseScore muestra entonces una partitura limpia, sin alteraciones superfluas.

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

10. Atajos de teclado

11. Grabación de audio 🎙 (beta)

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

12. 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, reproducción y bordó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.

13. Exportaciones

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

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

1. はじめに

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

• バーチャルハーモニカの音をクリック：クリックごとに音が鳴り、タブ譜に追加されます。
• ▶（または スペース）で再生。タブ譜が空のとき？ 「試す：…」ボタンが1小節のブルース・リックを提案します（毎回異なります）。
• 💾 ブラウザに自動保存：閉じても翌日戻ればセッションが復元されます。

2. 記譜法

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

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

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

4. ツールバー

🎵 再生

• ▶/⏹（スペース）、⟳ 途切れないループ、テンポ 40〜240、🔊 音量、⏱ メトロノーム（4拍ごとにアクセント）。
• ドローン：持続音（12種、低オクターブ）で音程とポジションを練習。音認識中はオフにしてください。
• 伴奏（ACCOMP）：ピアノ伴奏 — 生成したメロディから導いた調での4小節のコード進行をループ。実際の演奏パターンを持つ4スタイル（ベタ打ちではありません）：カントリー／フォーク、ブルース（シャッフル、ウォーキングベース）、ジャズ（軽く跳ねたコード）、もの悲しいバラード（持続コード＋アルペジオ）。アプリのテンポとスイングに同期。メロディを再生してもよし、上でアドリブしてもよし。再生を始めると伴奏も始まり、その逆も同様です。音認識中はヘッドホン推奨。
• 書き出し時のコード：伴奏（ACCOMP）を一度でもオンにしていれば、コード進行が書き出しに追加されます — 印刷／PDFでは各小節の上に、MusicXMLでは五線譜の上のコードシンボルとして、MIDIでは専用の伴奏トラックとして。

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

🏋️ 練習

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

🎼 タブ譜

• TAB / Notes / Do Ré Mi：タブ譜、英米式音名（C4, Bb3…）、ラテン式音名（Do4, Sib3…）。
• キー（12種のハーモニカ）：音名と音高は変わりますが、タブ譜自体は変わりません。
• ▾8 / ▴8：タブ譜全体を1オクターブ移調（対応する穴へ）。対応がない音があれば何も変えず、それらを一覧表示します。

📁 ファイル

• 📚 ライブラリ：このブラウザに名前付きで保存 — 読み込み・名前変更・削除。⬇ すべてエクスポートで再読み込み可能な .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 エクスポートはタイを書き込みます。

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. 共有リンク（旧仕様）

共有ボタンは廃止されました。すでに送った …#t=… リンクは引き続きタブ譜を読み込みます。今後は 💾 .json または MIDI/XML をご利用ください。

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

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

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

生成したものを読んで吹く。 タブ譜の下の「📖 タブ譜の読み方」の開閉部が記譜法を常に表示します（+4 吹く、-4 吸う、ベンド、配色）。そして「🎯 吹いてみよう！」ボタンは、表示中のメロディに対して 🎯 モードを直接起動します。マイクに吹き込むと、アプリが一音ずつ判定します。

9. 細かい編集

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

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

調号。「マイ・タブ譜」のタイトル横のセレクターで、エクスポートに書き込む調号を設定：自動（ハーモニカまたは生成スケールから推定）、または特定の主音（12種のハーモニカ調）を長調・短調で、ハーモニカの調とは独立に指定できます。この調号は MusicXML の最初の小節（モード付き）と MIDI ファイルに書き込まれ、MuseScore では余計な臨時記号のないきれいな楽譜になります。

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

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

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

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

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

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

12. 音認識 🎤（ベータ）

🎤 認識を開始し、音を伸ばして演奏：アプリが音名、タブ譜の穴（選択キーに応じて奏法色付き）、音程（±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回：はっきり区切ってください。音と音の間の休符は採譜されません。
• アプリのキーをハーモニカのキーに合わせてください。静かな環境が効果的です。

13. エクスポート

14. よくある質問

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

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

1. 开始使用

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

• 点击虚拟口琴上的音符：每次点击发声并添加到谱子。
• ▶（或 空格）播放。谱子为空？"试试：…"按钮提供一个一小节的布鲁斯乐句，每次都不同。
• 💾 浏览器内自动保存：关闭后明天再来，会话即可恢复。

2. 记谱法

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

3. 虚拟口琴

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

4. 工具栏

🎵 播放

• ▶/⏹（空格）、⟳ 无缝循环、速度 40–240、🔊 音量、⏱ 节拍器（每 4 拍重音）。
• 持续音：保持的长音（12 种，低八度），用于练习音准和把位。音符识别时请关闭。
• 伴奏（ACCOMP）：钢琴伴奏 — 一段循环的 4 小节和弦进行，调性根据生成的旋律推导。四种风格，配有真实的演奏型（并非整块和弦）：乡村／民谣、布鲁斯（shuffle、行走低音）、爵士（通透的切分和弦）、忧郁抒情（持续和弦＋琶音）。与应用的速度和摇摆同步；可播放你的旋律，也可在其上即兴。开始播放即开始伴奏，反之亦然。识别音符时建议佩戴耳机。
• 导出时的和弦：只要你至少开启过一次伴奏（ACCOMP），和弦进行就会加入导出 — 打印／PDF 中位于各小节上方，MusicXML 中作为五线谱上方的和弦记号，MIDI 中作为专门的伴奏音轨。

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

🏋️ 练习

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

🎼 谱子

• TAB / Notes / Do Ré Mi：口琴谱、英美式音名（C4, Bb3…）或拉丁式音名（Do4, Sib3…）。
• 调性（12 种口琴）：音名和音高随之改变，谱子本身不变。
• ▾8 / ▴8：将整张谱子移调一个八度（对应的孔）。若某些音没有对应，则不作改动并列出。

📁 文件

• 📚 曲库：在本浏览器中命名保存 — 加载、重命名、删除；⬇ 全部导出为可重新导入的 .json。窗口可通过标题栏拖动。
• 💾 / 📂：完整的 .json 文件；📂 也可打开 .mid（转换为谱子：时值量化、重建休止符、应用速度、列出无法演奏的音、建议最佳调性）以及 .xml/.musicxml。
• 📋 导入文本谱（§ 5）· 🎹 MIDI（GM 口琴）· XML MusicXML：精确乐谱 — 音符形态与时值始终一致、小节填满、写入连音线；MuseScore 不会重写节奏。
• 🖨 打印：版面整洁、白底、徽标、每行 12 个音（通过"打印为 PDF"生成 PDF）。

✏️ 编辑 & ♩ 时值

↶/↷（Ctrl+Z / Ctrl+Y）、🗑 全部清除、? 帮助。九种值：全音符、二分、四分、八分、十六分音符、三连音、附点（+50%），以及三个休止符（1、½、¼ 拍）。所选时值应用于后续音符；若已选中，则直接修改。

跨小节线的音：在屏幕上被分割并用 ‿ 连接（连音部分为虚线）— 音仍是单个音，一口气吹出；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. 分享链接（旧版）

分享按钮已移除；已发送的 …#t=… 链接仍可加载其谱子。今后请使用 💾 .json 或 MIDI/XML。

8. 旋律生成器 🎼

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

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

读谱并吹奏所生成的内容。 谱子下方有一个"📖 如何读谱？"的折叠区，持续显示记谱法（+4 吹、-4 吸、压音、配色）。还有一个"🎯 试着吹一下！"按钮，直接对所显示的旋律启动 🎯 模式：你对着麦克风吹奏，应用逐音判定。

9. 精细编辑

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

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

调号。在"我的谱子"标题旁，有一个选择器用于设定导出时写入的调号：自动（根据口琴或生成的音阶推断），或指定具体主音（12 种口琴调）的大调或小调，与口琴本身的调性无关。该调号会写入 MusicXML 的第一小节（含调式）和 MIDI 文件——这样 MuseScore 显示的乐谱干净整洁，没有多余的临时记号。

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

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

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

10. 键盘快捷键

11. 录音 🎙（测试版）

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

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

🎤 开始监听，吹一个持续音：应用显示音名、对应的谱子孔（按所选调性以技法配色）以及你的音准（±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 音分内（过于随意的压音不会记谱）。
• 同一个音两次：请明显断开。音与音之间的休止不记谱。
• 将应用调性设为你口琴的调性；安静的环境更有帮助。

13. 导出

14. 常见问题

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

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.

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, Andamento 40–240, 🔊 Volume, ⏱ Metrônomo (acento a cada 4 tempos).
• PEDAL: nota sustentada (12 opções, oitava grave) para trabalhar afinação e posições. Desligue-o durante o reconhecimento de notas.
• ACOMP: acompanhamento de piano — uma progressão de acordes de 4 compassos em loop, na tonalidade deduzida da melodia gerada. Quatro estilos com padrões reais de execução (não acordes em bloco): Country/Folk, Blues (shuffle, baixo caminhante), Jazz (acordes sincopados e arejados), Balada melancólica (acordes sustentados + arpejo). Sincronizado com o andamento e o swing do app; toque sua melodia ou improvise por cima. Iniciar a reprodução inicia o acompanhamento, e vice-versa. Fones recomendados durante o reconhecimento de notas.
• Acordes na exportação: se você ativou o ACOMP ao menos uma vez, a grade de acordes é adicionada às exportações — acima dos compassos na impressão/PDF, como cifras acima da pauta no MusicXML, e como faixa de acompanhamento dedicada no MIDI.

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

🏋️ Exercícios

• 🎼 Gerador (§ 8) · 🔀 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 toda a tablatura uma oitava (furos equivalentes). Se faltarem equivalentes, nada muda e eles são listados.

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

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. Links de compartilhamento (antigos)

O botão de compartilhamento foi removido; os links …#t=… já enviados continuam carregando sua tablatura. Use agora 💾 .json ou MIDI/XML.

8. 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. Abaixo da tablatura, um menu suspenso "📖 Como ler a tablatura?" mantém a notação à vista (+4 soprar, -4 aspirar, bends, código de cor). E um botão "🎯 Tente tocar!" abre o modo 🎯 direto na melodia exibida: você a toca no microfone e o app valida nota por nota.

9. Edição fina

Clique = seleção (as novas notas são inseridas depois); ⌫/Del exclui; ←/→ move a seleção. Barras de compasso 4/4 automáticas com número; 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.

Armadura de clave. Ao lado do título "Minha tablatura", um seletor define a armadura escrita nas exportações: Auto (deduzida da gaita ou da escala gerada) ou uma tônica específica (as 12 tonalidades de gaita) em maior ou menor, independentemente da tonalidade da gaita. Essa armadura aparece no primeiro compasso do MusicXML (com o modo) e no arquivo MIDI — o MuseScore mostra então uma partitura limpa, sem acidentes supérfluos.

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

10. Atalhos de teclado

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

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

12. 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, reprodução e pedal 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.

13. Exportações

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