intono/GUIDA_UTENTE.md

InTono — Guida Utente

Intonazione e pratica per musicisti di ogni livello.

---

Strumenti

Controllo Intonazione

Rileva in tempo reale la nota che stai suonando tramite il microfono del dispositivo. Lo schermo mostra:

• Nome della nota rilevata (notazione italiana: Do, Re, Mi...)
• Deviazione in cents rispetto all'intonazione perfetta
• Indicatore visivo verde (intonato) o rosso (stonato)

Ideale per strumenti a corda, a fiato o voce: verifica se stai suonando la nota giusta.

Metronomo

Un metronomo digitale con le seguenti funzioni:

• BPM regolabile da 30 a 240 tramite slider
• Tempi disponibili: 2/4, 3/4, 4/4, 6/8
• Indicatori visivi dei battiti con accento sul primo battito
• Tap Tempo: tocca ripetutamente il pulsante per impostare il BPM dal tuo ritmo
• Tuner integrato: premi il pulsante microfono per attivare il rilevamento dell'intonazione mentre suoni a tempo. Mostra la nota rilevata, la deviazione in cents con indicatore visivo e la frequenza in Hz

Premi il pulsante Play per avviare, Stop per fermare.

Nota di Riferimento

Genera una nota di riferimento per accordare o esercitarsi a orecchio:

• Pulsante rapido LA 440 Hz per l'accordatura standard
• Griglia di 12 note per selezionare qualsiasi nota cromatica
• Ottava selezionabile da 2 a 7
• Mostra la frequenza esatta in Hz

Premi Play per ascoltare la nota, Stop per fermare.

---

Pratica

Modalita Pratica

Il cuore dell'app. Carica una sequenza di note e suonale una per una:

1. Scegli come inserire le note: manuale, scansione foto o file MusicXML
2. Suona ogni nota mostrata sul pentagramma
3. L'app rileva la nota dal microfono e avanza automaticamente quando e' corretta
4. Al termine vedi le statistiche della sessione

Modalita di visualizzazione del pentagramma:

• Nota: mostra solo la nota corrente
• Contesto: mostra le note vicine
• Spartito: mostra tutto il pentagramma
• Chiaro: sfondo bianco per leggibilita
• Nascondi: nasconde il nome della nota scritta, utile per esercitarsi a leggere dal pentagramma

Metronomo integrato: sotto i selettori di visualizzazione c'e' una barra metronomo con play/stop, BPM e slider per suonare a tempo durante la pratica.

Lo sfondo cambia colore: verde = nota corretta, rosso = nota sbagliata.

Esercizi

Esercizi pronti da suonare con difficolta progressiva:

• Livello 1: Note base (Do-Sol)
• Livello 2: Scale complete
• Livello 3: Scale con alterazioni e melodie
• Livello 4: Arpeggi e salti

Tocca un esercizio per iniziare subito la pratica.

Scale e Arpeggi

Genera scale e arpeggi in qualsiasi tonalita:

Scale disponibili:

• Maggiore, Minore Naturale, Armonica, Melodica
• Pentatonica Maggiore e Minore
• Cromatica

Arpeggi disponibili:

• Maggiore, Minore, Diminuito, Aumentato
• Settima Dominante, Maggiore, Minore

Come usare:

1. Seleziona la nota fondamentale (12 opzioni cromatiche)
2. Scegli l'ottava (2-6)
3. Scegli il tipo di scala o arpeggio
4. Scegli la direzione: ascendente, discendente o entrambe
5. Visualizza l'anteprima sul pentagramma
6. Tocca Pratica per esercitarti con il riconoscimento automatico

Spartiti

Sfoglia la libreria di file MusicXML e pratica direttamente dai brani importati.

---

Sfida

Ear Training

Allena il tuo orecchio musicale con due modalita:

Riconosci Nota: ascolta una nota e indovina quale nota e'. Riconosci Intervallo: ascolta due note e identifica l'intervallo (da unisono a ottava).

Livelli di difficolta:

• Facile: poche note/intervalli semplici (unisono, terza, quinta, ottava)
• Medio: piu' note e intervalli comuni
• Difficile: tutte le 12 note e tutti i 13 intervalli

Ogni sessione ha 10 domande. Premi il pulsante Play per ascoltare, poi tocca la risposta corretta tra le 4 opzioni.

Modalita Sfida

Metti alla prova la tua velocita e precisione:

1. Scegli la sorgente: esercizi, scale o note random
2. Scegli il tempo limite: 30 secondi, 1 minuto o 2 minuti
3. Suona il maggior numero di note corrette nel tempo!

Ogni nota da suonare e' mostrata sia sul pentagramma che con il nome e l'ottava.

Sistema di punteggio:

• 100 punti base per ogni nota corretta
• Bonus precisione: +50 punti se entro 5 cents, +25 se entro 15 cents
• Bonus velocita: +30 punti se suoni in meno di 2 secondi
• Moltiplicatore combo: suona note consecutive corrette per aumentare il punteggio fino a 2x

Classifica

Vedi i tuoi 20 migliori punteggi nelle sfide, ordinati dal piu' alto. Per ogni risultato sono indicati il punteggio, le note suonate, la combo massima e la data.

---

Progressi

Statistiche

Panoramica dei tuoi progressi nel tempo:

Riepilogo:

• Numero totale di sessioni
• Sessioni completate
• Tempo totale di pratica
• Miglior precisione raggiunta

Grafici giornalieri:

• Precisione (deviazione media in cents — piu' basso e' meglio)
• Primo tentativo (percentuale di note suonate al primo colpo)
• Tempo di reazione (velocita media nel suonare ogni nota)

Obiettivi Giornalieri

Mantieni la costanza nella pratica:

• Imposta un obiettivo: 5, 10, 15 o 30 minuti al giorno
• Progresso circolare: vedi quanto hai praticato oggi
• Serie consecutiva: il contatore si incrementa ogni giorno che raggiungi l'obiettivo
• Calendario: visualizza gli ultimi 30 giorni con i giorni di pratica colorati in verde

Il tempo viene conteggiato da tutte le attivita: pratica, sfide e ear training.

Cronologia

Rivedi tutte le sessioni passate in un'unica lista cronologica: pratica, ear training e sfide. Ogni tipo ha un badge colorato per distinguerlo a colpo d'occhio. Tocca una sessione di pratica per rieseguirla.

---

Suggerimenti

• Ambiente silenzioso: l'app funziona meglio in un ambiente con poco rumore di fondo
• Distanza dal microfono: tieni il dispositivo a 30-50 cm dallo strumento
• Pratica quotidiana: anche 10 minuti al giorno fanno la differenza — usa gli obiettivi giornalieri per restare motivato
• Inizia dalle scale: padroneggiare le scale e' la base per suonare qualsiasi brano
• Ear training regolare: anche 5 minuti di ear training al giorno migliorano notevolmente l'orecchio musicale