ex_jack v0.1.0

View Source ExJack

JACK audio interface for Elixir using Rustler-based NIF.

The purpose of this library is to provide an audio outlet for Elixir through all platforms. However, if you're on Linux, and don't need JACK outright, it's probably preferable to use ExAlsa and interface with ALSA directly.

requirements

 Requirements 

Tested with:
JACK 2 (see https://github.com/RustAudio/rust-jack)
Elixir 1.12
Rust 1.56.1

set-up

 Set-up

osx

 OSX 

brew install jack
brew services start jack

mix test

It may help to view what's going with JACK using a GUI like https://qjackctl.sourceforge.io/. If you want to capture sound this is simplest way to connect until an API is added to assist with this.

usage

 Usage

This is an example of piping your capture to output, be wary of feedback. You have to explicity connect your capture with "ExJackDemo:in", if you're unsure how to do this, install QJackCTL.

$ iex -s mix
> ExJack.Server.start_link(%{name: "ExJackDemo"})
> ExJack.Server.set_input_func(fn frames -> ExJack.Server.send_frames(frames) end )

todo

 TODO

road-to-stable-version-1

 Road to stable version 1

The first three are necessary to make this library useable beyond hobby projects.

  • [ ] Better support for expected frames per cycle from JACK
  • [ ] Handle variable channels with definable sources
  • [ ] Handle JACK notifications
  • [ ] Handling for cases that drop the JACK client such as underruns.
  • [ ] Additional tests in Elixir
  • [ ] Additional tests in Rust
  • [ ] MCU demo
  • [ ] Improve documentation with additional examples
  • [ ] Autocorrection for xruns

dev

 Dev

releases

 Releases

Taken from https://hexdocs.pm/rustler_precompiled/precompilation_guide.html#the-release-flow

    release a new tag
    push the code to your repository with the new tag: git push origin main --tags
    wait for all NIFs to be built
    run the mix rustler_precompiled.download task (with the flag --all)
    release the package to Hex.pm.