nilslice / phono Goto Github PK

phono is a framework for floating point signal processing. It utilizes pipeline pattern to build fast, asynchronomous and easy-to-extend pipes for sound processing. Each pipe consists of one Pump, zero or multiple Processors and one or more Sinks. Phono also offers a friendly API for new pipe components implementations.

Find examples in phono/_example package:

• Read wav file and play it with portaudio link
• Read wav file, process it with vst2 plugin and save to another wav file link
• Read two wav files, mix them and save result into new wav file link
• Read wav file, sample it, compose track, save result into wav file link

Please, note that since phono is in active development stage, all packages are in experimental state. One of the main focus points is the stability of all listed and future packages.

1. phono/wav - Pump and Sink to read/write files
2. phono/vst2 - Processor to utilize plugins
3. phono/mixer - simple mixer without balance and volume settings, Sink for inputs and Pump for output
4. phono/asset - structures to reuse Buffers
5. phono/track - Sink for sequential reads of asset and its slices
6. phono/portaudio - Sink for playback

phono/vst2 and portaudio packages do have external non-go dependencies. To use these packages, please check the documentation:

• vst2
• portaudio

phono/mock package can be used to test custom Pumps, Processors and Sinks. It allows to mock up pipe elements and then assert the data metrics.

phono/wav package contains Pump and Sink which allows to read/write wav files respectively. Its test is a good example of phono/mock package in use.

For a complete guide to contributing to phono, see the Contribution giude