Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Axiom Build Status

Picture of a synth built in Axiom

A synth built in the current version of Axiom

Axiom is an extremely flexible node-based realtime audio synthesizer. It was originally designed for size-constrained environments such as PC intros in the demoscene, but is entirely open source and is becoming an excellent free tool for any musician.

Axiom's a bit afk at the moment, I've been preparing for a big redesign/rewrite but haven't had much time to put towards it or bugfixing recently. Contributions are still welcome as always :)

Features:

  • Musician-friendly (ie knobs and sliders) interface
  • Highly customizable and flexible through a node editor and Maxim, a custom scripting language
  • Export to replayer with no dependencies (not even the standard library)
  • Use any DAW with VSTi support for note editing and automation

There are currently pre-packaged versions available for Windows and macOS (alpha, let us know of any issues) on the Releases page. Stay tuned for Linux builds!

Usage Guide · Example Projects · Downloads & Release Notes

Backends

Axiom currently supports the following audio backends:

  • Standalone editor - doesn't require a DAW or host, allowing experimentation with the editor. MIDI can be input from a MIDI device, or by pressing keys on a regular computer keyboard.
  • VST2 - runs in a VST host as an instrument or effect, with support for side-chaining and multiple inputs/outputs.
  • Other backends such as VST3 are planned

Building

Axiom is built with CMake. The build process depends on Cargo, Qt 5.10+, LLVM 6, and the VST 2 SDK (for the VST2 backend), so make sure those are installed and setup correctly. You can download the VST 2 SDK from Steinberg's website, the other libraries can likely be found in your system's package manager, or from their respective websites.

Once Cargo, Qt, LLVM, and the VST SDK are installed, go to the directory where you'd like to build Axiom to. Then run the following command:

cmake ../path/to/source -DVST2_SDK_ROOT=/path/to/vst/sdk

If you want to build it statically-linked, pass the AXIOM_STATIC_LINK flag:

cmake ../path/to/source -DAXIOM_STATIC_LINK=ON -DVST2_SDK_ROOT=/path/to/vst/sdk

CMake will setup files necessary for building. If this fails, make sure you've got Cargo, Qt, LLVM, and the VST SDK installed correctly. Once complete, you can choose which backend to build:

VST2 Instrument & VST2 Effect

  • To build the VST2 instrument backend, use the following command. Make sure you provided a path to the VST SDK in the command above.
cmake --build ./ --target axiom_vst2_instrument
  • You can also build the VST2 effect with the axiom_vst2_effect target.
cmake --build ./ --target axiom_vst2_effect

Standalone

  • To build the standalone version as an executable, use the following command. The standalone optionally depends on PortAudio and PortMidi: without PortAudio nodes will not be simulated and audio will not be output, without PortMidi MIDI devices cannot be used for input.
cmake --build ./ --target axiom_standalone

Development

Axiom is comprised of several components:

  • The VST Editor, written with Qt and the VST SDK. This is the only part the user directly interacts with, and must be OS-independent.
  • The Maxim language compiler and runtime, written in Rust with LLVM and statically linked into the editor.
  • The replayer, coming soon.

License

Licensed under the MIT license. See the LICENSE file in the repository for more details.

About

A powerful realtime node-based audio synthesizer.

Topics

Resources

License

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •