14.5 wave -- Read and write WAV files
Keywords: lib

# 14.5 `wave` -- Read and write WAV files

The `wave` module provides a convenient interface to the WAV sound format. It does not support compression/decompression, but it does support mono/stereo.

The `wave` module defines the following function and exception:

`open`(file[, mode])
  If file is a string, open the file by that name, other treat it as a seekable file-like object. mode can be any of
  `'r'`, `'rb'`
    Read only mode.
  `'w'`, `'wb'`
    Write only mode.
  Note that it does not allow read/write WAV files.

  A mode of `'r'` or `'rb'` returns a `Wave_read` object, while a mode of `'w'` or `'wb'` returns a `Wave_write` object. If mode is omitted and a file-like object is passed as file, `file.mode` is used as the default value for mode (the "`b`" flag is still added if necessary).

`openfp`(file, mode)
  A synonym for `open()`, maintained for backwards compatibility.

exception `Error`
  An error raised when something is impossible because it violates the WAV specification or hits an implementation deficiency.

Subsections

- 14.5.1 Wave_read Objects
- 14.5.2 Wave_write Objects