# Pedalboard Pluginary
_Pedalboard Pluginary_ is an independent Python-based package and command-line tool that scans and lists VST-3 plugins on macOS and Windows, and Audio Unit (AU) plugins on macOS. It’s intended as a companion for the _[Pedalboard](https://github.com/spotify/pedalboard)_ Python library by Spotify, but it’s not affiliated with _Pedalboard_ or Spotify.
## Features
With _Pedalboard Pluginary_, you can scan and list VST-3 and AU audio plugins installed on your machine, including their default parameters.
- It automatically scans and catalogs VST-3 and AU plugins installed on your system.
- Provides a command-line interface (CLI) for quick access to your plugin library.
- Saves the plugin information in a JSON file. This file has the information about the plugin parameters and their default values.
- Works on Windows and macOS (Windows is currently untested).
- It bundles an `ignores.json` file, which “blacklists” some plugins that are known to cause issues with Pedalboard. It will not scan these, and will not include them in the cache. If you find that some plugins are not working with Pedalboard, you can add them to your `ignores.json` file. See “Contributing” section below.
## Future plans
I plan to extend the package with another functionality, “jobs”, which will allow to load a stack of plugins with their parameter values from a dictionary or JSON file, and run them in a batch using Pedalboard.
## Installation
To install _Pedalboard Pluginary_, run:
```bash
python3 -m pip install --upgrade pedalboard-pluginary
```
For the current development version:
```bash
python3 -m pip install --upgrade git+https://github.com/twardoch/pedalboard-pluginary
```
## Command-line usage
After installation, you can use `pbpluginary` from the command line.
### Commands:
- `pbpluginary list` displays the plugin information stored in the cache, as a JSON. If no cache exists, it will scan your system and create the cache.
- `pbpluginary scan` scans all available plugins, and caches the information. Run this if you’ve installed or upgraded some VST-3 or AU plugins.
## Python usage
You can use _Pedalboard Pluginary_ as a library in your Python scripts. Here's a quick example:
```python
from pedalboard_pluginary import PedalboardPluginary
pluginary = PedalboardPluginary()
print(pluginary.list_plugins())
```
This snippet will list all plugins that have been scanned and cached, as a JSON.
## Changes
- **v1.1.0**: Added `update` CLI command which only scans plugins that aren’t cached yet. Not perfect. Added `json` and `yaml` CLI commands. Additional refactorings.
- **v1.0.0**: Initial release with basic scanning and listing of both VST-3 and AU plugins, and command-line interface for easy interaction.
## License
- **Pedalboard Pluginary** is written by Adam Twardoch, with assistance from GPT-4.
- Copyright (c) 2023 Adam Twardoch.
- Licensed under the [Apache-2.0 license](https://raw.githubusercontent.com/twardoch/pedalboard-pluginary/main/LICENSE.txt).
- _Pedalboard Pluginary_ is not affiliated with [Pedalboard](https://github.com/spotify/pedalboard) or Spotify.
## Contributing
- If you encounter any issues or have suggestions, feel free to open an [issue](https://github.com/twardoch/pedalboard-pluginary/issues) on GitHub.
- If you find that some plugins are not working with Pedalboard, open an issue that lists the key, which is the plugin type and the base filename, like `"aufx/CoreAudio"` or `"vst3/RX 10 Connect"`. You can also modify the [`default_ignores.json`](https://raw.githubusercontent.com/twardoch/pedalboard-pluginary/main/src/pedalboard_pluginary/resources/default_ignores.json) file, and submit a pull request.
- If you want to contribute code, please open a pull request.
Raw data
{
"_id": null,
"home_page": "https://github.com/twardoch/pedalboard-pluginary",
"name": "pedalboard-pluginary",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "",
"author": "Adam Twardoch",
"author_email": "adam+github@twardoch.com",
"download_url": "https://files.pythonhosted.org/packages/81/8d/849bcd1a84bba6e0e5baeaa0c2569af6cbd9bba88e1a1cfd3a1f94a434e8/pedalboard_pluginary-1.1.0.tar.gz",
"platform": null,
"description": "# Pedalboard Pluginary\n\n_Pedalboard Pluginary_ is an independent Python-based package and command-line tool that scans and lists VST-3 plugins on macOS and Windows, and Audio Unit (AU) plugins on macOS. It\u2019s intended as a companion for the _[Pedalboard](https://github.com/spotify/pedalboard)_ Python library by Spotify, but it\u2019s not affiliated with _Pedalboard_ or Spotify.\n\n## Features\n\nWith _Pedalboard Pluginary_, you can scan and list VST-3 and AU audio plugins installed on your machine, including their default parameters. \n\n- It automatically scans and catalogs VST-3 and AU plugins installed on your system.\n- Provides a command-line interface (CLI) for quick access to your plugin library.\n- Saves the plugin information in a JSON file. This file has the information about the plugin parameters and their default values. \n- Works on Windows and macOS (Windows is currently untested).\n- It bundles an `ignores.json` file, which \u201cblacklists\u201d some plugins that are known to cause issues with Pedalboard. It will not scan these, and will not include them in the cache. If you find that some plugins are not working with Pedalboard, you can add them to your `ignores.json` file. See \u201cContributing\u201d section below.\n\n## Future plans\n\nI plan to extend the package with another functionality, \u201cjobs\u201d, which will allow to load a stack of plugins with their parameter values from a dictionary or JSON file, and run them in a batch using Pedalboard. \n\n## Installation\n\nTo install _Pedalboard Pluginary_, run:\n\n```bash\npython3 -m pip install --upgrade pedalboard-pluginary\n```\n\nFor the current development version:\n\n```bash\npython3 -m pip install --upgrade git+https://github.com/twardoch/pedalboard-pluginary\n```\n\n## Command-line usage\n\nAfter installation, you can use `pbpluginary` from the command line.\n\n### Commands:\n\n- `pbpluginary list` displays the plugin information stored in the cache, as a JSON. If no cache exists, it will scan your system and create the cache.\n- `pbpluginary scan` scans all available plugins, and caches the information. Run this if you\u2019ve installed or upgraded some VST-3 or AU plugins.\n\n## Python usage\n\nYou can use _Pedalboard Pluginary_ as a library in your Python scripts. Here's a quick example:\n\n```python\nfrom pedalboard_pluginary import PedalboardPluginary\n\npluginary = PedalboardPluginary()\nprint(pluginary.list_plugins())\n```\n\nThis snippet will list all plugins that have been scanned and cached, as a JSON.\n\n## Changes\n\n- **v1.1.0**: Added `update` CLI command which only scans plugins that aren\u2019t cached yet. Not perfect. Added `json` and `yaml` CLI commands. Additional refactorings. \n- **v1.0.0**: Initial release with basic scanning and listing of both VST-3 and AU plugins, and command-line interface for easy interaction.\n\n## License\n\n- **Pedalboard Pluginary** is written by Adam Twardoch, with assistance from GPT-4.\n- Copyright (c) 2023 Adam Twardoch.\n- Licensed under the [Apache-2.0 license](https://raw.githubusercontent.com/twardoch/pedalboard-pluginary/main/LICENSE.txt).\n- _Pedalboard Pluginary_ is not affiliated with [Pedalboard](https://github.com/spotify/pedalboard) or Spotify.\n\n## Contributing\n\n- If you encounter any issues or have suggestions, feel free to open an [issue](https://github.com/twardoch/pedalboard-pluginary/issues) on GitHub. \n- If you find that some plugins are not working with Pedalboard, open an issue that lists the key, which is the plugin type and the base filename, like `\"aufx/CoreAudio\"` or `\"vst3/RX 10 Connect\"`. You can also modify the [`default_ignores.json`](https://raw.githubusercontent.com/twardoch/pedalboard-pluginary/main/src/pedalboard_pluginary/resources/default_ignores.json) file, and submit a pull request.\n- If you want to contribute code, please open a pull request. \n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "VST & AU plugin management for Spotify Pedalboard",
"version": "1.1.0",
"project_urls": {
"Documentation": "https://github.com/twardoch/pedalboard-pluginary#readme",
"Homepage": "https://github.com/twardoch/pedalboard-pluginary",
"Source": "https://github.com/twardoch/pedalboard-pluginary",
"Tracker": "https://github.com/twardoch/pedalboard-pluginary/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5e635330baf2f8720472bb0aec63b7cd95d7f3755bca62858aa56ed975324509",
"md5": "8bc54a7ba8acd9b45b11967d33825c80",
"sha256": "6a1ebcd6c9557f69d0516a366d9c0fe6e2e01712eddd0ecee7532341ff36f8b6"
},
"downloads": -1,
"filename": "pedalboard_pluginary-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8bc54a7ba8acd9b45b11967d33825c80",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 12628,
"upload_time": "2023-11-20T03:14:45",
"upload_time_iso_8601": "2023-11-20T03:14:45.852396Z",
"url": "https://files.pythonhosted.org/packages/5e/63/5330baf2f8720472bb0aec63b7cd95d7f3755bca62858aa56ed975324509/pedalboard_pluginary-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "818d849bcd1a84bba6e0e5baeaa0c2569af6cbd9bba88e1a1cfd3a1f94a434e8",
"md5": "191a074d0e9f9a6cdca26c347460fbc6",
"sha256": "936fc20c448c709e97ee689ed5decde578308d4e0a9a8cd3aa1eacc62fb0009f"
},
"downloads": -1,
"filename": "pedalboard_pluginary-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "191a074d0e9f9a6cdca26c347460fbc6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 16728,
"upload_time": "2023-11-20T03:14:47",
"upload_time_iso_8601": "2023-11-20T03:14:47.024304Z",
"url": "https://files.pythonhosted.org/packages/81/8d/849bcd1a84bba6e0e5baeaa0c2569af6cbd9bba88e1a1cfd3a1f94a434e8/pedalboard_pluginary-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-20 03:14:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "twardoch",
"github_project": "pedalboard-pluginary",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "pedalboard-pluginary"
}
JSON
