https://github.com/NotHammer043/nanoMIDIPlayer
Macro for converting MIDI input to keyboard actions or routing it directly to a MIDI output.
https://github.com/NotHammer043/nanoMIDIPlayer
Last synced: 10 months ago
JSON representation
Macro for converting MIDI input to keyboard actions or routing it directly to a MIDI output.
- Host: GitHub
- URL: https://github.com/NotHammer043/nanoMIDIPlayer
- Owner: NotHammer043
- License: gpl-3.0
- Created: 2024-01-24T07:27:04.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-15T15:45:28.000Z (over 1 year ago)
- Last Synced: 2024-09-15T17:01:34.581Z (over 1 year ago)
- Language: Python
- Homepage: https://nanomidi.net
- Size: 177 MB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-webfishing - NanoMIDI Player - Simple, easy to use and configure MIDI player. (MIDI Tools / Players)
README
# 🎹 nanoMIDIPlayer
**nanoMIDIPlayer** is a lightweight MIDI player that can simulate QWERTY keys or send MIDI signals directly to output MIDI devices. It also includes a Virtual Drums Macro.
[](https://github.com/NotHammer043/nanoMIDIPlayer/releases)
---
## 🚀 Features
✅ **Open Source**
✅ Macro **QWERTY keys** from MIDI input
✅ **Velocity** and **Sustain**
✅ **88 Key** support
✅ **Random Fail** (random Speed or Transposition failures)
✅ Simulate MIDI data directly to **MIDI output devices**
✅ **Drums** Macro
✅ **Modifiable** Hotkeys
✅ Built-in **MIDI Hub** from [nanoMIDI.net](https://nanomidi.net)
✅ **Customizable** User-Interface
✅ **🪟Windows and 🍏macOS Support**
---
## 📸 Showcase
https://github.com/user-attachments/assets/bb727c89-bd29-44f8-9194-e09e8f49975f
---
## 📥 Download & Setup
### 🔹 Download
Get the latest version of **nanoMIDIPlayer**:
[](https://github.com/NotHammer043/nanoMIDIPlayer/releases)
### 🛠️ Setup
1️⃣ **Download** [nanoMIDIPlayer.exe](https://github.com/NotHammer043/nanoMIDIPlayer/releases) or [nanoMIDIPlayer-macOS.dmg](https://github.com/NotHammer043/nanoMIDIPlayer/releases) for macOS
2️⃣ **Run** nanoMIDIPlayer.exe
3️⃣ **Select a MIDI File** or find one from **MIDI Hub**
4️⃣ **Focus** on your virtual piano app/game
5️⃣ **Press "PLAY"** (Default Hotkey: **F1**)
---
## ⚠️ Why is this program detected as a virus?
Open-source programs like this often get flagged as viruses because some **malware** may use the same libraries. Removing false positives costs around **$300/year**. You can freely check the **source code** to ensure it is safe.
---
## 🏗️ Building from Source
### 🔧 Requirements
- [VS BuildTools C++](https://visualstudio.microsoft.com/visual-cpp-build-tools/)
- [Python 3.11.4](https://www.python.org/ftp/python/3.11.4/python-3.11.4-amd64.exe)
#### 📌 Install Dependencies
```bash
pip install -r requirements.txt
```
**Requirements:**
```
customtkinter
Pillow
mido
pynput
requests
python-rtmidi
keyboard
pyinstaller
```
#### 🏗️ Building
```bash
build.bat
```
```python
# For macOS
./build-mac.sh
```
#### 🐞 Debugging Mode
```bash
nanoMIDIPlayer.exe --debug
```
---
## 🧪 Beta Testers
Special thanks to our **beta testers** and **suggesters**! 🎉
||||
|----------------------|----------------------|--------------------------|
| redxyzxd | rzrized | spin_l |
| ducktue | samiord | somecoolname2 |
| gamesacctualych | shitben10 | hdsfgh |
| 4lucq | slvrr_ | sharpeninq |
| bkiiz3 | fearsomeorc1406 | kyphise |
| catnoyesyesnoyesno | x.bunn | nictiser |
| 6price | uvane | shawn123_0 |
| dajay10 | trapguy5 | youwontfindmymain_89866 |
| lilbean3.0 | yournightmare5005 | zackfgteev1yt |
| 27600 | koji_xyz | |
---
## ⭐ Star History
[](https://www.star-history.com/#NotHammer043/nanoMIDIPlayer&Date)
---
### 💖 Support & Contributions
- **Star the repo** ⭐ on [GitHub](https://github.com/NotHammer043/nanoMIDIPlayer)
- **Report issues** 🛠️ via [GitHub Issues](https://github.com/NotHammer043/nanoMIDIPlayer/issues)
- **Contribute** 💻 via Pull Requests