Omni is a cross-platform DSL (Domain Specific Language) for low level audio programming. It aims to be a new, expressive and easy to use programming language to code audio algorithms in.
Omni leverages nim and C to compile code to self-contained static or shared libraries that can then be loaded and used anywhere. So far, two wrappers have already been written to compile omni code to SuperCollider UGens (omnicollider), or Max 8 objects (omnimax).
Also, a basic syntax highlighting VSCode plugin is available by simply looking for omni in the Extensions Marketplace.
Note that omni only supports nim version 1.6.0. It is recommended to install it via choosenim.
To install omni, simply use the nimble package manager (it comes bundled with the nim installation):
nimble install omni -y
Once you've installed omni, the omni executable will be placed in your ~/.nimble/bin folder.
Run omni -h to get help on all the available flags.
When running the omni compiler, the output is either a static or shared library (depending on the --lib flag). Along with it, an omni.h file (depending on the --exportHeader flag) containing all the callable functions in the shared/static library will be exported.
omni ~/.nimble/pkgs/omni-0.4.2/examples/OmniSaw.omni -o:./
This command will compile an antialiased sawtooth oscillator (part of the examples) to a shared library (libOmniSaw.so/dylib/dll), together with a header file (omni.h), in the current folder.
Sine.omni
ins: 1
outs: 1
init:
phase = 0.0
sample:
incr = in1 / samplerate
out1 = sin(phase * TWOPI)
phase = (phase + incr) % 1.0To compile it, simply run:
omni Sine.omni
Check omni's website.