Pyo - Python DSP module

pyo is a Python module written in C to help digital signal processing scriptcreation.

pyo is a Python module containing classes for a wide variety of audio signalprocessing types. With pyo, user will be able to include signal processingchains directly in Python scripts or projects, and to manipulate them in realtime through the interpreter. Tools in pyo module offer primitives, likemathematical operations on audio signal, basic signal processing (filters,delays, synthesis generators, etc.), but also complex algorithms to createsound granulation and others creative audio manipulations. pyo supports OSCprotocol (Open Sound Control), to ease communications between softwares, andMIDI protocol, for generating sound events and controlling process parameters.pyo allows creation of sophisticated signal processing chains with all thebenefits of a mature, and widely used, general programming language.

Systems : macOS (10.10+), linux, Windows (XP, Vista, 7, 8, 10)

Python versions : 2.7 (up to 1.0.1), 3.5 (up to 1.0.1), 3.6, 3.7, 3.8, 3.9.

For more resources, informations and documentation, visit thePYO OFFICIAL WEB SITE.

How to install pre-built packages on any platform using pip:INSTALL Instructions.

How to get pyo running from sources on macOS and linux:COMPILE Instructions.

pyo was awarded second prize in theLomus 2012 Free Software Competition.

You want to help the development of pyo ? Go to thepyo features marketand make a donation for the feature you want to promote. You can also submit newfeatures on the mailing-list ( pyo-discuss@googlegroups.com ).

Radio Pyo

If you want to listen to scripts rendered in real-time, just connect toRadio Pyo !

You want to have your script played on the radio ? Download the templateradiopyo_template.py,follow the rules and post it on the mailing-list !

Software using Pyo as audio engine

Cecilia 5 : An audio signalprocessing environment.

PsychoPy : An open-source application to allow thepresentation of stimuli and collection of data for a wide range of neuroscience,psychology and psychophysics experiments.

Soundgrain :A graphical interface where users can draw and edit trajectories to controlgranular sound synthesis.

Zyne : A modular soft synthesizer.

Pyo Synth : Pyo Synth is an opensource application that makes the manipulation of pyo scripts easier by lettingyou control it with a midi keyboard.

Examples

pyo is fully integrated to Python and very simple to use.

Play a sound:

>>> from pyo import *
>>> s = Server().boot()
>>> s.start()
>>> sf = SfPlayer("path/to/your/sound.aif", speed=1, loop=True).out()

Granulate an audio buffer:

>>> s = Server().boot()
>>> s.start()
>>> snd = SndTable("path/to/your/sound.aif")
>>> env = HannTable()
>>> pos = Phasor(freq=snd.getRate()*.25, mul=snd.getSize())
>>> dur = Noise(mul=.001, add=.1)
>>> g = Granulator(snd, env, [1, 1.001], pos, dur, 24, mul=.1).out()

Generate melodies:

>>> s = Server().boot()
>>> s.start()
>>> wav = SquareTable()
>>> env = CosTable([(0,0), (100,1), (500,.3), (8191,0)])
>>> met = Metro(.125, 12).play()
>>> amp = TrigEnv(met, table=env, mul=.1)
>>> pit = TrigXnoiseMidi(met, dist='loopseg', x1=20, scale=1, mrange=(48,84))
>>> out = Osc(table=wav, freq=pit, mul=amp).out()

Donation

This project is developed by Olivier Bélanger on his free time to provide afully integrated Python dsp module for sound exploration and music composition.If you feel this project is useful to you and want to support it and it'sfuture development please consider donating money. I only ask for a smalldonation, but of course I appreciate any amount.