playsound
=========
*Pure Python, cross platform, single function module with no dependencies for playing sounds.*
Installation
------------
Install via pip:
.. code-block:: bash
$ pip install playsound
Done.
If you insist on the (slightly) harder way of installing, from source,
you know how to do it already and don't need my help.
The latest version of the source code can be found at:
https://github.com/TaylorSMarks/playsound
Quick Start
-----------
Once you've installed, you can really quickly verified that it works with just this:
.. code-block:: python
>>> from playsound import playsound
>>> playsound('/path/to/a/sound/file/you/want/to/play.mp3')
Documentation
-------------
The playsound module contains only one thing - the function (also named) playsound.
It requires one argument - the path to the file with the sound you'd like to play. This may be a local file, or a URL.
There's an optional second argument, block, which is set to True by default. Setting it to False makes the function run asynchronously.
On Windows, uses windll.winmm. WAVE and MP3 have been tested and are known to work. Other file formats may work as well.
On OS X, uses AppKit.NSSound. WAVE and MP3 have been tested and are known to work. In general, anything QuickTime can play, playsound should be able to play, for OS X.
On Linux, uses GStreamer. Known to work on Ubuntu 14.04 and ElementaryOS Loki. I expect any Linux distro with a standard gnome desktop experience should work.
If you'd like other Linux distros (or any other OS) to work, submit a PR adding in support for it, but please make sure it passes the tests (see below).
Testing
-------
Playsound includes a small set of tests - if you're making a PR, please ensure that you have no regressions and all the tests pass on your local system.
Also make sure that Travis-CI, which runs these tests against Windows Server 2016, macOS 10.11 (El Capitan, 2015) and 11.3 (Big Sur, 2020), Ubuntu 14 (Trusty), and Ubuntu 18 (Bionic), for both Python 2.7 and 3.9, fully passes.
You can check the Travis-CI status for Playsound here: https://travis-ci.com/github/TaylorSMarks/playsound/builds
Copyright
---------
This software is Copyright (c) 2021 Taylor Marks <taylor@marksfam.com>.
See the bundled LICENSE file for more information.
Raw data
{
"_id": null,
"home_page": "https://github.com/TaylorSMarks/playsound",
"name": "playsound",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "sound playsound music wave wav mp3 media song play audio",
"author": "Taylor Marks",
"author_email": "taylor@marksfam.com",
"download_url": "https://files.pythonhosted.org/packages/67/8c/c9f46b4b194126c4abb12e96321a6bea5c8dcc5c0e4d97622c14dfabe299/playsound-1.3.0.tar.gz",
"platform": "",
"description": "playsound\n=========\n*Pure Python, cross platform, single function module with no dependencies for playing sounds.*\n\nInstallation\n------------\nInstall via pip:\n\n.. code-block:: bash\n\n $ pip install playsound\n\nDone.\n\nIf you insist on the (slightly) harder way of installing, from source,\nyou know how to do it already and don't need my help.\n\nThe latest version of the source code can be found at:\nhttps://github.com/TaylorSMarks/playsound\n\nQuick Start\n-----------\nOnce you've installed, you can really quickly verified that it works with just this:\n\n.. code-block:: python\n\n >>> from playsound import playsound\n >>> playsound('/path/to/a/sound/file/you/want/to/play.mp3') \n\nDocumentation\n-------------\nThe playsound module contains only one thing - the function (also named) playsound.\n\nIt requires one argument - the path to the file with the sound you'd like to play. This may be a local file, or a URL.\n\nThere's an optional second argument, block, which is set to True by default. Setting it to False makes the function run asynchronously.\n\nOn Windows, uses windll.winmm. WAVE and MP3 have been tested and are known to work. Other file formats may work as well.\n\nOn OS X, uses AppKit.NSSound. WAVE and MP3 have been tested and are known to work. In general, anything QuickTime can play, playsound should be able to play, for OS X.\n\nOn Linux, uses GStreamer. Known to work on Ubuntu 14.04 and ElementaryOS Loki. I expect any Linux distro with a standard gnome desktop experience should work.\n\nIf you'd like other Linux distros (or any other OS) to work, submit a PR adding in support for it, but please make sure it passes the tests (see below).\n\nTesting\n-------\nPlaysound includes a small set of tests - if you're making a PR, please ensure that you have no regressions and all the tests pass on your local system.\nAlso make sure that Travis-CI, which runs these tests against Windows Server 2016, macOS 10.11 (El Capitan, 2015) and 11.3 (Big Sur, 2020), Ubuntu 14 (Trusty), and Ubuntu 18 (Bionic), for both Python 2.7 and 3.9, fully passes.\nYou can check the Travis-CI status for Playsound here: https://travis-ci.com/github/TaylorSMarks/playsound/builds\n\nCopyright\n---------\nThis software is Copyright (c) 2021 Taylor Marks <taylor@marksfam.com>.\n\nSee the bundled LICENSE file for more information.",
"bugtrack_url": null,
"license": "MIT",
"summary": "Pure Python, cross platform, single function module with no dependencies for playing sounds.",
"version": "1.3.0",
"split_keywords": [
"sound",
"playsound",
"music",
"wave",
"wav",
"mp3",
"media",
"song",
"play",
"audio"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "e50e650bf09732c35e20204b57fef9cd",
"sha256": "cc6ed11d773034b0ef624e6bb4bf50f4b76b8414a59ce6d38afb89b423297ced"
},
"downloads": -1,
"filename": "playsound-1.3.0.tar.gz",
"has_sig": false,
"md5_digest": "e50e650bf09732c35e20204b57fef9cd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7650,
"upload_time": "2021-07-24T03:21:22",
"upload_time_iso_8601": "2021-07-24T03:21:22.398887Z",
"url": "https://files.pythonhosted.org/packages/67/8c/c9f46b4b194126c4abb12e96321a6bea5c8dcc5c0e4d97622c14dfabe299/playsound-1.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2021-07-24 03:21:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "TaylorSMarks",
"github_project": "playsound",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"lcname": "playsound"
}
JSON
