Skip to main content

A wrapper for the MAD (mpeg audio decoder) library.

Project description

pymad - a Python wrapper for the MPEG Audio Decoder library

ci pymad is a Python module that allows Python programs to use the MPEG Audio Decoder library. pymad provides a high-level API, similar to the pyogg module, which makes reading PCM data from MPEG audio streams a piece of cake.

MAD is available at http://www.mars.org/home/rob/proj/mpeg/

Access this module via import mad. To decode an mp3 stream, you'll want to create a mad.MadFile object and read data from that. You can then write the data to a sound device. See the example program in test/ for a simple mp3 player that uses the python-pyao wrapper around libao for the sound device.

pymad wrapper isn't as low level as the C MAD API is, for example, you don't have to concern yourself with fixed point conversion -- this was done to make pymad easy to use.

import sys

import ao
import mad

mf = mad.MadFile(sys.argv[1])
dev = ao.AudioDevice(0, rate=mf.samplerate())
while 1:
    buf = mf.read()
    if buf is None:  # eof
        break
    dev.play(buf, len(buf))

The latest release is available for download at https://pypi.org/project/pymad/ or via pip install pymad. They're replicated on GitHub in the Releases section.

To build locally, the usual python -m build or python -m pip install . works.

The tests require manual interaction (because you want to listen to the decoded output) and requires PyAO on Linux.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pymad-0.11.3.tar.gz (30.1 kB view details)

Uploaded Source

File details

Details for the file pymad-0.11.3.tar.gz.

File metadata

  • Download URL: pymad-0.11.3.tar.gz
  • Upload date:
  • Size: 30.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for pymad-0.11.3.tar.gz
Algorithm Hash digest
SHA256 c5b9be3b625ce9257e07877b66b1f0bd8a957fb967d18cb2393a7e09cf6ce7aa
MD5 93fd2082fd6708be8e4d794c44f4a99a
BLAKE2b-256 69b272f62662392a9704bd4e427291cb4d8f0421e60831ac38bd860085cb123d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page