Skip to content

FAQ General

Jed556 edited this page Nov 16, 2026 · 7 revisions

Frequently Asked Questions

Where does this project come from?

AMP started as a fork of sabihoshi/GenshinLyreMidiPlayer and grew into its own multi-game player. The desktop app uses Svelte 5, Tauri v2, and Rust. See Project History for the story.

Cool name? Where did it come from?

Thanks! "Auto MIDI Player" says what it does: it plays MIDI files automatically in games. AMP also stands for "Amplifier," which fits nicely since the app “drives” instruments in-game… and yeah, it can also literally play music through your speakers 😅

Which games and instruments are supported?

The bundled profiles cover Genshin Impact, Wuthering Waves, Neverness to Everness (NTE), Where Winds Meet, Blue Protocol: Star Resonance, Sky: Children of the Light, Roblox, Heartopia, Core Keeper, and Harry Potter: Magic Awakened.

See Support for the instruments and keyboard layouts. A game profile describes its mappings; it doesn't mean that the game itself is available or tested on every OS AMP can build for.

Why doesn't my app look like the wiki?

This wiki documents the current desktop app, built with Svelte 5, Tauri v2, and Rust. Older C#/WPF releases have a different interface and feature set. Check your version in About and the release notes if the screens differ.

How do I download songs directly in the app?

Discover is still under construction. Online search, previews, and downloads aren't available through that page yet. Download a .mid or .midi file yourself, then use Import MIDI in Songs. How To Use has the steps.

What kinds of MIDI files work best?

Cleanly separated melody and accompaniment tracks make things easier. Start with a few tracks, listen, and add more if the result sounds good. A full orchestral MIDI can get pretty noisy and inaccurate on a small in-game instrument 😅

Use key offsets, Auto Correct, and transposition to fit the notes to your instrument. Full Chromatic (Raw) Listen Mode plays the original pitches; Game Preview (Adapted) helps you hear what fits the selected instrument. These tools help with the arrangement, but they can't give an instrument notes it doesn't have.

Why can I hear music, but nothing plays in the game?

Check Listen Mode first, it sends audio to your speakers. Turn it off for game keys, choose the correct game, instrument, and keyboard layout, then open the game's instrument screen.

AMP can turn Listen Mode on automatically when it can't find the game. Check the executable under Settings → Locations if detection looks wrong. On Windows, an elevated game may need AMP at the same privilege level. macOS needs Accessibility permission. Wayland uses a keyboard portal session and has different focus behavior. See Getting Started for the platform details.

Can I use my own SoundFonts?

Yep! Add an .sf2 file in Settings and use it for Listen Mode. With Gap Filling enabled, earlier fonts in the stack get first pick; later fonts supply missing instruments or note ranges. Turn gap filling off to choose a single font instead.

Custom fonts stay at their original file paths. Removing one from AMP unregisters it; it doesn't delete your source file. If you move the file yourself, add it again from its new location. See Audio and SoundFonts for the controls.

Can I play with a MIDI keyboard?

Yesss! Choose it from MIDI Input on the Instrument page. Selection connects it automatically, and AMP tries an available remembered device again at launch. Choose None to disconnect. After unplugging and reconnecting it, use Refresh Devices or select it again.

Listen Mode lets you hear it through the synthesizer; game mode maps its exact pitches to the selected instrument. Live input doesn't use the song's key offsets or Smart transpose. You can also play alongside a backing song. More details are in MIDI Devices.

Did AMP close, or is it still in the tray?

Check Settings → System. Minimize to Tray and Close to Tray are separate options. When a tray icon is available, its menu can show the window, play/pause, skip to the next song, or exit AMP. Closing to the tray keeps the app running, including active MIDI input.

Can this get me banned?

There's no guarantee that a game permits automated input. AMP being open source, using keyboard events, or playing a simple song doesn't establish that it's allowed. Please check the game's current rules and read the Disclaimer before using game output.

Where should I ask for help?

Open an issue and pick the bug report or feature request template. For bugs, include your AMP version, OS, selected game/instrument/layout, what you expected, and what happened. A small MIDI that reproduces the issue helps a lot!

Settings → System has system information and service status. Debug has logging controls. Check logs and screenshots for personal paths or other information you don't want to share before attaching them.

Why does the interface look kinda glowing on my HDR monitor?

AMP uses bright accents and glows, and their appearance can vary with your display and Windows' SDR-to-HDR mapping. Try adjusting Settings → System → Display → HDR → SDR content brightness in Windows if SDR apps look too bright. If only AMP looks wrong, include a screenshot and your display settings in a bug report.

Basics

Add songs

Discover (WIP)

Song List & Edit

Tuning

Managing Tracks

Studio and Key Changes

Piano Sheet

Listen Mode

The Queue

Control Panel

Playing a Song
Settings
Player

Song Defaults

Audio and SoundFonts

Hotkeys


Locations

Updates

Customization

System and Tray

Diagnostics & Debug

About Page

Playback Pipeline

Key Offset
Transposition

Keypress Backends

Advanced File Handling

Note Timing and Chord Pads

SoundFonts and Live MIDI

Discovery Status

Playback Safety and Focus

Clone this wiki locally