Skip to main content

ipyaudio

Binder NPM PyPI Release PyPI Downloads License Build Status codecov Stars

A Jupyter Widget for Web Audio Playing and Recording.


Installation

$ pip install ipyaudio

Usage

>>> !wget https://modelscope.cn/datasets/pengzhendong/filesamples/resolve/master/audio/aac/sample1.aac -O sample1.aac
>>> audio_url = "https://modelscope.cn/datasets/pengzhendong/filesamples/resolve/master/audio/aac/sample1.aac"
>>> audio_path = "sample1.aac"

Player

  • Play an audio from url

  • Play a local audio

  • Play a numpy ndarray

  • Play an audio stream

Recorder

  • Record an audio with callback function

  • Record an audio to file

Streaming lifecycle

play() and record() return their widget instances, so callers can control them directly. Async audio producers are owned by the player instead of being launched as an untracked background task:

player = ipyaudio.play(audio_stream(), rate=16_000)

await player.wait_until_done()  # propagates producer errors
# player.cancel_stream()        # stop early when needed

Recorder chunks use an acknowledged binary transport. At most one chunk is in flight between the browser and Python, which provides backpressure even though Jupyter comm sends themselves are fire-and-forget.

Metadata

Release files for ipyaudio 0.1.32

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ipyaudio 0.1.32
File Size Uploaded
ipyaudio-0.1.32.tar.gz 2.3 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for ipyaudio 0.1.32
File Interpreter ABI Platform
ipyaudio-0.1.32-py3-none-any.whl Python 3 none any Details

Total release size: 3.8 MB

Release files / ipyaudio-0.1.32.tar.gz

Download URL ipyaudio-0.1.32.tar.gz
Size 2.3 MB
Tags Source
SHA-256 checksum
How to use checksums
67a56a8bbe759088e363a73d31df2414b80b7502d1b96120038a726f58596b91
BLAKE2b-256 checksum
How to use checksums
12a96d9127c5e67a76766b794ab5c78695f6cc6fcdba8ac6d5e18083ab217887
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / ipyaudio-0.1.32-py3-none-any.whl

Download URL ipyaudio-0.1.32-py3-none-any.whl
Size 1.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
b4e0adc77dc2779577e9bc9b96c84ce823fa0add46498c44c4f168c5bd889ab3
BLAKE2b-256 checksum
How to use checksums
99abfd888171daffc450f4b666cdd30cc1876592483bf8597978892aa680388e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page