README.md

AGraph

AGraph is a graph based audio processing library for Go! Inspired from implementing binaural audio virtualization with Libavfilter and frustrated by the severe lack of audio processing libraries for Go, I decided to make my own.

Usage

Using this library is simple, all you need to do is initialize filter nodes, connect them, start each node, then feed your pulse code modulated (PCM) wave data into the first sink. Below is an example of creating an audio file reader, setting up a graph with a convolution filter and a volume filter, and pumping data through it.

reader, err := agraph.NewWaveReader(file)
if err != nil {
	fmt.Println(err)
}

firNode, _ := agraph.NewNode(agraph.firFilter, "finite impulse response")
delayNode, _ := agraph.NewNode(agraph.delayFilter, "delay")

firNode.SetSink(delayNode.Source())
delayNode.SetSink(make(chan []float64, agraph.SOURCE_SIZE)

go firNode.Process()
go delayNode.Process()

for {
    data, err := reader.ReadSampleFloat()
    if err ! nil {
        fmt.Error(err)
        break
    }

    firNode.Source() <- data
    filteredData = <- delayNode.Sink()
}

Todo

• wave file reading
• wave file writing
• Convolution filter
• Delay Filter
• Finite Impulse Response filter
• volume filter (was the first filter, so is technically not correct in many ways)
• leaky integrator filter
• FFT
• some frequency domain filters