OmniMIDI v2 (15.0+)

New codebase for OmniMIDI, completely rewritten from scratch using code laid down through various tests in the Shakra branch.

Why a new branch?

Two reasons; the old code was too bloated, and I wanted to completely move the new release as far away from it as possible.

This code has been written completely in C++, instead of taping random code on top of the already unstable C code from OmniMIDI v1 (pre 15.0). This will get rid of all the issues that have been plaguing the old branch so far, while also making the code more readable by normal human beings. I became unable to read my own code in there...

Why not Rust?

I feel like I should probably get to know C++ more, before moving to Rust. A Rust rewrite is not out of the question though! Maybe someday.

What are the main differences between v1 and v2?

Here are the main differences:

• v2 is pure C++ code. (Duh!)
• Written with modularity in mind, to allow other developers to take full advantage of it (Modules support!) and...
• ... support for more operating systems other than Windows, and more architectures other than i386 and AMD64, thanks to a built-in implementation of TinySoundFont! (Both a WinRT ARM32 and Linux AMD64 release have been tested internally so far.)

What's present in the driver so far?

Here's what available with OmniMIDI v2 so far.

• ✔️ Driver (Uh...)
  • ✔️ Support for Windows and Linux
  • ✔️ Modular synthesizer system, with built-in support for:
    • ✔️ BASSMIDI (With support for WASAPI, ASIO and DirectSound)
    • ✔️ FluidSynth
    • ✔️ XSynth
  • ❌ Events parser overrides (change note length, ignore events etc...)
  • ✔️ Support for hot reload of settings or SoundFont lists
  • ❌ MIDI Feedback feature
  • ✔️* Blacklist system
  • ✔️ Audio limiter (anti-clipping)
  • ✔️ WinMMWRP support
• ❌ Configurator
• ❌ MIDI channel mixer
• ✔️ Debug window

How to compile

This guide will help you set up your environment and compile OmniMIDI v2 from source.

Prerequisites

• Xmake
• A GCC C++ compiler (MinGW or Clang)
• Git

Steps

1. Install Xmake

   You can install Xmake by following its online guide: https://xmake.io/mirror/guide/installation.html

2. Download the compiler

   Download either MinGW or Clang, then extract and place it somewhere accessible (e.g., F:\Compilers\MinGW)

3. Clone the repo

   Clone the repo somewhere on your device:

   git clone https://github.com/KeppySoftware/OmniMIDIv2.git

4. Prepare the project

   Open a terminal on the newly cloned repo, and navigate to the project's directory:

   cd OmniMIDI

   Then prepare the project for the compile process, and compile it.
   Replace with the full path to your compiler's SDK:

   xmake f -m release --sdk=<pathtosdk>
   xmake

5. Test the build

   Test the build against something that can use it (WinMM under Win32, ALSAMIDI under Linux, KDMAPI for both).

   If you're under Linux, and you want to test the newly created build against a KDMAPI test app, remember to export the build's directory as a valid library loading path, by calling export LD_LIBRARY_PATH=$PWD in the terminal.

Future of KDMAPI

Keppy's Direct MIDI API, introduced in OmniMIDI v1, will continue to be supported in OmniMIDI v2.
I will make sure old applications will still be able to communicate with v2, but it will definitely be deprecated in favor of a better API implementation with a better name. To be continued...

Will it work on my Pentium 4 PC with Windows XP...

Stop asking. No.