26 lines
887 B
Markdown
26 lines
887 B
Markdown
# midi-hid
|
|
|
|
This software allows mapping and translating of MIDI commands to HID inputs on Linux.
|
|
|
|
## Installation and Usage
|
|
|
|
Install with
|
|
|
|
```bash
|
|
go install git.datalore.sh/datalore/midi-hid@latest
|
|
```
|
|
|
|
and run it with `midi-hid`. If no config file is specified, it reads `~/.config/midi-hid/config.yaml`.
|
|
Every configured midi controller will be represented by a virtual gamepad, and the inputs will be translated until SIGINT is received.
|
|
|
|
See the provided example config on how to configure your controller, it should be pretty self-explanatory.
|
|
|
|
## Known issues
|
|
|
|
The midi library used seems to recognise NoteOff messages as NoteOn messages. However, they can still be recognised by checking the velocity, which is always 0 in NoteOff messages. A workaround has been implemented.
|
|
|
|
## Third-party libraries
|
|
|
|
- <https://github.com/bendahl/uinput>
|
|
- <https://gitlab.com/gomidi/midi>
|