# PvSpeaker Demo for Python
This project contains a Python command-line demo for PvSpeaker that demonstrates how to use PvSpeaker to play audio from a WAV file.
## PvSpeaker
PvSpeaker is an easy-to-use, cross-platform audio player designed for real-time speech audio processing. It allows developers to send raw PCM frames to an audio device's output stream.
## Compatibility
- Python 3.9+
- Runs on Linux (x86_64), macOS (x86_64 and arm64), Windows (x86_64, arm64), and Raspberry Pi (3, 4, 5).
## Installation
```console
pip3 install pvspeakerdemo
```
## Usage
In the following instructions, we will refer to `{AUDIO_DEVICE_INDEX}` as the index of the audio device to use, and `{INPUT_WAV_PATH}` as the path to the pcm `wav` file that will be played.
`{AUDIO_DEVICE_INDEX}` defaults to -1 and `{INPUT_WAV_PATH}` must not be empty.
To show the available audio devices run:
```console
pv_speaker_demo --show_audio_devices
```
To run PvSpeaker run:
```console
pv_speaker_demo --audio_device_index {AUDIO_DEVICE_INDEX} --input_wav_path {INPUT_WAV_PATH}
```
Hit `Ctrl+C` if you wish to stop playing audio before it completes. If no audio device index (`-d`) is provided, the demo will use the system's default audio player device.
Raw data
{
"_id": null,
"home_page": "https://github.com/Picovoice/pvspeaker",
"name": "pvspeakerdemo",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "Audio Player",
"author": "Picovoice",
"author_email": "hello@picovoice.ai",
"download_url": "https://files.pythonhosted.org/packages/4e/3e/e4d1698f346c292b61917ecd29a0622ea6573c212c0210eca8275fc41449/pvspeakerdemo-1.0.5.tar.gz",
"platform": null,
"description": "# PvSpeaker Demo for Python\n\nThis project contains a Python command-line demo for PvSpeaker that demonstrates how to use PvSpeaker to play audio from a WAV file.\n\n## PvSpeaker\n\nPvSpeaker is an easy-to-use, cross-platform audio player designed for real-time speech audio processing. It allows developers to send raw PCM frames to an audio device's output stream.\n\n## Compatibility\n\n- Python 3.9+\n- Runs on Linux (x86_64), macOS (x86_64 and arm64), Windows (x86_64, arm64), and Raspberry Pi (3, 4, 5).\n\n## Installation\n\n```console\npip3 install pvspeakerdemo\n```\n\n## Usage\n\nIn the following instructions, we will refer to `{AUDIO_DEVICE_INDEX}` as the index of the audio device to use, and `{INPUT_WAV_PATH}` as the path to the pcm `wav` file that will be played.\n\n`{AUDIO_DEVICE_INDEX}` defaults to -1 and `{INPUT_WAV_PATH}` must not be empty.\n\nTo show the available audio devices run:\n\n```console\npv_speaker_demo --show_audio_devices\n```\n\nTo run PvSpeaker run:\n\n```console\npv_speaker_demo --audio_device_index {AUDIO_DEVICE_INDEX} --input_wav_path {INPUT_WAV_PATH}\n```\n\nHit `Ctrl+C` if you wish to stop playing audio before it completes. If no audio device index (`-d`) is provided, the demo will use the system's default audio player device.\n",
"bugtrack_url": null,
"license": null,
"summary": "Speaker library for Picovoice.",
"version": "1.0.5",
"project_urls": {
"Homepage": "https://github.com/Picovoice/pvspeaker"
},
"split_keywords": [
"audio",
"player"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b4753799ea7ec6440a8e62c7cb1e38dec9077d7bf4d9b7028ae8d4ab95a407d9",
"md5": "6525d5fd446c0f5d34343f4eb14aac3d",
"sha256": "8aa25b2476056293a44e40b3b0e2cf477d1c5c58d0299663d79a1909d4b28e58"
},
"downloads": -1,
"filename": "pvspeakerdemo-1.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6525d5fd446c0f5d34343f4eb14aac3d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 8151,
"upload_time": "2025-02-12T22:13:29",
"upload_time_iso_8601": "2025-02-12T22:13:29.030233Z",
"url": "https://files.pythonhosted.org/packages/b4/75/3799ea7ec6440a8e62c7cb1e38dec9077d7bf4d9b7028ae8d4ab95a407d9/pvspeakerdemo-1.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4e3ee4d1698f346c292b61917ecd29a0622ea6573c212c0210eca8275fc41449",
"md5": "e076c2ec2f79eed91a5cb99f1105e7b9",
"sha256": "208ddee87007e51e4b981aee7cfd09e0e5f318e0329da5e5a3619f2dfe0b5df0"
},
"downloads": -1,
"filename": "pvspeakerdemo-1.0.5.tar.gz",
"has_sig": false,
"md5_digest": "e076c2ec2f79eed91a5cb99f1105e7b9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 7781,
"upload_time": "2025-02-12T22:13:29",
"upload_time_iso_8601": "2025-02-12T22:13:29.988283Z",
"url": "https://files.pythonhosted.org/packages/4e/3e/e4d1698f346c292b61917ecd29a0622ea6573c212c0210eca8275fc41449/pvspeakerdemo-1.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-12 22:13:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Picovoice",
"github_project": "pvspeaker",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pvspeakerdemo"
}
JSON
