soundpad_control
================
![PyPI - Version](https://img.shields.io/pypi/v/soundpad_control) ![GitHub License](https://img.shields.io/github/license/Ilya-Kokhanovsky/soundpad.py) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/soundpad_control)
A simple Python wrapper for controlling Soundpad remotely.
Overview
--------
This Python package, soundpad_control, offers a remote control interface for Soundpad through Python, enabling programmatic management of audio playback and manipulation features. Modeled after SoundpadRemoteControl.java, it supports functionalities such as playing, pausing, and stopping sounds, managing categories, and controlling audio settings. With easy-to-use methods, users can add, search, and organize audio files, making it ideal for automated setups or complex audio workflows.
### Features
- **Play and Stop Sounds**: Start, stop, and navigate sounds, with options to output to speakers or a microphone.
- **Sound Navigation**: Play previous, next, and random sounds or sounds from specific categories.
- **Sound Management**: Add or remove sounds and categories, select rows and categories, and manage playback order.
- **Volume and Playback Control**: Control volume, mute, pause, seek, and scroll playback.
- **Recording Support**: Start, stop, and monitor recording sessions.
- **Soundpad Version Check**: Confirm compatibility and connection status with Soundpad.
Installing
-----------
**Python 3.6 or higher is required**
A [Virtual Environment](https://docs.python.org/3/library/venv.html) is recommended to install the library, especially on Linux where the system Python is externally managed and restricts which packages you can install on it.
You can install the library via `pip`:
```
$ pip install soundpad_control
```
Quick Example
-------------
Here’s a quick example of how to use `soundpad_control`.
```python
from soundpad_control import SoundpadRemoteControl
# Initialize the Soundpad remote control
soundpad = SoundpadRemoteControl()
# Play a specific sound by index, here at index 1
soundpad.play_sound(1)
# Play the next sound in the playlist or queue
soundpad.play_next_sound()
# Add a new sound to Soundpad using the specified file path
soundpad.add_sound('/path/to/sound.mp3')
# Search for a sound file by its filename or keyword
soundpad.search('filename')
# Remove selected sound entries; here, `False` keeps the files on disk
soundpad.remove_selected_entries(False)
```
Requirements
------------
- Python 3.6+
- Soundpad
Links
-----
- [GitHub](https://github.com/Ilya-Kokhanovsky/soundpad.py)
- [PyPI page](https://pypi.org/project/soundpad_control)
- Original Java implementation: [SoundpadRemoteControl.java](https://www.leppsoft.com/soundpad/files/rc/SoundpadRemoteControl.java)
MIT License
Copyright (c) 2024 ilyadev
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Raw data
{
"_id": null,
"home_page": "https://github.com/Ilya-Kokhanovsky/soundpad.py",
"name": "soundpad_control",
"maintainer": "Ilya Kokhanovsky",
"docs_url": null,
"requires_python": "<4.0,>=3.6",
"maintainer_email": "kokhanovskyilya@gmail.com",
"keywords": "soundpad, remote control, audio",
"author": "Ilya Kokhanovsky",
"author_email": "kokhanovskyilya@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/de/e2/77dde8941a5099f314dec62f09f57a7ec6eb520d1037865ef02f4fb42b4b/soundpad_control-0.1.2.tar.gz",
"platform": null,
"description": "soundpad_control\n================\n\n![PyPI - Version](https://img.shields.io/pypi/v/soundpad_control) ![GitHub License](https://img.shields.io/github/license/Ilya-Kokhanovsky/soundpad.py) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/soundpad_control)\n\nA simple Python wrapper for controlling Soundpad remotely.\n\nOverview\n--------\n\nThis Python package, soundpad_control, offers a remote control interface for Soundpad through Python, enabling programmatic management of audio playback and manipulation features. Modeled after SoundpadRemoteControl.java, it supports functionalities such as playing, pausing, and stopping sounds, managing categories, and controlling audio settings. With easy-to-use methods, users can add, search, and organize audio files, making it ideal for automated setups or complex audio workflows.\n\n### Features\n\n- **Play and Stop Sounds**: Start, stop, and navigate sounds, with options to output to speakers or a microphone.\n- **Sound Navigation**: Play previous, next, and random sounds or sounds from specific categories.\n- **Sound Management**: Add or remove sounds and categories, select rows and categories, and manage playback order.\n- **Volume and Playback Control**: Control volume, mute, pause, seek, and scroll playback.\n- **Recording Support**: Start, stop, and monitor recording sessions.\n- **Soundpad Version Check**: Confirm compatibility and connection status with Soundpad.\n\nInstalling\n-----------\n\n**Python 3.6 or higher is required**\n\nA [Virtual Environment](https://docs.python.org/3/library/venv.html) is recommended to install the library, especially on Linux where the system Python is externally managed and restricts which packages you can install on it.\n\nYou can install the library via `pip`:\n\n```\n$ pip install soundpad_control\n```\n\nQuick Example\n-------------\n\nHere\u2019s a quick example of how to use `soundpad_control`.\n\n```python\nfrom soundpad_control import SoundpadRemoteControl\n\n# Initialize the Soundpad remote control\nsoundpad = SoundpadRemoteControl()\n\n# Play a specific sound by index, here at index 1\nsoundpad.play_sound(1)\n\n# Play the next sound in the playlist or queue\nsoundpad.play_next_sound()\n\n# Add a new sound to Soundpad using the specified file path\nsoundpad.add_sound('/path/to/sound.mp3')\n\n# Search for a sound file by its filename or keyword\nsoundpad.search('filename')\n\n# Remove selected sound entries; here, `False` keeps the files on disk\nsoundpad.remove_selected_entries(False)\n\n```\n\nRequirements\n------------\n\n- Python 3.6+\n- Soundpad\n\nLinks\n-----\n\n- [GitHub](https://github.com/Ilya-Kokhanovsky/soundpad.py)\n- [PyPI page](https://pypi.org/project/soundpad_control)\n- Original Java implementation: [SoundpadRemoteControl.java](https://www.leppsoft.com/soundpad/files/rc/SoundpadRemoteControl.java)\n\n\nMIT License\n\nCopyright (c) 2024 ilyadev\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "An API wrapper for Soundpad written in Python.",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/Ilya-Kokhanovsky/soundpad.py",
"Repository": "https://github.com/Ilya-Kokhanovsky/soundpad.py"
},
"split_keywords": [
"soundpad",
" remote control",
" audio"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "258e955a87493f8af98e023a9c2a5609e2d18eaa3f1482ea781825f463664392",
"md5": "d7dce7f4b9e44f40ae77541fc4937e9c",
"sha256": "33f84c94cbdd023e47a792a8e6d91d7909c4d6cf5761e07584f905cf6c19fce1"
},
"downloads": -1,
"filename": "soundpad_control-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d7dce7f4b9e44f40ae77541fc4937e9c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.6",
"size": 8953,
"upload_time": "2024-10-26T01:08:30",
"upload_time_iso_8601": "2024-10-26T01:08:30.415325Z",
"url": "https://files.pythonhosted.org/packages/25/8e/955a87493f8af98e023a9c2a5609e2d18eaa3f1482ea781825f463664392/soundpad_control-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "dee277dde8941a5099f314dec62f09f57a7ec6eb520d1037865ef02f4fb42b4b",
"md5": "550a9f2e48630b74fbe717ea2a6c2073",
"sha256": "1171fd333de6468c3d864f7554211f3b5a48078ee65bfad8b87c82c97ad99ace"
},
"downloads": -1,
"filename": "soundpad_control-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "550a9f2e48630b74fbe717ea2a6c2073",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.6",
"size": 9075,
"upload_time": "2024-10-26T01:08:32",
"upload_time_iso_8601": "2024-10-26T01:08:32.212866Z",
"url": "https://files.pythonhosted.org/packages/de/e2/77dde8941a5099f314dec62f09f57a7ec6eb520d1037865ef02f4fb42b4b/soundpad_control-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-26 01:08:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Ilya-Kokhanovsky",
"github_project": "soundpad.py",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "soundpad_control"
}