Skip to content

Latest commit

 

History

History
41 lines (39 loc) · 2.1 KB

README.md

File metadata and controls

41 lines (39 loc) · 2.1 KB

midimap

Map MIDI events to simulated keyboard events.

Setup

midimap can be compiled to use either portmidi or rtmidi. The following sections describe how to build midimap with one of these libraries, you should only follow the section for your library of choice.

If you are confused with regards to which library to use, I recommend rtmidi for most users.

rtmidi

Install non-Go dependencies

# Debian derivatives
sudo apt install libasound2-dev
# Fedora and the-like
sudo dnf install gcc-c++ rtmidi-devel
# MacOS
# TODO: Add possible macos rtmidi dependencios

Build

$ go build -tags rtmidi

portmidi

Install non-Go dependencies

# Debian derivatives
sudo apt install libportmidi-dev
# MacOS
brew install portmidi

Build

$ go build -tags portmidi

Alternatives

There are several other MIDI to keypress programs, but none of them are sufficient for my use case. Notably there is no single alternative which is both open source, cross platform and built with a efficient and pleasant stack(e.g no python or electron ;)). I also have ambitions outside of these critera, but for now these are the main advantages.

Alternative License Platform Comment
Midikey2Key Propietary freeware Windows only
xobs/midi-to-keypress Apache License 2.0 Windows only
davidlukerice/midi-to-keypress MIT Windows only Uses Electron ;(
mwicat/midimap Source available propietary freeware Windows only Uses Python ;(