This project aims to create a modular synthesizer. Like those encountered in projects like VCVRack or Bitwigs Polygrid.
The core idea is having a hexagonal tile map for laying out module instances and connect them at the edges to route audio signals and control signals to inputs of other modules.
A goal is to provide a simple wireless environment to build sound effects, synthesizers or whole generative music patches from predefined modules.
Hosting plugins (VST, LV2, ...) is out of the scope of this project. The goal is rather to have a good set of predefined modules.
Here is a screenshot of how it looks:
This project is still (2021-08-03) under heavy development and is considered alpha stage. There are only few nodes (aka modules) implemented yet. The interface is mostly functional though. But not tested in all hosts yet and there are known bugs.
Make sure to follow Weird Constructors Mastodon account or the releases of this project to be notified once I release a beta or stable release.
- A useable GUI with highly features parameter knobs and a hexagonal module/node matrix that is easily changeable with the mouse.
- Serialization/Deserialization of patches (even though the UI for patch/preset management has not been implemented yet, except a "Save" button).
- Signal monitors for the selected node.
- Per node and output signal feedback LEDs.
- A simple Tracker to edit "TSeq" sequences.
- A primitive sample selection browser.
And following DSP nodes:
Category | Name | Function |
---|---|---|
IO Util | Out | Audio output (to DAW or Jack) |
Osc | Sampl | Sample player |
Osc | Sin | Sine oscillator |
Osc | BOsc | Basic bandlimited waveform oscillator (waveforms: Sin, Tri, Saw, Pulse/Square) |
Osc | VOsc | Vector phase shaping oscillator |
Osc | Noise | Noise oscillator |
Signal | Amp | Amplifier/Attenuator |
Signal | SFilter | Simple collection of filters, useable for synthesis |
Signal | Delay | Single tap signal delay |
Signal | PVerb | Reverb node, based on Dattorros plate reverb algorithm |
Signal | AllP | All-Pass filter based on internal delay line feedback |
Signal | Comb | Comb filter |
N->M | Mix3 | 3 channel mixer |
N->M | Mux9 | 9 channel to 1 output multiplexer/switch |
Ctrl | SMap | Simple control signal mapper |
Ctrl | Map | Control signal mapper |
Ctrl | CQnt | Control signal pitch quantizer |
Ctrl | Quant | Pitch signal quantizer |
Mod | TSeq | Tracker/pattern sequencer |
Mod | Ad | Attack-Decay envelope |
Mod | TsLFO | Tri/Saw waveform low frequency oscillator (LFO) |
Mod | RndWk | Random walker, a Sample & Hold noise generator |
IO Util | FbWr / FbRd | Utility modules for feedback in patches |
I have a pretty detailed TODO list in my private notebook, but this is the rough road map:
- DONE: Make a UI that is more or less fluently usable and easily extendable with new modules.
- DONE: Take a bit of care that there is online help.
- DONE: Factor out the DSP code into it's own crate.
- Add preset/patch management to the UI.
- Add lots (many more than above listed) of modules (Oscillators, Filters, Envelopes, LFOs, Quantizers, ...).
- Add a MIDI-Ctrl interface for receiving pitch control signals, gate and clock from the DAW
- Add parameter input node for receiving automation from the DAW
- Add audio inputs for receiving audio from the DAW
- Comment the code for easier maintenance.
You need nightly rust:
rustup toolchain install nightly
You might need following dependencies (Ubuntu Linux):
sudo apt install libjack0 libjack-jackd2-dev qjackctl libx11-xcb-dev
sudo apt install libxcb-icccm4-dev libxcb-dri3-dev
You might need following dependencies (Ubuntu 20.04 Linux):
sudo apt install libgl1-mesa-dev libjack-jackd2-dev qjackctl libxcursor-dev
sudo apt install libx11-xcb-dev libxcb-icccm4-dev libxcb-dri2-0-dev libxcb-dri3-dev
These might work on Debian too:
sudo apt install libjack0 libjack-dev libx11-xcb-dev libxcb-icccm4-dev libxcb-dri2-dev
Enter the vst2
subdirectory:
hexosynth/$ cd vst2
Compile:
hexosynth/vst2/$ cargo +nightly build --release
Install:
heyosynth/vst2/$ cp target/release/libhexosynth_vst.so ~/.vst/
Enter the jack_standalone
subdirectory:
hexosynth/$ cd jack_standalone
Compile and run:
hexosynth/jack_standlone/$ cargo +nightly run --release --example standalone
Please consult HexoDSP for the DSP test suite, and the gui_tests sub directory for the GUI related test suite:
hexosynth/$ cd gui_tests
hexosynth/gui_tests/$ cargo run --release
As of 2021-07-24 HexoSynth has been tested with:
- Windows 10 and Ableton Live: It starts, and you can use it via the mouse.
The keyboard handling is not working properly though.
- Windows 10 and Renoise: It starts. But keyboard handling does not work.
- Ubuntu Linux 20.04 and Renoise: Works
- Ubuntu Linux 20.04 and Ardour: Works
- Ubuntu Linux 20.04 and Carla: Works
- Ubuntu Linux 20.04 and Bitwig: Works
- The ones you encounter and create as issues on GitHub.
I currently have a quite precise vision of what I want to achieve and my goal is to make music with this project eventually.
The projects is still young, and I currently don't have that much time to devote for project coordination. So please don't be offended if your issue rots in the GitHub issue tracker, or your pull requests is left dangling around for ages.
I might merge pull requests if I find the time and think that the contributions are in line with my vision.
Please bear in mind, that I can only accept contributions under the License of this project (AGPLv3 or later).
You can reach me via Discord ( WeirdConstructor#7936 ), Mastodon (
@weirdconstructor@mastodon.online ) or IRC. I'm joined most public Rust Discord
servers, especially the "Rust Audio" Discord server. And I am also on IRC on
the network Libera.Chat in the #lad
channel (nick wct
).
You can support me (and the development of this project) via Liberapay:
This project is licensed under the GNU General Public License Version 3 or later.
The fonts DejaVuSerif.ttf and DejaVuSansMono.ttf under the license:
Fonts are (c) Bitstream (see below). DejaVu changes are in public domain.
Glyphs imported from Arev fonts are (c) Tavmjong Bah (see below)
Picking a license for my code bothered me for a long time. I read many discussions about this topic. Read the license explanations. And discussed this matter with other developers.
First about why I write code for free at all, the reasons are:
- It's my passion to write computer programs. In my free time I can write the code I want, when I want and the way I want. I can freely allocate my time and freely choose the projects I want to work on.
- To help a friend or member of my family.
- To solve a problem I have.
- To learn something new.
Those are the reasons why I write code for free. Now the reasons why I publish the code, when I could as well keep it to myself:
- So that it may bring value to users and the free software community.
- Show my work as an artist.
- To get into contact with other developers.
- To exchange knowledge and help other developers.
- And it's a nice change to put some more polish on my private projects.
Most of those reasons don't yet justify GPL. The main point of the GPL, as far as I understand: The GPL makes sure the software stays free software until eternity. That the end user of the software always stays in control. That the users have the means to adapt the software to new platforms or use cases. Even if the original authors don't maintain the software anymore. It ultimately prevents "vendor lock in". I really dislike vendor lock in, especially as developer. Especially as developer I want and need to stay in control of the computers and software I use.
Another point is, that my work (and the work of any other developer) has a value. If I give away my work without any strings attached, I effectively work for free. This compromises the price I (and potentially other developers) can demand for the skill, workforce and time.
This makes two reasons for me to choose the GPL:
- I do not want to support vendor lock in scenarios for free. I want to prevent those when I have a choice, when I invest my private time to bring value to the end users.
- I don't want to low ball my own (and other developer's) wage and prices by giving away the work I spent my scarce private time on with no strings attached. I do not want companies to be able to use it in closed source projects to drive a vendor lock in scenario.
We can discuss relicensing of my code or project if you are interested in using it in a closed source project. Bear in mind, that I can only relicense the parts of the project I wrote. If the project contains GPL code from other projects and authors, I can't relicense it.