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.0
To compile it, simply run:
omni Sine.omni
Check omni's website.