Module `audioio.audiomodules`

Query and control installation status and availability of audio modules.

list_modules() and installed_modules() let you query which audio modules are currently installed on your system.

Call missing_modules() for a list of module names that should be installed. The missing_modules_instructions() function prints installation instructions for packages you should install for better performance. For installation instructions on a specific module use installation_instruction().

By default all installed modules are used by the audioio functions. The disable_module(), enable_module() and select_module() functions allow to control which of the installed audio modules should be used by the audioio functions.

list_modules(), available_modules() and unavailable_modules() let you query which audio modules are installed and available and which modules are not available on your system.

Functions

installed_modules(): installed audio modules.
available_modules(): installed and enabled audio modules.
unavailable_modules(): audio modules that are not installed and not enabled.
disable_module(): disable audio module.
enable_module(): enable audio modules provided they are installed.
select_module(): select (enable) a single audio module and disable all others.
list_modules(): print list of all supported modules and their installation status.
missing_modules(): missing audio modules that are recommended to be installed.
missing_modules_instructions(): print installation instructions for missing but useful audio modules.
installation_instruction(): instructions on how to install a specific audio module.
main(): command line program for listing installation status of audio modules.

Command line script

Run this module as a script

> python -m src.audioio.auidomodules

or, when the audioio package is installed on your system, simply run

> audiomodules

for an overview of audio packages, their installation status, and recommendations on how to install further audio packages. The output looks like this:

Status of audio packages on this machine:
-----------------------------------------

wave              is  installed (F)
ewave             is  installed (F)
scipy.io.wavfile  is  installed (F)
soundfile         is  installed (F)
wavefile          is  installed (F)
audioread         is  installed (F)
pyaudio           is  installed (D)
sounddevice       not installed (D)
simpleaudio       is  installed (D)
soundcard         is  installed (D)
ossaudiodev       is  installed (D)
winsound          not installed (D)

F: file I/O, D: audio device

There is no need to install additional audio packages.

For instructions on specific packages, run audiomodules with the name of the package supplied as argument:

> audiomodules soundfile

This produces something like this:

...
Installation instructions for the soundfile module:
---------------------------------------------------
The soundfile package is a wrapper of the sndfile library,
that supports many different audio file formats.
See http://python-soundfile.readthedocs.org for a documentation of the soundfile python wrapper
and http://www.mega-nerd.com/libsndfile for details on the sndfile library.

First, install the following packages:

sudo apt install libsndfile1 libsndfile1-dev libffi-dev

Install the soundfile module with pip:

sudo pip install SoundFile

or alternatively from your distribution's package:

sudo apt install python3-soundfile

Running

audiomodules --help

prints

usage: audiomodules [--version] [--help] [PACKAGE]

Installation status and instructions of python audio packages.

optional arguments:
  --help      show this help message and exit
  --version   show version number and exit
  PACKAGE     show installation instructions for PACKAGE

version 2.2.0 by Benda-Lab (2015-2024)

Links

For an overview on python modules regarding file I/O see, for example, http://nbviewer.jupyter.org/github/mgeier/python-audio/blob/master/audio-files/index.ipynb

For an overview on packages for playing and recording audio, see https://realpython.com/playing-and-recording-sound-python/

Global variables

var audio_modules: Dictionary with availability of various audio modules. Keys are the module names, values are booleans. Based on this dictionary audioio employs functions of installed audio modules.
var audio_installed: List of installed audio modules.
var audio_infos: Dictionary with information about all supported audio modules. Keys are the module names, values are the informations.
var audio_instructions_linux: Dictionary with general installation instructions for linux that are needed in addition to installing some packages. Keys are the module names, values are the instructions.
var audio_instructions_windows: Dictionary with general installation instructions for windows that are needed in addition to installing some packages. Keys are the module names, values are the instructions.
var audio_pip_packages: Dictionary with pip package names of the audio modules. Keys are the module names, values are pip package names.
var audio_conda_packages: Dictionary with conda package names of the audio modules. Keys are the module names, values are conda package names, optionally with a channel specification.
var audio_deb_packages: Dictionary with Linux DEB packages of the audio modules. Keys are the module names, values are the package names.
var audio_rpm_packages: Dictionary with Linux RPM packages of the audio modules. Keys are the module names, values are the package names.
var audio_brew_packages: Dictionary with macOS homebrew packages of the audio modules. Keys are the module names, values are the package (formulae) names.
var audio_required_deb_packages: Dictionary with Linux DEB packages required for the audio modules. Keys are the module names, values are lists of string with package names.
var audio_required_rpm_packages: Dictionary with Linux RPM packages required for the audio modules. Keys are the module names, values are lists of string with package names.
var audio_required_brew_packages: Dictionary with macOS homebrew packages required for the audio modules. Keys are the module names, values are lists of string with package (formulae) names.
var audio_fileio: List of audio modules used for reading and writing audio files.
var audio_device: List of audio modules used for playing and recording sounds on audio devices.

Functions

def installed_modules(func='all')

Installed audio modules.

By default all installed modules are available. With disable_module(), enable_module() and select_module() the availability of installed modules can be controlled.

Parameters

func : string: 'all': all installed audio modules. 'fileio': installed audio modules used for file I/O. 'device': installed audio modules used for playing and recording sounds.

Returns

mods : list of strings: List of installed audio modules of the requested function.

Parameters

func : string: 'all': all installed audio modules. 'fileio': installed audio modules used for file I/O. 'device': installed audio modules used for playing and recording sounds.

Returns

mods : list of strings: List of available, i.e. installed and enabled, audio modules of the requested function.

def unavailable_modules(func='all')

Audio modules that are not installed and not enabled.

Parameters

func : string: 'all': all installed audio modules. 'fileio': installed audio modules used for file I/O. 'device': installed audio modules used for playing and recording sounds.

Returns

mods : list of strings: List of not available, i.e. not installed and not enabled, audio modules of the requested function.

def disable_module(module=None)

Disable an audio module.

A disabled module is not used by the audioio functions and classes. To disable all modules except one, call select_module().

Parameters

module : string or None: Name of the module to be disabled as it appears in available_modules(). If None disable all installed audio modules.

Parameters

module : string or None: Name of the module to be (re)enabled. If None enable all installed audio modules.

Parameters

module : string: Name of the module to be selected.

Returns

selected : bool: False if the module can not be selected, because it is not installed. In this case the other modules are not disabled.

Parameters

module : string: If 'all' list all modules. If 'fileio' list all modules used for file I/O. If 'device' list all modules used for playing and recording sounds. Otherwise list only the specified module.
availability : bool: Mark availability of each module by an asterisk.

Parameters

func : string: 'all': missing audio modules of all functions. 'fileio': missing audio modules for file I/O. 'device': missing audio modules for playing and recording sounds.

Returns

mods : list of strings: List of missing audio modules of the requested function.

def missing_modules_instructions(func='all')

Print installation instructions for missing but useful audio modules.

Parameters

func : string: 'all': missing audio modules of all functions. 'fileio': missing audio modules for file I/O. 'device': missing audio modules for playing and recording sounds.

def installation_instruction(module)

Instructions on how to install a specific audio module.

Parameters

module : string: The name of the module for which an instruction should be printed.

Returns

msg : multi-line string: Installation instruction for the requested module.

def main(*args)

Command line program for listing installation status of audio modules.

Run this module as a script

> python -m src.audioio.auidomodules

or, when the audioio package is installed on your system, simply run

> audiomodules

for an overview of audio packages, their installation status, and recommendations on how to install further audio packages.

The '–help' argument prints out a help message:

> audiomodules --help

Parameters

args : list of strings: Command line arguments as provided by sys.argv[1:]

Module `audioio.audiomodules`

Functions

Command line script

Links

Global variables

Functions

Parameters

Returns

See Also

Parameters

Returns

Parameters

Returns

Parameters

See Also

Parameters

See Also

Parameters

Returns

See Also

Parameters

See Also

Parameters

Returns

Parameters

Parameters

Returns

Parameters