PlayPianoGuida all'uso

1Per iniziare

PlayPiano è un pianoforte a 88 tasti che funziona nel browser e come app per computer. Non richiede registrazione e non invia nulla in rete: tutto avviene sul tuo dispositivo.

1. Apri l'app e premi un tasto qualsiasi del pianoforte. Al primo tocco si caricano i suoni del pianoforte a coda: in alto a destra compare Pianoforte a coda pronto.
2. Premi ♪ Demo per vedere subito pentagramma, note che cadono e tasti che si illuminano.
3. Quando vuoi studiare un brano, passa alla modalità Apprendimento.

2Suonare

Quattro modi di suonare

• Mouse: fai clic sui tasti. Trascinando il puntatore ottieni un glissando.
• Touch: puoi usare più dita insieme, per suonare accordi.
• Tastiera del computer: due file di tasti coprono due ottave e mezza. Le lettere sono scritte sui tasti del pianoforte.
• Tastiera MIDI: collegala prima di aprire l'app. Viene riconosciuta da sola, compreso il pedale. Serve Chrome, Edge o l'app desktop.

Dinamica

Con mouse e touch, più in basso premi sul tasto e più forte suona la nota. Con la tastiera del computer, tieni premuto Maiusc per suonare forte. Suonando piano il timbro diventa anche più scuro, come su uno strumento vero.

I comandi dello strumento

3Caricare uno spartito

Premi 📂 Carica MIDI / MusicXML oppure trascina il file sulla pagina. La tastiera si posiziona sul brano e compaiono pentagramma e cascata.

Leggere lo schermo

• Arancione è la mano destra, verde acqua la sinistra. Vale per le note che cadono e per i tasti.
• Il pentagramma mostra sempre due righe: quella che stai suonando e la successiva. Sotto ogni rigo ci sono i nomi delle note.
• Fai clic su una battuta del pentagramma per ripartire da lì.

La barra dello spartito

Nella cartella esempi del progetto trovi alcuni brani di prova.

4Modalità Apprendimento

È il cuore dell'app: il brano avanza solo quando suoni la nota giusta. Puoi prenderti tutto il tempo che serve.

1. Carica un brano, genera un'idea oppure premi Demo.
2. In Modalità scegli Apprendimento (avanza solo se suoni).
3. In Mani da suonare scegli una mano sola: l'app suona l'altra per te.
4. Abbassa la Velocità al 50% e premi ▶ Avvia.
5. Quando una nota arriva sulla linea luminosa, la cascata si ferma e il tasto da premere si illumina. Suonalo e il brano riparte.

Cosa succede mentre suoni

• Un tasto sbagliato lampeggia in rosso e conta come errore. Il brano resta fermo.
• Negli accordi devi premere tutte le note, anche una dopo l'altra.
• Le note dell'altra mano appaiono attenuate e non contano come errori.
• C'è una piccola tolleranza: una nota suonata con un attimo di anticipo viene accettata.
• Il punteggio mostra note giuste, errori, precisione e avanzamento. Si azzera quando ricominci o ti sposti nel brano.

5Compositore di idee

Genera brani originali completi, senza bisogno di internet. Ogni idea ha melodia per la mano destra, accompagnamento per la sinistra e una scheda che ne descrive la struttura.

• 🎲 Genera idea crea un brano nuovo e lo suona subito.
• ↻ Variazione mantiene accordi, tonalità e tempo, ma riscrive la melodia.
• La scheda dell'idea mostra titolo, tonalità, tempo, gli accordi di ogni sezione con nome e grado, la forma e uno spunto per sviluppare il brano.

Ogni idea si studia in modalità Apprendimento e si esporta in MIDI come qualsiasi altro brano.

6Generatore di accordi

Un accordo alla volta

Scegli Tonica, Tipo di accordo e Rivolto. I tasti si illuminano in viola e accanto compaiono la sigla e i nomi delle note. ▶ Ascolta lo suona, 🎲 ne propone uno a caso, ✕ spegne i tasti.

I diciotto tipi disponibili: maggiore, minore, diminuito, aumentato, sospeso di seconda e di quarta, sesta e minore sesta, settima di dominante, settima maggiore, minore settima, minore con settima maggiore, semidiminuito, settima diminuita, nona aggiunta, nona di dominante, nona maggiore, minore nona.

Giri di accordi

Un giro è una successione di accordi che si ripete. Scegli la tonica in alto, poi:

🎼 Carica giro porta il giro su pentagramma e cascata. 🎲 Casuale sceglie tonalità, giro e accompagnamento per te. Gli accordi si collegano con il rivolto più vicino, come farebbe un pianista.

7Idee con IA locale

Puoi descrivere a parole il brano che vorresti, per esempio «un valzer allegro da festa di paese». Un modello di intelligenza artificiale sul tuo computer ne progetta titolo, stile, tonalità, tempo, accordi e motivo melodico. Il compositore dell'app completa il resto. Nessun dato lascia il tuo computer.

Preparazione, una volta sola

1. Installa Ollama e avvialo.
2. Scarica un modello. Un buon punto di partenza:

   ollama pull gemma3:12b

3. Apri PlayPiano dall'app desktop oppure da localhost con il file Avvia PlayPiano.command.

Uso

1. Scrivi la descrizione nel campo Idee con IA locale.
2. Scegli il Modello. Lunghezza e difficoltà si prendono dai menu del compositore.
3. Premi ✨ Genera con IA o Invio. La prima risposta può richiedere fino a un minuto, perché il modello deve caricarsi.

Dopo la generazione, in alto a destra l'app indica quanti motivi del modello ha potuto usare. Se il numero è spesso basso, prova un modello più grande.

Quale modello scegliere

• Vanno bene i modelli di tipo «instruct» da circa 8 miliardi di parametri in su. Provati con buoni risultati: gemma3:12b e gemma4:26b.
• I modelli molto piccoli sbagliano spesso le durate. I modelli per codice, immagini o embedding non sono adatti.

OLLAMA_ORIGINS=https://melody.djluza.com ollama serve

8Registrare ed esportare

• ● Rec registra quello che suoni, pedale compreso. Premi di nuovo per fermare, poi ▶ Play per riascoltare. La registrazione resta in memoria finché non ne fai un'altra o chiudi l'app.
• ⬇ MIDI salva come file MIDI il brano caricato o generato, con mano destra e sinistra su tracce separate. Puoi riaprirlo qui o in qualsiasi programma musicale.

9App desktop

I pacchetti si scaricano dalla pagina delle Release su GitHub.

Gli avvisi compaiono perché i pacchetti non hanno un certificato a pagamento. Rispetto al browser, l'app desktop si collega a Ollama senza configurazioni, legge i suoni in locale anche senza internet e accetta le tastiere MIDI senza chiedere permessi.

10Scorciatoie da tastiera

Le lettere seguono la posizione fisica dei tasti, quindi funzionano con qualsiasi layout. In Chrome ed Edge le etichette sul pianoforte si adattano alla tastiera italiana. Mentre scrivi nel campo dell'IA, la tastiera del computer non suona.

11Se qualcosa non va

Per segnalare un problema o proporre un'idea, apri una segnalazione su GitHub.