Skip to content

Releases

Manguebyte 0.2.0

Choose a tag to compare

@alessonqueirozdev-hub alessonqueirozdev-hub released this 13 Nov 11:27

The second release of the Manguebyte Audio Framework on crates.io: 27 crates. Two of them are new:

  • manguebyte-state: application state with undo and redo;
  • manguebyte-ump-io: MIDI 2.0 sent through the system's own Universal MIDI Packet output.
[dependencies]
manguebyte = "0.2"

Before 1.0, a minor version may break the API. The Breaking section of the changelog lists what code written against 0.1.0 may need.

What is new

  • Several cores in one audio callback: RenderPool renders independent jobs on a fixed set of workers, such as voices, organ divisions or effect chains. The output is bit for bit that of one thread (ADR 0015). A governor keeps an instrument inside the block's deadline.

  • SIMD on slices of samples (manguebyte_core::vector). Convolution, FIR filters and WAV conversion now run on it.

  • DSP:

    • tunings for every voice of the synth and the sampler;
    • additive partial banks;
    • an organ's acoustic space;
    • spectral processing by overlap-add;
    • new effects: bitcrusher, tremolo, auto-pan, ring modulator, frequency shifter, stereo widener, transient shaper, multiband compressor, tape saturation, vocoder, granular delay and formant filter.
  • Formats: an Ogg Opus encoder for the CELT layer, written from RFC 6716.

  • Sampler:

    • a filter per region;
    • SFZ controller modulation;
    • streaming from disk (ADR 0014), with lossless compression in memory;
    • releases chosen by how long a note was held.
  • Timeline: a tempo map and a transport clock. The standalone runner has a real transport, and the CLAP wrapper reads the host's position.

  • Plugins:

    • auxiliary output buses (ADR 0017);
    • parameter names that change at run time (ADR 0020);
    • identity at run time (ADR 0012);
    • channel layouts and 64-bit audio;
    • more CLAP extensions and tail reporting;
    • notes out of AU and LV2;
    • device and MIDI settings for standalone plugins (ADR 0021).
  • Hosting:

    • Audio Unit v2 plugins;
    • the editors of hosted CLAP and VST 3 plugins;
    • auxiliary buses and notes from hosted plugins.
  • User interface:

    • zoom to fit;
    • shadows and motion;
    • a restyled widget set;
    • scroll and list views, drag and drop inside the interface, and file drops and file dialogs;
    • tabs, sidebars, dialogs and floating panels;
    • waveform, piano keyboard, envelope, zone map, pitch and mod wheels, and wavetable views;
    • an audio settings view.

    Each is tested headless.

  • Devices:

    • MIDI 2.0 out through CoreMIDI and the ALSA sequencer;
    • a preview of what a device setup would open;
    • a wait-free MIDI output queue from the audio thread.

Every item says where it stops, either in the changelog or in docs/TECH_DEBT.md.

The full list is in the CHANGELOG. What comes next is in the ROADMAP.

Manguebyte 0.1.0

Choose a tag to compare

@alessonqueirozdev-hub alessonqueirozdev-hub released this 19 Oct 19:29

The first release of the Manguebyte Audio Framework on crates.io: 25 crates for real-time audio in Rust. Every crate is under MIT or Apache-2.0, except the opt-in manguebyte-pro-io, which is under the GPLv3.

[dependencies]
manguebyte = "0.1"
cargo install cargo-mangue
cargo mangue new my-gain

What is in it

  • Plugins from one Plugin: CLAP, VST 3, Audio Unit v2, LV2 and a standalone app.
    • CLAP and VST 3 pass their projects' validators in CI, and AU passes Apple's auval.
    • cargo mangue bundles, installs and validates them.
  • Hosting CLAP, VST 3 and LV2 plugins made by anyone, with plugin scanning run out of process.
  • DSP and ready-to-play instruments:
    • filters and effects, oversampling, FFT of any length;
    • a polyphonic synth with 68 presets;
    • drum machines and an acoustic kit;
    • physically modelled strings, winds, mallets and choir;
    • Brazilian percussion.
  • Audio files: WAV, AIFF, FLAC, Ogg Vorbis and MP3 are read and written, and Opus and MPEG I/II are read, all with exact seeking.
  • Devices: WASAPI, CoreAudio, ALSA, JACK and AAudio.
    • Hot swap: change the audio device in the middle of a song without stopping or preparing again.
    • ASIO comes through your own SDK, or through the GPLv3 manguebyte-pro-io.
  • MIDI: MIDI 1.0, MPE and MIDI 2.0 in and out, MIDI-CI, and per-note expression; also OSC.
  • In the browser: manguebyte-web, the engine of the Aratu live-coding language.
    • The Aratu Bridge plugin plays an Aratu session inside a DAW, in time with the DAW's transport.

What tests enforce on every commit

  • Sample-accurate automation: every change lands on its exact frame.
  • Block-size independence: a song rendered with six block patterns matches bit for bit.
  • No allocation on the audio thread: a counting allocator fails CI if any processor or wrapper touches the heap.

docs/BEYOND_JUCE.md lists 17 places where Manguebyte goes beyond JUCE, each with its test.

Not there yet

  • Plugin editors open on Windows only.
  • No AUv3 and no AAX.
  • No Opus encoding.
  • No hosting of AU plugins.

The API will change before 1.0. See the ROADMAP and the open issues. Some are marked good first issue.

The full list of changes is in the CHANGELOG.