scikit-sound - Documentation

scikit-sound is a library for working with sound files.

It is hosted under, and contains two modules: sounds : utuilies for working with sound data misc : utilities for file- and directory selection, and for user-interaction

The module sounds has two classes:

  • sounds.Sound … reading in, and working with sounds.

  • sounds.FFMPEG_info … handling the FFMPEG installation required for working with MP3-files etc.

The class Sounds lets you

The class FFMPEG_info handles the detection of FFMPEG, and the config-information for Python:

The Python standard libraries and scipy provide good support for working with WAV files. If you also want to work with other file formats (MP3, AAC, etc), the easiest way is to install the open-source software FFMPEG on your computer. You can obtain FFMPEG for free from

For more information, please check the help on the method Sounds.sound()


The simplest way to install sksound is

>>> pip install scikit-sound

For upgrading to the latest version of sksound, you have to type

>>> pip install scikit-sound -U

However, you can also install from the source files. To do this, just go to the root directory of the package, and type

>>> python install

Note: After sksound is installed, I typically import it in Python with:

>>> import sksound


numpy, scipy, appdirs, pygame (only on Linux)


The easiest way to test the package is with unittest. Open a terminal, and type (on the command-line!):

>>> cd [_your_installation_dir_]\sksound\tests
>>> python -m unittest


Indices and tables


Author: Thomas Haslwanter
Version: 0.2.14
Date: Feb 2024
Copyright (c): 2024, Thomas Haslwanter. All rights reserved.
Licence: This work is licensed under the BSD 2-Clause License