🎹 nanoMIDIPlayer+

nanoMIDIPlayer+ is a heavily modified fork of the original nanoMIDIPlayer.

This project focuses on expanding functionality, improving performance, refining usability, and introducing new systems while keeping compatibility with core concepts from the original project.

Huge credits to NotHammer043 and all contributors of the original nanoMIDIPlayer for creating the foundation this project builds upon.

---

🚀 Features

⭐ Core Features (from original project)

• MIDI → QWERTY simulation
• MIDI → Output device support
• MIDI INPUT to QWERTY
• Velocity & Sustain support
• Full 88 key support
• Drums support
• Modifiable keymaps
• Cross-platform (Windows / Linux / macOS)
• No time drift

---

🔥 nanoMIDIPlayerPlus Improvements

Features below include current improvements (in development) and planned additions for the Plus version.

• ⚡ Optimizations for smoother playback
• 🧠 Improved MIDI processing system
• 🐧 Enhanced Linux compatibility (X11 and Wayland) & backend adjustments
• 🔧 Internal engine refactors for easier expansion
• 📝 Added more Human Fail options such as Note/Chords Jitter and Accidental Notes
• 📚 Better MIDI Hub (Original Hub + NEW Musescore API Hub)
• 🎹 Better event handling and timing precision
• 🎛️ Added Groups (Songs Library) instead of old MIDI list
• 🔄 Improved internal reliability for all Platforms
• 🆕 Newer UI and workflow improvements (WIP)

---

📸 Showcase

🚧 Coming Soon

Screenshots and demonstrations will be added after upcoming updates.

---

🛠️ Setup

1. Download the latest release (when available)
2. Launch the application
3. Select a MIDI file
4. Focus your target piano/app
5. Press PLAY

---

⚠️ About This Fork

This repository is a fork of the original nanoMIDIPlayer project.

While many internal systems have been modified or rewritten, this project still uses ideas and components from the original implementation.

If you're looking for the original project, visit:

➡️ https://github.com/NotHammer043/nanoMIDIPlayer

---

🛠️ Building

🔧 Requirements

• VS BuildTools C++ (Optional)
• Python

1. Clone The Repository

git clone https://github.com/NotHammer043/nanoMIDIPlayer.git
cd nanoMIDIPlayer

2. Install Dependencies

pip install -r requirements.txt

# For Linux (Bash Shell)
python -m venv venv && source venv/bin/activate && pip install -r requirements.txt
# For Linux (Fish Shell)
python -m venv venv && source venv/bin/activate.fish && pip install -r requirements.txt

3. Build

build.bat

# For macOS
./build-mac.sh

# For Linux
./build-lnx.sh

🐞 Debugging Mode

nanoMIDIPlayer.exe --debug