Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/connorslade/makey-midi
Use a Makey Makey to send MIDI commands.
https://github.com/connorslade/makey-midi
makeymakey
Last synced: 13 days ago
JSON representation
Use a Makey Makey to send MIDI commands.
- Host: GitHub
- URL: https://github.com/connorslade/makey-midi
- Owner: connorslade
- License: mit
- Created: 2023-11-23T20:23:05.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-11-26T15:08:42.000Z (about 1 year ago)
- Last Synced: 2024-08-11T11:34:06.914Z (5 months ago)
- Topics: makeymakey
- Language: Rust
- Homepage:
- Size: 23.4 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# makey-midi [](https://github.com/Basicprogrammer10/makey-midi/actions/workflows/rust.yml)
Lets you use a [Makey Makey](https://makeymakey.com) to send midi commands!
When run, this program will load the config file and either create a virtual midi output port or connect to another midi device.
Pressing the keyboard keys defined in the config file will then send their respective note values.
You may want to consider [remapping](https://makeymakey.com/pages/remap) your Makey Makey so you can make use of the click button and so any arrow key inputs don't mess with any synth you have opened.
## Usage
To install, you can download the latest binary from [releases](https://github.com/Basicprogrammer10/makey-midi/releases).
Alternatively, you can build from source, either by cloning the repo or with `cargo install makey-midi`.
After installing, there are two main ways to run the application.
To connect to an existing midi device or create a new virtual output port.
When creating an output port, no further configuration is needed and the device name will be 'makey-midi' (`makey-midi create`).
When connecting to an existing port, you can specify the name of the port or leave it blank to automatically pick one (`makey-midi connect [name]`).
The config parameter allows you to specify a path of the [config file](#config) that contains the key map.
Omitting this will default to `config.toml` in the current directory.
The debug flag will log what keys are pressed to the console (Ex: `Key pressed: UpArrow`).
Below is the output of running `makey-midi --help`.
```plain
Usage: makey-midi [OPTIONS]
Commands:
connect Connects to a MIDI device to send events to
create Creates a new virtual MIDI output device. Only works on Linux.
list Lists all available MIDI devices. For use with the `connect` subcommand
help Print this message or the help of the given subcommand(s)
Options:
-c, --config The location of the config file. Defaults to `config.toml` in the current directory
-d, --debug Logs each key event to stdout
-h, --help Print help
```
Here is an example command.
This will load the default config file, enable debug output, and connect to the (pretty bad) built-in midi synth in windows.
```shell
makey-midi --debug connect "Microsoft GS Wavetable Synth"
```
## Config
Below is an example `config.toml` file.
If no config file is found when running, makey-midi will fall back to the default config shown below.
The `channel` defined what channel the midi events are sent on.
The `keymap` is the main part where you map keyboard keys to midi notes.
A list of all possible key values is in the dropdown below, and a table of midi notes can be found [here](https://www.inspiredacoustics.com/en/MIDI_note_numbers_and_center_frequencies).
```toml
channel = 0
keymap = [
{ key = 'KeyW', note = 59 }, # B
{ key = 'UpArrow', note = 60 }, # C
{ key = 'DownArrow', note = 62 }, # D
{ key = 'LeftArrow', note = 64 }, # E
{ key = 'RightArrow', note = 65 }, # F
{ key = 'Space', note = 67 }, # G
{ key = 'KeyM', note = 69 }, # A
]
```
Key List (From rdev)
- Alt
- AltGr
- Backspace
- CapsLock
- ControlLeft
- ControlRight
- Delete
- DownArrow
- End
- Escape
- F1
- F10
- F11
- F12
- F2
- F3
- F4
- F5
- F6
- F7
- F8
- F9
- Home
- LeftArrow
- MetaLeft
- MetaRight
- PageDown
- PageUp
- Return
- RightArrow
- ShiftLeft
- ShiftRight
- Space
- Tab
- UpArrow
- PrintScreen
- ScrollLock
- Pause
- NumLock
- BackQuote
- Num1
- Num2
- Num3
- Num4
- Num5
- Num6
- Num7
- Num8
- Num9
- Num0
- Minus
- Equal
- KeyQ
- KeyW
- KeyE
- KeyR
- KeyT
- KeyY
- KeyU
- KeyI
- KeyO
- KeyP
- LeftBracket
- RightBracket
- KeyA
- KeyS
- KeyD
- KeyF
- KeyG
- KeyH
- KeyJ
- KeyK
- KeyL
- SemiColon
- Quote
- BackSlash
- IntlBackslash
- KeyZ
- KeyX
- KeyC
- KeyV
- KeyB
- KeyN
- KeyM
- Comma
- Dot
- Slash
- Insert
- KpReturn
- KpMinus
- KpPlus
- KpMultiply
- KpDivide
- Kp0
- Kp1
- Kp2
- Kp3
- Kp4
- Kp5
- Kp6
- Kp7
- Kp8
- Kp9
- KpDelete
- Function