Skip to main content

software sound synthesizer, audio streaming and conversion, and playback engine

Project description

saythanks Latest Version

Software sound synthesizer (FM/PWM oscillators), sound file streaming and conversion, and sound playback and mixing engine.

Pypi: synthplayer

requires Python 3.5 or newer.

No sound? Configure the correct output audio device

On some systems, the portaudio system audio library seems to report a wrong default output audio device. In this case, you may get an IOError (describing the problem). You can also get another error (or no sound output at all, without any errors at all...) If this happens, you can manually configure the output audio device that should be used:

Either set the PY_SYNTHPLAYER_AUDIO_DEVICE environment variable to the correct device number, or set the synthplayer.playback.default_audio_device parameter at the start of your code. (The environment variable has priority over the code parameter)

To find the correct device number you can use the query_devices method or type python -m sounddevice.

synthplayer.synth

A waveform synthesizer that can generate different wave form samples: sine, triangle, sawtooth, square, pulse wave, harmonics and white noise. It also supports Frequency Modulation, Pulse-width modulation, and ADSR envelopes using LFOs.

For efficiency reasons, the oscillators and filters return their waveform values in small chunks/lists instead of per individual value. When running the synthesizer with pypy the speedup is remarkable over the older version (that used single value generators).

Synth Waveforms overview

Synth GUI screenshot

synthplayer.playback

Sound playback engine. Supports multiple sound APIs, efficient sequential streaming or real-time mixing of shorter sound clips. The streaming is implemented via Python generators where the main generator essentially produces mixed sample fragments. These are written to an audio stream of one of the supported audio library backends, in this order:

synthplayer.sample

Contains the Sample class that represents a digitized sound clip. It provides a set of simple sound manipulation methods such as changing the amplitude, fading in/out, and format conversions.

synthplayer.streaming

Provides various classes to stream audio data with. Uses ffmpeg or oggdec to read/stream many different sound formats.

Example program: jukebox.box

This is a jukebox like party sound player that allows to prepare a playlist, fade from a track to the next from the list, and insert random soundbytes for added fun. The songs are queried from a backend audio file database server program.

Example program: trackmixer

You assemble rhythm samples into bars and patterns, which are then mixed. Samples have to be in .wav format but can be anything that the Python wave module understands. The 'track' files are in a simple .ini format and can be edited with any text editor. Most of the file should be self explanatory but here are a few tips:

  • Song bpm means beats per minute, which translates in how many bars are played per minute. If you put one kick/bass drum trigger in one bar, it exactly hits the specified number of beats per minute.
  • Song ticks means how many ticks (or triggers) are in one bar. More ticks means more resolution. Nice for fast hi-hats.
  • A bar is a sequence of instrument ticks (or triggers) where '.' means nothing is played at that instant, and another character such as 'x' means that the sample is played at that instant.
  • you can separate bars with whitespace for easier readability
  • pattern names are prefixed with pattern. when writing their section (ini file limitation, you can't nest things)
  • patterns can contain one or more bars per instrument (so you can have long and short patterns). However inside a pattern every instrument has to have the same number of bars.

Here is a very simple example of a track file:

[paths]
# where to find the sample files
samples = samples/

[samples]
# list your samples here
kick7 = biab_kick_7.wav
snare2 = biab_sn_2.wav
snare10 = biab_sn_10.wav
hihat2 = biab_hat_2.wav
hihat4 = biab_hat_4.wav

[song]
# basic song parameters and pattern sequence
bpm = 128
ticks = 4
patterns = pat1 pat2 pat1 pat2 outro

[pattern.pat1]
hihat2     = x.x. x.x. x.x. x.x.
snare2     = .... x... .... x...
kick7      = x... x... x... x...

[pattern.pat2]
hihat4     = x.x. x.x. x.x. x.x.
snare10    = .... .... x... x...

[pattern.outro]
hihat2     = x.x. x.x. 
hihat4     = .... x...
kick7      = .... x...

invoking the mixer

To simply mix and stream your track file to your speakers use the following command:

python trackmixer.py mytrack.ini

To load your track file and start the interactive command line interface:

python trackmixer.py -i mytrack.ini

...then type help to see what commands are available.

A few example tracks are provided, try them out! (pre-mixed output can be found in the example_mixes folder)

  • track1.ini - a short jungle-ish fragment
  • track2.ini - a somewhat longer classic rhythm loop, I guess it's in 4/4 time
  • track3.ini - an experiment with a few liquid drum'n'bass type patterns

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

synthplayer-2.3.tar.gz (44.3 kB view details)

Uploaded Source

Built Distribution

synthplayer-2.3-py3-none-any.whl (50.4 kB view details)

Uploaded Python 3

File details

Details for the file synthplayer-2.3.tar.gz.

File metadata

  • Download URL: synthplayer-2.3.tar.gz
  • Upload date:
  • Size: 44.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.7.3

File hashes

Hashes for synthplayer-2.3.tar.gz
Algorithm Hash digest
SHA256 d48fb2ffb8f9a77cb0a77e20a31e1069d97bfec90880cdd894e8af2ba92c3dc8
MD5 6b17c6d0f5080db0122bac3e2f64491d
BLAKE2b-256 90b6db041fa04276f13ec3cf9a87e2510d0f590ea5515c844479b584deb6af55

See more details on using hashes here.

File details

Details for the file synthplayer-2.3-py3-none-any.whl.

File metadata

  • Download URL: synthplayer-2.3-py3-none-any.whl
  • Upload date:
  • Size: 50.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.7.3

File hashes

Hashes for synthplayer-2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 60274bb84009dcf6619d07c0a049ce4e99b50862cd18be8ae70be0f0c6986469
MD5 192bdb7cf1c4f8dc0b394f9ec373162a
BLAKE2b-256 bbb0f0f3b6c9362cf4445e33e55f5e249d2bd22ee6c32366e8c948b46d12b164

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page