Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mindstudioofficial/midi_to_ndi
convert realtime MIDI data to NDI® Metadata frames and back
https://github.com/mindstudioofficial/midi_to_ndi
midi midi-device ndi ndi-tools
Last synced: 1 day ago
JSON representation
convert realtime MIDI data to NDI® Metadata frames and back
- Host: GitHub
- URL: https://github.com/mindstudioofficial/midi_to_ndi
- Owner: MindStudioOfficial
- License: other
- Created: 2025-01-24T04:48:23.000Z (3 days ago)
- Default Branch: main
- Last Pushed: 2025-01-24T05:25:20.000Z (3 days ago)
- Last Synced: 2025-01-24T06:24:34.106Z (3 days ago)
- Topics: midi, midi-device, ndi, ndi-tools
- Language: C++
- Homepage:
- Size: 46.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WIP: MIDI to NDI converter
This CLI application converts realtime MIDI IO to NDI metadata frames as specified here:
[sienna-tv.com midi over ndi](https://www.sienna-tv.com/newsite/midioverndi.html)
It has two modes:
- Receiving MIDI from a selectable NDI source and sending it to a virtual MIDI port using `teVirtualMIDI`
- Receiving MIDI from a MIDI device using `RtMidi` and outputting it as NDI Metadata frames
## Usage
```bash
midi_to_ndi --help
```
#### List MIDI Inputs and NDI Sources
```bash
midi_to_ndi -l
```
#### Receive MIDI from NDI Source and send it to Virtual MIDI Port
```bash
midi_to_ndi -r --ndi-source "NDI Source Name" --midi-output-name "NDI MIDI"
```
the midi output name is optional and defaults to "NDI MIDI"
#### Transmit MIDI from MIDI Device as NDI Metadata Frames
```bash
midi_to_ndi -t --midi-input "MIDI Port Name" --ndi-send-name "NDI MIDI"
```
the ndi send name is optional and defaults to "NDI MIDI"
## NDI Metadata Frames
NDI Metadata frames are a way to send metadata over the network using the NDI protocol.
They can theoretically contain any text data but it usually uses XML to structure the data.
The NDI Metadata frames used in this project are structured as follows:
```xml
E00040
```
Where `E00040` is the hexadecimal MIDI message to be sent.
## Requirements
the teVirtualMIDI driver needs to be installed on your system.
This comes for example with loopMIDI: [loopMIDI](https://www.tobias-erichsen.de/software/loopmidi.html)
## Current state of development
The project is currently in a very early stage of development and might not work as expected.
- hardcoded windows NDI binaries: you might need to specify the path to the NDI dlls in `CMakeLists.txt` depending on your system
- hardcoded winmm.lib in `CMakeLists.txt`: For other platforms than Windows you might need to replace this with the appropriate library
## Dependencies
- [NDI SDK](https://www.ndi.tv/sdk/) - needs to be installed on your system
- [RtMidi](https://www.music.mcgill.ca/~gary/rtmidi/index.html) - included in the source
- [teVirtualMIDI SDK](https://www.tobias-erichsen.de/software/virtualmidi.html) - needs to be installed on your system
- [Boost program_options](https://www.boost.org/doc/libs/1_76_0/doc/html/program_options.html) - install boost on your system or use vcpkg
## Building
The project uses CMake to build. You need to have the NDI SDK and teVirtualMIDI SDK installed on your system and the `.lib` files and `.dll` files set in `CMakeLists.txt.`
```bash
cmake -B build -S .
```
```bash
cmake --build build --parallel --config Debug
call .\build\bin\Debug\midi_to_ndi.exe
```
or
```bash
cmake --build build --parallel --config Release
call .\build\bin\Release\midi_to_ndi.exe
```