DreamLyra / Guides

Heartopia auto piano guide: installation to your first song

Open DreamLyra on Windows 10 / 11, load a MIDI song, check your Heartopia instrument keys, and return to the game for your first performance.

Install and open

Download the Windows app, install it, and open DreamLyra.

Download for Windows

Watch the existing beginner video (Chinese)

Before you start

  • Windows 10 / 11 and an available trial or license.
  • A MIDI file and the instrument screen open in your game.
  • When you open DreamLyra, Windows shows a User Account Control prompt. Click Yes. DreamLyra runs as administrator so it can send keystrokes to the game.
  • The first time you open DreamLyra, the Quick start tutorial starts automatically and walks you through playing your first song with the Canon in your library. To follow this page on your own, first click Skip tutorial or press Esc. To watch it again later, click the ? button in the title bar, then click Replay the quick start.
  1. 01

    Select a MIDI file

    Under INPUT MODE, select MIDI FILE (Default). Then click SELECT MIDI FILE and open your MIDI in the file picker.

    Actual app interfaceDreamLyra 3.9.0
    DreamLyra 3.9.0 — Main window with a song loaded

    What you should seeThe main screen shows the song title and playback information.

  2. 02

    Choose the game profile

    Open the instrument screen in Heartopia and check that playing the keys manually produces sound. Select the matching game and instrument key profile in DreamLyra, then compare each key with the game. Use the layout shown in your game for each instrument.

    Actual app interfaceDreamLyra 3.9.0
    DreamLyra 3.9.0 — Main window

    What you should seeThe selected profile name appears on the main screen.

  3. 03

    Allow time to return to the game

    Set START DELAY to 3 or 5 seconds. Click play and switch to the game instrument before the countdown ends.

    Actual app interfaceDreamLyra 3.9.0
    DreamLyra 3.9.0 — Start delay menu

    What you should seeThe game instrument receives the performance keystrokes.

  4. 04

    Pause and resume

    Keep MIDI FILE (Default) selected. Press F8 while in the game to pause or resume.

    Actual app interfaceDreamLyra 3.9.0
    DreamLyra 3.9.0 — Performance controls

    What you should seePlayback changes between playing and paused.

Things to know

  • DreamLyra controls the game instrument through keyboard input; the game produces the sound.
  • If prompted to switch to the game, return to its instrument screen and press F8.
  • If the app reports that the game has higher privileges than DreamLyra (for example, because a system service started the game), restart the game normally.

First performance questions

No sound after installation?

DreamLyra turns MIDI into keystrokes; it does not output audio. Sound comes from the game. Open the game instrument screen, check the game volume, and verify the key profile.

F8 does nothing?

Check that DreamLyra is open, your trial or license is active, and a MIDI file is loaded. In MIDI file mode, F8 pauses or resumes playback. In creator mode, F8 starts or stops recording. Check whether another app uses F8.

The game does not respond to playback?

Set a 3- or 5-second start delay. Press play and return to the game instrument screen before the countdown ends. Keep the game in the foreground. If prompted to switch to the game, return to the instrument screen before pressing F8.

Explore all guides