Skip to content

About

A Spotify-inspired MIDI player with automatic playback support for in-game instruments.

Topics

Resources

Code of conduct

Contributing

Stars

65 stars

Watchers

3 watching

Forks

Latest commit

 

History

29 Commits

Folders and files

Repository files navigation


Auto MIDI Player【AMP】

Beta Stable Downloads

A feature-rich MIDI-to-key player for in-game instruments, built with Svelte 5, Tauri v2, and Rust.

If you liked this project, consider contributing or giving a 🌟 star. Thank you~


Supported Games and Instruments

  • Genshin Impact - All 11 instruments as of August 2026
  • Wuthering Waves - 21-key instruments (shared QWERTY mapping)
  • Neverness to Everness (NTE) - Piano (21-key & 36-key)
  • Where Winds Meet - Guqin
  • Blue Protocol: Star Resonance - Piano (61-key & 88-key)
  • Sky: Children of the Light - All available Sky instruments as of February 2026
  • Roblox - Piano (61-key & 88-key)
  • Heartopia - Piano (All variations), 15-key instruments (e.g. lyre, wooden bass, violin, etc.)
  • Core Keeper - All instruments (shared 24-key chromatic layout; sounding range C2–B3 up to C5–B6 per instrument)
  • Harry Potter: Magic Awakened (HPMA) - Piano (14-key & 36-key)

See the Support wiki page for details on supported games, instruments, and keyboard layouts.

Quick Start

  1. Download the package for your platform. Windows offers an installer or a portable ZIP; macOS uses a DMG; Linux offers AppImage and deb packages.
  2. Open a .mid file by pressing the + button at the top left.
  3. Enable the tracks that you want to be played back.
  4. Press play and it will automatically switch to the target game window.
  5. Automatically stops playing if you switch to a different window.

Note

If you get a SmartScreen popup, click on "More info" and then "Run anyway" The reason this appears is because the application is not signed. Signing costs money which can get very expensive.

Features

Core Features

  • Multi-game support - Play on Genshin Impact, Wuthering Waves, Sky, Roblox, Heartopia, Neverness to Everness, Blue Protocol: Star Resonance, Harry Potter: Magic Awakened, Core Keeper, and Where Winds Meet
  • Spotify-style UI - Modern player interface with fixed bottom controls
  • Studio View - Piano roll interface with scrubbing and mid-song key changes
  • Per-song Settings - Key offset, transpose, speed, and BPM settings are saved for each song

Instrument Playback

  • Test MIDI files through speakers before playing in-game
  • Change keyboard layouts (QWERTY, QWERTZ, AZERTY, DVORAK, etc.)
  • Hold and merge nearby notes. Some songs sound better when merged (#4)
  • Smart transposition with key auto-correction for instruments with limited note ranges
  • Sustain pedal support
  • Play using your own MIDI Input Device
image

Discovery (Online MIDI) [Rewrite: Work in Progress]

Browse, search, and download MIDI files directly inside the app without opening a browser.

  • Online Repositories - Browse MIDI tracks from various online repositories.
  • In-App Synthesizer Preview - Listen to song previews before downloading or adding to your library
  • Detailed Track Breakdown - Inspect tracks, channels, instruments, note counts, BPM, ratings, and download counts
  • Library Import - Download and add tracks directly into your song list with original track names preserved
image

MIDI Track Management

  • Play multiple tracks of a MIDI file simultaneously
  • Turn on/off tracks in realtime
image

Studio View

A piano roll interface to inspect notes, scrub through songs, and set mid-song key changes.

  • Real-time horizontal piano roll with keyboard guide and note highlighting
  • Add key change markers to modulate keys throughout the song (or auto-detect them from the MIDI file)
  • Timeline scrubber with zoom controls and playhead tracking
  • Quick drawer to toggle tracks and tweak song settings
image

Piano Sheet

The Piano Sheet allows you to easily share songs to other people, or for yourself to try. You can change the delimiter as well as the split size, and spacing. This will use the current keyboard layout that you have chosen.

image

Queue

A queue allows you to play songs without having to open or delete a song or file.

image

Theming

You can set the player to light mode/dark mode and change its accent color.

About

What are MIDI files?

MIDI files (.mid) are a set of instructions that play various instruments on what are called tracks. You can enable specific tracks that you want it to play. It converts the notes on the track into keyboard inputs for the game. Currently it is tuned to C major.

Can this get me banned?

The short answer is that it's uncertain. Use it at your own risk. Do not play songs that will spam the keyboard, listen to the MIDI file first and make sure to play only one instrument so that the tool doesn't spam keyboard inputs.

Documentation

For setup details, feature walkthroughs, safety notes, and troubleshooting, use the wiki links below.

Build from Source

If you just want to run the app, download the latest release.

Requirements

Build and run

git clone https://github.com/Jed556/AutoMidiPlayer.git
cd AutoMidiPlayer-rewrite

# Install frontend dependencies
pnpm install

# Start Tauri desktop app in dev mode (Vite + Rust)
pnpm dev

# Start frontend dev server only (browser mode)
pnpm dev:frontend

# Build native packages for the current platform
pnpm build

For publish options and advanced setup, see Getting Started. For documentation and release setup, see the project wiki.

Contributing

Please read CONTRIBUTING.md.
For adding notes, instruments, games, or keyboard mappings, see Getting Started

Special Thanks

This project was originally forked from sabihoshi/GenshinLyreMidiPlayer v4.0.5 and later detached into its own repository to enable multi-game support and features that do not fit the original Genshin Impact-only design. Huge thanks for the original work!

License

  • This project’s source code is licensed under the GNU General Public License v3.0.
  • This project is based on sabihoshi/GenshinLyreMidiPlayer. Original attribution and upstream notices are preserved in THIRD-PARTY-LICENSES.md.
  • "Auto MIDI Player" and its logo are trademarks of Jed556. Trademark and branding use are governed by TRADEMARK.md.
  • This project is not affiliated with or endorsed by miHoYo, KURO GAMES, XD, thatgamecompany, Roblox Corporation, Hotta Studio, Pugstorm, Everstone Studio, or any other rights holder. Genshin Impact™, Wuthering Waves™, Heartopia™, Sky: Children of the Light™, Roblox™, Neverness to Everness™, Core Keeper™, Where Winds Meet™, and other game titles and properties belong to their respective owners.
  • Third-party libraries and other resources used by this project may be distributed under different licenses and are listed in THIRD-PARTY-LICENSES.md.

Demo videos and screenshots are for illustrative purposes only and may not reflect the latest version of the application. Actual features, UI, and supported games/instruments may vary. Please refer to the latest release and Wiki for up-to-date information.

Note

I don't have knowledge about music theory, if you find any issues with note mappings or transpositions, please open an issue or PR. Thank you! 💖

About

A Spotify-inspired MIDI player with automatic playback support for in-game instruments.

Topics

Resources

Code of conduct

Contributing

Stars

65 stars

Watchers

3 watching

Forks

Releases

Used by

Contributors

Languages