Awesome

Tuning Library Python bindings

Python bindings for the Surge Synth Team Tuning Library.

Installation

To install from PyPI:

$ pip install tuning-library

or to clone the repo and install from source:

$ git clone --recurse-submodules https://github.com/surge-synthesizer/tuning-library-python.git
$ cd tuning-library-python
$ python3 -m pip install .

Examples

Read scl file and find frequency of midi note 69

import tuning_library as tl

scale = tl.read_scl_file("scale.scl")
tuning = tl.Tuning(scale)
f = tuning.frequency_for_midi_note(69)

Read scl and kbm files and find frequency of midi note 69

import tuning_library as tl

scale = tl.read_scl_file("scale.scl")
mapping = tl.read_kbm_file("mapping.kbm")
tuning = tl.Tuning(scale, mapping)
f = tuning.frequency_for_midi_note(69)

There are some scripts which use tuning_library in the examples directory in the repo.

Wrapper names

The names in the C++ Tuning Library and this Python wrapper correspond as follows

Extra

The tuning_library Python package also includes a scala_files_to_frequencies convenience function which is not in the C++ library. It can be called as

import tuning_library as tl

frequencies = tl.scala_files_to_frequencies("scale.scl", "mapping.kbm")

or, using a default keyboard mapping,

frequencies = tl.scala_files_to_frequencies("scale.scl")

and returns a list of 128 frequencies in Hz, one for each each midi note.