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