Flexible HID to MIDI translation layer
Demo video:
Ultimate successor of keyboard2000
and keyboard3000 projects
HIDI is a translation layer between HID devices like keyboards or gamepads and hardware MIDI interface, it also supports ALSA for standalone linux users.
This way you can play on your computer keyboard as MIDI device, use gamepad analog sticks to control
pitch-bend and CC. As many devices as you want, simultaneously.
Easy to use, easy to customize, and it has many quality of life features, carefully crafted with love to provide the best user experience possible.
- Any number of customized MIDI mappings, switchable by dedicated key, Piano, Chromatic and Control (every key with unique midi note, useful for DAW control) provided as default configuration
- Gamepad analog input to control CC, pitch-bend and note/action emulation
- Several actions like octave control (F1-F2), semitone (F3-F4), channel (F5-F6), mapping (F11-F12)
- Action pairs can be pressed at once to reset to default value
- intelligent note emission logic, user can freely change device state on the fly (octave, semitone, mapping, channel) even while still pressing keyboard keys, due to careful design notes will be not interrupted, will be released correctly on key release and only new key presses will emit notes respectively to the new internal state.
- NKRO keyboards support (if it can be enabled in your hardware or enabled by default)
- You can connect as many HID devices as you have free USB slots
- All devices are loaded/unloaded completely dynamically
- Application will reload configuration when new one will appear or existing one was changed. Very useful when user want to craft their own configuration
- OpenRGB support (Demo) (Check
"Direct" Modehere for supported devices.)
- Machine with Linux, either dedicated one for bridging with hardware MIDI interface or just your local machine
- Optional MIDI interface, please avoid cheap china USB interfaces, it has problem with receiving data (unless you have old version lying around, it may work just fine).
- Keyboards, gamepads :)
Download the latest version from releases for the platform of your choice.
Place binary on your system and run it with sudo ./HIDI.
See -h flag for available optional arguments
- If necessary, add permission for execution with
chmod +x HIDI - If you're connected via network to your Pi, it may be useful to run it under tmux
to avoid program termination on connection loss, just type
tmuxto run multiplexer,ctr+b -> dto leave tmux running in the backgroud,tmux ato re-enter your session - During application use you probably don't want to propagate keyboard events into your system
To avoid that use-grabparameter, use exit sequence (default alt+esc) to terminate program Standard user may not have permission to read input devices directly for security reasons.Due to some complications (e.g. OpenRGB root requirement), it's the easiest to run it with
The best way of running this program is to grant temporary privilege toinputgroup with:
sudo -u your_username -g input ./HIDI
Try to avoid running untrusted software directly with root privilegesudo.- for standalone linux users, use
-standaloneparameter which preserves one keyboard for user standard input, requires more hardware than one keyboard.-virtualparameter will create ready to use ALSA port instead of connecting to existing ports/hardware. - If you're bridging keyboards with hardware midi interface, see
-listmididevicesfor available interfaces and select them with-mididevice X
There are two types of configurations:
hidi.toml- minor behavior settings- device configurations, see guide for details.
Have fun!
Make sure you have go >= 1.18 installed
run go run build.go -cgo -platforms linux-amd64
By default, it will build all defined platforms without OpenRGB support,
to select specific platforms or enable OpenRGB (requires precompiled binaries), see go run build.go -h for usage
Features that are possible to achieve. With enough interest and support I may be motivated to implement these.
- configurable modifier key/keys for expanded mapping (key sequence like
modifier+KEY_A) localhost mode for Linux users without requirement of separate machine (jack/alsa)done!- Network MIDI
- Bluetooth MIDI device
- Arpeggiator (with MIDI clock sync), note latch, multinote MIDI effects
- Fully featured DAW control plugins
- standalone, fully featured MIDI sequencer with internal and external midi input support. Ideal feature for OpenRGB devices.
Do you like some specific idea listed above? Have you some improvement/feature idea not listed here?
Feel free to leave your wishes in Discussions section!
Any kind of help is highly appreciated!
You can propose features and improvements. There is no guarantee that I'm going to implement it right-away. It depends on the complexity of given feature and overall integrity with the rest of application, it depends on my free time and free will as well.
If you faced a bug, instability or general problems with application, feel free to open issue
and provide some information like error messages and logs.
In the case of problems with your specific HID devices,
please provide the full content of /proc/bus/input/devices file and your platform.
Feel free to open pull requests.
If your keyboard doesn't work correctly with default configuration,
create your own and add it in a pull request as Factory configuration.
Make sure it has proper values in Identifier section and loads correctly.
For more information, see guide
Please make sure that all default mappings are working and arranged correctly. (Piano, Chromatic, Control - this one covers all keyboard keys with unique notes).
- Negotiating/enabling N-Key Rollover keyboard mode from the OS side. Currently, NKRO is supported for devices that have ability to enforce that with a key combination. If you may have an idea how to do it, please lave your answer here.
Project is released under GPLv3, for detailed information see LICENSE
