Skip to content
Sound analysis/synthesis tools for music applications
Python Jupyter Notebook C
Branch: master
Clone or download

Latest commit

Latest commit 02517f9 Feb 11, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
assignments no change Aug 17, 2019
lectures clarified questions in E1 Jan 20, 2020
notebooks updated E4 Feb 11, 2020
software Fixed typo Oct 14, 2019
sounds removed an additional readme in sounds Nov 26, 2015
workspace Added new folder workspace_dev Aug 24, 2015
.gitignore Initial test upload of first 3 notebooks Jan 10, 2018
AUTHORS Update AUTHORS Aug 28, 2015
LICENSE Initial commit Jul 26, 2013 edited text Aug 17, 2019


Sound analysis/synthesis tools for music applications written in python (with a bit of C) plus complementary teaching materials.

How to use

In order to use these tools you have to install python (recommended 3.7.x) and the following modules: ipython, numpy, matplotlib, scipy, and cython.

In Ubuntu (which we strongly recommend) in order to install all these modules it is as simple as typing in the Terminal:

$ sudo apt-get install python-dev ipython python-numpy python-matplotlib python-scipy cython

In OSX (which we do not support but that should work) you install these modules by typing in the Terminal:

$ pip install ipython numpy matplotlib scipy cython

then, for using the tools, after downloading the whole package, you need to compile some C functions. For that you should go to the directory software/models/utilFunctions_C and type:

$ python build_ext --inplace

The basic sound analysis/synthesis functions, or models, are in the directory software/models and there is a graphical interface and individual example functions in software/models_interface. To execute the models GUI you have to go to the directory software/models_interface and type:

$ python

To execute the transformations GUI that calls various sound transformation functions go to the directory software/transformations_interface and type:

$ python

To modify the existing code, or to create your own using some of the functions, we recommend to use the workspace directory. Typically you would copy a file from software/models_interface or from software/transformations_interface to that directory, modify the code, and execute it from there (you will have to change some of the paths inside the files).

Jupyter Notebook instructions

Install Jupyter Notebook according to it's instructions

Start up jupyter notebook

$ jupyter notebook

Follow instructions appearing in the console regarding navigating your browser to the notebook


All the code is in the software directory, with subdirectories for the models, the transformations, and the interfaces. The lecture materials are in the lectures directory, the assignments related to the lectures in the assignments directory, and the sounds used for the examples and coming from are in the sounds directory.


All the software is distributed with the Affero GPL license (, the lecture slides are distributed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 (CC BY-NC-SA 4.0) license ( and the sounds in this repository are released under Creative Commons Attribution 4.0 (CC BY 4.0) license (

You can’t perform that action at this time.