Python synthesizer

• Virtual analog synthesizer.

Installation

$ pip install synthesizer

To play sounds with Player, install PyAudio as well.

$ pip install "synthesizer[audio]"

Install dependencies for PyAudio

Ubuntu

$ apt install portaudio19-dev

macOS

$ brew install portaudio

Basic usage

Play 440Hz sine wave

>>> from synthesizer import Player, Synthesizer, Waveform


>>> player = Player()
>>> player.open_stream()
>>> synthesizer = Synthesizer(osc1_waveform=Waveform.sine, osc1_volume=1.0, use_osc2=False)
# Play A4
>>> player.play_wave(synthesizer.generate_constant_wave(440.0, 3.0))

Play chord

# Play C major
>>> chord = ["C3", "E3", "G3"]
>>> player.play_wave(synthesizer.generate_chord(chord, 3.0))

# You can also specify frequencies to play just intonation
>>> chord = [440.0, 550.0, 660.0]
>>> player.play_wave(synthesizer.generate_chord(chord, 3.0))

You can use PyChord to handle chords easily.

>>> from pychord import Chord
>>> chord = Chord("Dm7/G")
>>> player.play_wave(synthesizer.generate_chord(chord.components_with_pitch(root_pitch=3), 3.0))

Attack and release

Each generated wave fades in and out (10 ms by default) to prevent click noise between notes.

>>> synthesizer = Synthesizer(osc1_waveform=Waveform.sine, attack=0.05, release=0.2)
# Disable the envelope
>>> synthesizer = Synthesizer(osc1_waveform=Waveform.sine, attack=0.0, release=0.0)

Specify audio device

>>> player.enumerate_device()
# index: 00, name: "Built-in Microphone", rate: 44100
# index: 01, name: "Built-in Output", rate: 44100
# index: 02, name: "UA-25EX 44.1kHz", rate: 44100
>>> player.open_stream(device_name="UA-25EX")

Write wav file

>>> from synthesizer import Writer
>>> writer = Writer()

>>> chord = ["C4", "E4", "G4"]
>>> wave = synthesizer.generate_chord(chord, 3.0)
>>> writer.write_wave("path/to/your.wav", wave)

Examples

play_pychord.py

Play chords using PyChord.

pip install pychord>=0.5.0
python example/play_pychord.py A C#m7 DM7 Bm7/E A

Supported OS

• macOS
• Linux

Supported versions

• Python 3.10 and above

Author

• Yuma Mihira

License

• MIT License

Links

• PyPI: https://pypi.python.org/pypi/synthesizer
• GitHub: https://github.com/yuma-m/synthesizer
• Document: https://synthesizer.readthedocs.io