Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/atsushieno/kmmk

Fully featured virtual MIDI 1.0/2.0 keyboard application using Kotlin and Compose for Desktop and Android
https://github.com/atsushieno/kmmk

jetpack-compose keyboard kotlin midi music

Last synced: 2 months ago
JSON representation

Fully featured virtual MIDI 1.0/2.0 keyboard application using Kotlin and Compose for Desktop and Android

Awesome Lists containing this project

README 

        
# Kmmk: virtual MIDI keyboard for Desktop and Android



![Kmmk Desktop](docs/images/kmmk-desktop.png)

![Kmmk Android](docs/images/kmmk-android.png)



Kmmk is a virtual MIDI keyboard application based on [ktmidi](https://github.com/atsushieno/ktmidi).



Here are the basics: it receives either keyboard inputs, mouse clicks or touch inputs, among whatever the underlying platform accepts. Then it sends note on/off operations etc. to the target MIDI output device.



Kmmk makes use of Kotlin Multiplatform and Jetpack Compose, and should run on Android and desktop i.e. Linux, Mac and most likely Windows (not verified).



## Features



Kmmk has various features.



### Works as a virtual MIDI Input



(Linux and Mac only) when kmmk is launched, it creates a virtual MIDI input port for itself so that any MIDI apps (e.g. DAWs) can use it as a virtual MIDI keyboard.



### Keyboard layouts



It supports two PC keyset layouts:



- Diatonic: like piano. When there is no semitone e.g. `e-sharp` or `b-sharp` then the corresponding key is left blank.

- Chromatic: every key has an assigned note. That means, the key right next to `e` is not `f` but `f+` because `f` is placed on right-upper next to `e`.



### PC keyboard settings



By default the keyboard is laid out as ASCII QWERTY sequence. We also provide some other keyboard layouts that extend the key ranges beyond QWERTY.



### Octave Shift and Note Shift (transpose)



SHIFT+UP increases octave, SHIFT+DOWN decreases it. SHIFT+LEFT decreases transpose, SHIFT+RIGHT increases it.



### Drum part



You can also choose "channel 10" which usually means a drum channel. For channel 10, it will show drum set names instead of instruments.



### Record MML



When you type "notes" then they will be recorded at the text entry box, as simple MML (Music Macro Language), implemented as in [mugene-ng](https://github.com/atsushieno/mugene-ng).



### Play MML



The recorded MML can be compiled as a MIDI sequence and then sent to the target MIDI output device, just like MIDI players do.



### MIDI 2.0 support (kind of)



Since ktmidi supports MIDI 2.0, we leverage the feature in this application. It does not really connect bidirectionally, but sends MIDI-CI Set New Protocol message to the recipient, so unless the recipient refuses to connect unless any further testing (e.g. using MIDI-CI Test New Protocol messages), it would optimisitically work. There is no known host applications that support MIDI 2.0 devices anyways.



Unless you check "MIDI 2.0" option, it will send MIDI 1.0 messages.



### Combination of all above



Those features can be powerful when they are combined together. For example, you can code some drum patterns as in MML, then play it and send the MIDI seqneunce to your DAW via the kmmk virtual MIDI input.



## Miscellaneous Notes



The button pad can be hidden by toggle button (`[+]` Text).



Android emulators from Google (i.e. the ones you download as part of Android Studio) do not appropriately handle key events and you won't be able to keep key-on states. Hopefully not on Android devices (otherwise the entire API does not make sense), but not sure. It should work perfectly on desktop (it is verified on Ubuntu 22.04).



## License



kmmk is distributed under the MIT License.