playsound
Pure Python, cross platform, single function module with no dependencies for playing sounds.
Decision gist · record as of 2026-08-14
Yes, if you need simple audio playback and can tolerate platform-specific system library setup. The zero-dependency design and cross-platform support make it ideal for lightweight scripts and tools. No, if you need active maintenance, support for exotic audio formats, or advanced playback control—consider a more actively maintained alternative in that case. The dormant status is not a blocker for stable use, but means no fixes for edge cases or new platform support.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires platform-specific system audio libraries: Windows multimedia (built-in), macOS AppKit (built-in), or Linux GStreamer (must be installed separately on most distributions).
- High install friction: the package itself has no Python dependencies, but relies on platform-specific system libraries (Windows multimedia, macOS AppKit, Linux GStreamer).
- Maintenance is dormant—last release was 2021-07-24, though the repository remains active with recent commits and no known vulnerabilities.
License · maintenance · safety
MIT (permissive) — MIT license (permissive) places no restrictions on use, modification, or distribution in your own projects.
last release 2021-07-24 (1847 days) · last repo commit 2024-07-30 · 548 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 116,831 downloads/mo, #12,193 on PyPI
Alternatives
Verify before relying
pip install playsound
from playsound import playsound
playsound('/path/to/sound.mp3')
# or asynchronously:
playsound('/path/to/sound.mp3', block=False)- Whether GStreamer installation is straightforward on modern Linux distributions beyond Ubuntu 14 and ElementaryOS Loki.
- Current compatibility with Python versions beyond 3.9, given the dormant maintenance status since 2021.
- Whether URL playback works reliably across all platforms and file formats.
What it is and what it does
Playsound is a minimal, zero-dependency Python wrapper around native platform audio APIs for playing sound files and URLs. It exposes a single function that accepts a file path or URL and an optional blocking flag, delegating to Windows multimedia APIs on Windows, AppKit on macOS, and GStreamer on Linux. The module is intentionally simple—it does one thing and avoids pulling in heavy audio frameworks.
The package is useful when you need basic audio playback in a script or application without adding framework dependencies. It handles MP3 and WAV reliably across platforms; other formats depend on what the underlying system can play. Because it relies on system libraries rather than bundled codecs, installation requires platform-specific setup (particularly on Linux), which is the main friction point. The project is stable and production-ready but dormant since its latest release.
Use it for
- Play notification or alert sounds in a CLI tool or background service without heavy dependencies.
- Add audio feedback to a Python game or interactive application on Windows, macOS, or Linux.
- Stream and play audio from a URL in a simple script or automation task.
- Test audio playback in a cross-platform application during development or CI/CD.
- Trigger sound effects in a data processing or monitoring script.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need simple audio playback and can tolerate platform-specific system library setup.
The zero-dependency design and cross-platform support make it ideal for lightweight scripts and tools. No, if you need active maintenance, support for exotic audio formats, or advanced playback control—consider a more actively maintained alternative in that case. The dormant status is not a blocker for stable use, but means no fixes for edge cases or new platform support.
Install
playsound on PyPI
Before you install
High install friction: the package itself has no Python dependencies, but relies on platform-specific system libraries (Windows multimedia, macOS AppKit, Linux GStreamer). Maintenance is dormant—last release was 2021-07-24, though the repository remains active with recent commits and no known vulnerabilities.
Requires platform-specific system audio libraries: Windows multimedia (built-in), macOS AppKit (built-in), or Linux GStreamer (must be installed separately on most distributions).
License in practice
MIT license (permissive) places no restrictions on use, modification, or distribution in your own projects.
Quickstart
pip install playsound
from playsound import playsound
playsound('/path/to/sound.mp3')
# or asynchronously:
playsound('/path/to/sound.mp3', block=False)Verify before relying
- Whether GStreamer installation is straightforward on modern Linux distributions beyond Ubuntu 14 and ElementaryOS Loki.
- Current compatibility with Python versions beyond 3.9, given the dormant maintenance status since 2021.
- Whether URL playback works reliably across all platforms and file formats.
Package facts
| License | MIT permissive |
| Python support | Not specified |
| Install friction | High. Source build required |
| Runtime dependencies | None |
| Maintenance | Dormant 1,847 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 116,831 / month, #12,193 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 2Programming Language :: Python :: 2.3Programming Language :: Python :: 2.4Programming Language :: Python :: 2.5Programming Language :: Python :: 2.6Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.1Programming Language :: Python :: 3.2Programming Language :: Python :: 3.3Programming Language :: Python :: 3.4Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Multimedia :: Sound/Audio :: MIDITopic :: Multimedia :: Sound/Audio :: PlayersTopic :: Multimedia :: Sound/Audio :: Players :: MP3 |
Evidence: playsound-1.3.0.tar.gz
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “play audio files python”
- playsoundPlays audio files (MP3, WAV) and URLs from Python with a single…
- PyAudioPyAudio provides Python bindings for PortAudio v19, enabling you to…
- pyfmodexPyfmodex provides Python bindings to the FMOD Engine audio library…
Give your agent the search over MCP, or paste the wish link into any chat.
More Sound/Audio packages
Reads and writes audio files in formats like WAV, FLAC, OGG, and MAT through libsndfile, exposing audio data as NumPy arrays.
Pydub provides a high-level Python interface for loading, manipulating, and exporting audio files with simple operations like slicing, concatenation, and format conversion.
However, the abandoned status since 2021-03-10 means no future fixes or compatibility updates—use it only if you can tolerate potential issues with newer Python…
Mutagen reads and writes audio metadata (tags) across many audio formats including MP3, FLAC, OGG, MP4, WavPack, and others, supporting ID3v2 and APEv2 tag editing.
Install it if you need to read or edit audio tags programmatically.
Provides PyTorch-based audio processing, transforms, and dataloaders for machine learning tasks, with GPU acceleration and autograd support for trainable audio features.
MoviePy is a Python library for video editing that reads, processes, and writes video and audio files by converting them to numpy arrays for frame-level manipulation and effect application.
Reads metadata (artist, title, duration, bitrate, and more) from audio files in formats including MP3, MP4, FLAC, OGG, WAV, and others, without writing or modifying tags.
Install it if you need to extract metadata from audio files without the overhead of a heavier library.
See also django-ranged-response · sonos-websocket · pyfmodex · miniaudio · PyAudio · SoundCard · audiofile · audioread · soco