Music Reading Game Help

How to Play

The game presents music notes on a staff. Your goal is to identify the correct note by clicking the corresponding piano key. Each correct answer earns you points and builds your streak!

Look at the note displayed on the staff (the lines and spaces where music is written). Then, find and click the matching white key on the piano keyboard below. If you're correct, you'll hear the note play and your streak will increase. If you're incorrect, you'll hear a "thud" sound, and your streak will reset.

Progressive Difficulty

The game features multiple levels with increasing difficulty. New notes are introduced gradually as you master the current ones. To advance to the next level, you need to achieve a specific streak and speed requirement.

Each level focuses on a small set of notes. As you consistently identify them correctly and quickly, you'll unlock the next level, which introduces more notes. The required streak (number of correct answers in a row) and speed (average time per note) for advancing are shown in the top-right corner of the game screen.

Multiple Profiles

Create different profiles for multiple users. Each profile keeps track of its own progress, learned notes, and completed levels. Access profiles through the settings panel.

Click the gear icon () to open the settings panel. Here you can see the list of existing profiles, select a profile to play with, or add a new profile by typing a name and clicking "Add Profile". All game progress, including unlocked levels and learned notes, is saved separately for each profile.

Customization Options

Access the settings panel by clicking the gear icon () on the main game screen. Here you can adjust various options:

• Show Note Names: Toggle this to display the letter names (C, D, E, F, G, A, B) directly on the piano keys. This can be helpful when you are first learning the keyboard layout.
• Show All Notes: By default, only the notes relevant to the current level are shown as active options. Toggle this setting to see all possible notes highlighted on the keyboard, even those not currently being tested. This can help understand the context of the notes within the full piano range.
• Reset Progress: If you want to start over for the currently selected profile, click this button. It will reset the unlocked levels and learned notes for that profile only.
• Clear All Profiles: This button completely wipes all saved data, including all user profiles and their progress. Use with caution, as this action cannot be undone!
• Level Selection: You can manually select any level you have previously unlocked for the current profile. This allows you to practice specific sets of notes.

Understanding the Game Screen

The main game screen displays several key pieces of information:

• Top Left (Profile & Stats):
• Profile Name: Shows the currently active user profile.
• Streak Counter : Displays how many notes you have identified correctly in a row. Getting an answer wrong resets this to 0.
• Speed Display : Shows your average response time per note in seconds for the current session. Faster times are better!
• Top Right (Level & Goal):
• Level Name: Indicates the current difficulty level you are playing.
• Goal : Displays the required streak and maximum average speed needed to pass the current level and unlock the next one.
• Center (Staff): This is where the note you need to identify is displayed.
• Bottom (Piano Keyboard): Click the correct key here to identify the note shown on the staff.
• Feedback Area: Below the staff, messages like "Correct!" or "Incorrect!" will appear.

Sound Feedback

The game provides immediate audio feedback to help you learn:

• Correct Answer: Plays the synthesized sound of the correct piano note. This helps associate the visual note with its sound.
• Incorrect Answer: Plays a low "thud" sound, providing clear feedback without being musically distracting.
• Level Completion: When you meet the goal for a level, a short, celebratory sound sequence plays to acknowledge your achievement.