# Nendo Plugin: Core Quantizer
<br>
<p align="left">
<img src="https://okio.ai/docs/assets/nendo_core_logo.png" width="350" alt="Nendo Core">
</p>
<br>
---
![Documentation](https://img.shields.io/website/https/nendo.ai)
[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/okio_ai.svg?style=social&label=Follow%20%40okio_ai)](https://twitter.com/okio_ai) [![](https://dcbadge.vercel.app/api/server/XpkUsjwXTp?compact=true&style=flat)](https://discord.gg/XpkUsjwXTp)
Audio quantization with grid detection and time-stretching
(using [rubberband](https://breakfastquay.com/rubberband/)).
## Features
- Quantize a `NendoTrack` or a `NendoCollection` to a given BPM and grid
- Use it in chains to automatically create quantized collections of your favorite tracks and loops
## Installation
This plugin requires the `rubberband` package to be installed in your system. Please refer to the [rubberband documentation](https://breakfastquay.com/rubberband/index.html) for further information.
1. [Install Nendo](https://github.com/okio-ai/nendo#installation)
2. `pip install nendo-plugin-quantize-core`
## Usage
Take a look at a basic usage example below.
For more detailed information, please refer to the [documentation](https://okio.ai/docs/plugins).
For more advanced examples, check out the examples folder.
or try it in colab:
<a target="_blank" href="https://colab.research.google.com/drive/1DmCYRG_jtZXrtb7v5KPwMb5XPSrlBINY?usp=sharing">
<img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>
</a>
```python
from nendo import Nendo, NendoConfig
nd = Nendo(config=NendoConfig(plugins=["nendo_plugin_quantize_core"]))
track = nd.library.add_track(file_path='/path/to/track.mp3')
quantized_track = nd.plugins.quantize_core(track=track)
```
## Contributing
Visit our docs to learn all about how to contribute to Nendo: [Contributing](https://okio.ai/docs/contributing/)
## License
Nendo: MIT License
rubberband: GPL-2.0 License
Raw data
{
"_id": null,
"home_page": "https://okio.ai",
"name": "nendo_plugin_quantize_core",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<3.11",
"maintainer_email": "",
"keywords": "Nendo,AI,Machine Learning,Audio,Generative,Music,Audio Production,Audio Generation,Audio Analysis,Quantization,Plugin",
"author": "Aaron Abebe",
"author_email": "aaron@okio.ai",
"download_url": "https://files.pythonhosted.org/packages/3b/0e/8082a2d00cf1519355e0a835850d147d75f44654d25bfa3e168ebca4a474/nendo_plugin_quantize_core-0.1.4.tar.gz",
"platform": null,
"description": "# Nendo Plugin: Core Quantizer\n\n<br>\n<p align=\"left\">\n <img src=\"https://okio.ai/docs/assets/nendo_core_logo.png\" width=\"350\" alt=\"Nendo Core\">\n</p>\n<br>\n\n---\n\n![Documentation](https://img.shields.io/website/https/nendo.ai)\n[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/okio_ai.svg?style=social&label=Follow%20%40okio_ai)](https://twitter.com/okio_ai) [![](https://dcbadge.vercel.app/api/server/XpkUsjwXTp?compact=true&style=flat)](https://discord.gg/XpkUsjwXTp)\n\nAudio quantization with grid detection and time-stretching \n(using [rubberband](https://breakfastquay.com/rubberband/)).\n\n\n\n## Features\n\n- Quantize a `NendoTrack` or a `NendoCollection` to a given BPM and grid\n- Use it in chains to automatically create quantized collections of your favorite tracks and loops\n \n## Installation\n\nThis plugin requires the `rubberband` package to be installed in your system. Please refer to the [rubberband documentation](https://breakfastquay.com/rubberband/index.html) for further information.\n\n1. [Install Nendo](https://github.com/okio-ai/nendo#installation)\n2. `pip install nendo-plugin-quantize-core`\n\n## Usage\n\nTake a look at a basic usage example below.\nFor more detailed information, please refer to the [documentation](https://okio.ai/docs/plugins).\n\nFor more advanced examples, check out the examples folder.\nor try it in colab:\n\n<a target=\"_blank\" href=\"https://colab.research.google.com/drive/1DmCYRG_jtZXrtb7v5KPwMb5XPSrlBINY?usp=sharing\">\n <img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/>\n</a>\n\n```python\nfrom nendo import Nendo, NendoConfig\n\nnd = Nendo(config=NendoConfig(plugins=[\"nendo_plugin_quantize_core\"]))\ntrack = nd.library.add_track(file_path='/path/to/track.mp3')\nquantized_track = nd.plugins.quantize_core(track=track)\n```\n\n## Contributing\n\nVisit our docs to learn all about how to contribute to Nendo: [Contributing](https://okio.ai/docs/contributing/)\n\n\n## License\n\nNendo: MIT License\n\nrubberband: GPL-2.0 License",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "Nendo Plugin for audio quantization with grid detection and time-stretching",
"version": "0.1.4",
"project_urls": {
"Homepage": "https://okio.ai",
"Repository": "https://github.com/okio-ai/nendo_plugin_quantize_core"
},
"split_keywords": [
"nendo",
"ai",
"machine learning",
"audio",
"generative",
"music",
"audio production",
"audio generation",
"audio analysis",
"quantization",
"plugin"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e171e8b2cae7654c4abbcb8b678460cd69e52f847ebadf13ae7cc4b9b631f8b0",
"md5": "e10c3762206c11a25d3446b80f58ad09",
"sha256": "2b807340b35a00e90ba4b9a5b77ac4b12c9b936137ad32b82a3c21cd94504502"
},
"downloads": -1,
"filename": "nendo_plugin_quantize_core-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e10c3762206c11a25d3446b80f58ad09",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<3.11",
"size": 17697,
"upload_time": "2023-12-22T11:12:56",
"upload_time_iso_8601": "2023-12-22T11:12:56.771064Z",
"url": "https://files.pythonhosted.org/packages/e1/71/e8b2cae7654c4abbcb8b678460cd69e52f847ebadf13ae7cc4b9b631f8b0/nendo_plugin_quantize_core-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3b0e8082a2d00cf1519355e0a835850d147d75f44654d25bfa3e168ebca4a474",
"md5": "1dd2596d373d8ebfc4592a4dd1719d22",
"sha256": "6b6aec878af6190e398f5be261440ee263f769d7ba432d20a6e6b73c665d21c3"
},
"downloads": -1,
"filename": "nendo_plugin_quantize_core-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "1dd2596d373d8ebfc4592a4dd1719d22",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<3.11",
"size": 17709,
"upload_time": "2023-12-22T11:12:58",
"upload_time_iso_8601": "2023-12-22T11:12:58.017725Z",
"url": "https://files.pythonhosted.org/packages/3b/0e/8082a2d00cf1519355e0a835850d147d75f44654d25bfa3e168ebca4a474/nendo_plugin_quantize_core-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-22 11:12:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "okio-ai",
"github_project": "nendo_plugin_quantize_core",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "nendo_plugin_quantize_core"
}