{ "info": { "author": "Deezer Research", "author_email": "spleeter@deezer.com", "bugtrack_url": null, "classifiers": [ "Environment :: Console", "Environment :: MacOS X", "Intended Audience :: Developers", "Intended Audience :: Information Technology", "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: MacOS", "Operating System :: Microsoft :: Windows", "Operating System :: POSIX :: Linux", "Operating System :: Unix", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3 :: Only", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: Implementation :: CPython", "Topic :: Artistic Software", "Topic :: Multimedia", "Topic :: Multimedia :: Sound/Audio", "Topic :: Multimedia :: Sound/Audio :: Analysis", "Topic :: Multimedia :: Sound/Audio :: Conversion", "Topic :: Multimedia :: Sound/Audio :: Sound Synthesis", "Topic :: Scientific/Engineering", "Topic :: Scientific/Engineering :: Artificial Intelligence", "Topic :: Scientific/Engineering :: Information Analysis", "Topic :: Software Development", "Topic :: Software Development :: Libraries", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Utilities" ], "description": "\n\n[![Github actions](https://github.com/deezer/spleeter/workflows/pytest/badge.svg)](https://github.com/deezer/spleeter/actions) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/spleeter) [![PyPI version](https://badge.fury.io/py/spleeter.svg)](https://badge.fury.io/py/spleeter) [![Conda](https://img.shields.io/conda/vn/conda-forge/spleeter)](https://anaconda.org/conda-forge/spleeter) [![Docker Pulls](https://img.shields.io/docker/pulls/researchdeezer/spleeter)](https://hub.docker.com/r/researchdeezer/spleeter) [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/deezer/spleeter/blob/master/spleeter.ipynb) [![Gitter chat](https://badges.gitter.im/gitterHQ/gitter.png)](https://gitter.im/spleeter/community) [![status](https://joss.theoj.org/papers/259e5efe669945a343bad6eccb89018b/status.svg)](https://joss.theoj.org/papers/259e5efe669945a343bad6eccb89018b)\n\n## About\n\n**Spleeter** is [Deezer](https://www.deezer.com/) source separation library with pretrained models\nwritten in [Python](https://www.python.org/) and uses [Tensorflow](https://tensorflow.org/). It makes it easy\nto train source separation model (assuming you have a dataset of isolated sources), and provides\nalready trained state of the art model for performing various flavour of separation :\n\n* Vocals (singing voice) / accompaniment separation ([2 stems](https://github.com/deezer/spleeter/wiki/2.-Getting-started#using-2stems-model))\n* Vocals / drums / bass / other separation ([4 stems](https://github.com/deezer/spleeter/wiki/2.-Getting-started#using-4stems-model))\n* Vocals / drums / bass / piano / other separation ([5 stems](https://github.com/deezer/spleeter/wiki/2.-Getting-started#using-5stems-model))\n\n2 stems and 4 stems models have [high performances](https://github.com/deezer/spleeter/wiki/Separation-Performances) on the [musdb](https://sigsep.github.io/datasets/musdb.html) dataset. **Spleeter** is also very fast as it can perform separation of audio files to 4 stems 100x faster than real-time when run on a GPU.\n\nWe designed **Spleeter** so you can use it straight from [command line](https://github.com/deezer/spleeter/wiki/2.-Getting-started#usage)\nas well as directly in your own development pipeline as a [Python library](https://github.com/deezer/spleeter/wiki/4.-API-Reference#separator). It can be installed with [Conda](https://github.com/deezer/spleeter/wiki/1.-Installation#using-conda),\nwith [pip](https://github.com/deezer/spleeter/wiki/1.-Installation#using-pip) or be used with\n[Docker](https://github.com/deezer/spleeter/wiki/2.-Getting-started#using-docker-image).\n\n### Projects and Softwares using **Spleeter**\n\nSince it's been released, there are multiple forks exposing **Spleeter** through either a Guided User Interface (GUI) or a standalone free or paying website. Please note that we do not host, maintain or directly support any of these initiatives.\n\nThat being said, many cool projects have been built on top of ours. Notably the porting to the *Ableton Live* ecosystem through the [Spleeter 4 Max](https://github.com/diracdeltas/spleeter4max#spleeter-for-max) project.\n\n**Spleeter** pre-trained models have also been used by professionnal audio softwares. Here's a non-exhaustive list:\n\n* [iZotope](https://www.izotope.com/en/shop/rx-8-standard.html) in its *Music Rebalance* feature within **RX 8**\n* [SpectralLayers](https://new.steinberg.net/spectralayers/) in its *Unmix* feature in **SpectralLayers 7**\n* [Acon Digital](https://acondigital.com/products/acoustica-audio-editor/) within **Acoustica 7**\n* [VirtualDJ](https://www.virtualdj.com/stems/) in their stem isolation feature\n* [Algoriddim](https://www.algoriddim.com/apps) in their **NeuralMix** and **djayPRO** app suite\n\n## Quick start\n\nWant to try it out but don't want to install anything ? We have set up a [Google Colab](https://colab.research.google.com/github/deezer/spleeter/blob/master/spleeter.ipynb).\n\nReady to dig into it ? In a few lines you can install **Spleeter** using [Conda](https://github.com/deezer/spleeter/wiki/1.-Installation#using-conda) and separate the vocal and accompaniment parts from an example audio file:\n\n```bash\n# install using conda\nconda install -c conda-forge spleeter\n# download an example audio file (if you don't have wget, use another tool for downloading)\nwget https://github.com/deezer/spleeter/raw/master/audio_example.mp3\n# separate the example audio into two components\nspleeter separate -i audio_example.mp3 -p spleeter:2stems -o output\n```\n\nYou should get two separated audio files (`vocals.wav` and `accompaniment.wav`) in the `output/audio_example` folder.\n\nFor a detailed documentation, please check the [repository wiki](https://github.com/deezer/spleeter/wiki)\n\n## Development and Testing\n\nThe following set of commands will clone this repository, create a virtual environment provisioned with the dependencies and run the tests (will take a few minutes):\n\n```bash\ngit clone https://github.com/Deezer/spleeter && cd spleeter\npython -m venv spleeterenv && source spleeterenv/bin/activate\npip install . && pip install pytest pytest-xdist\nmake test\n```\n\n## Reference\n\n* Deezer Research - Source Separation Engine Story - deezer.io blog post:\n * [English version](https://deezer.io/releasing-spleeter-deezer-r-d-source-separation-engine-2b88985e797e)\n * [Japanese version](http://dzr.fm/splitterjp)\n* [Music Source Separation tool with pre-trained models / ISMIR2019 extended abstract](http://archives.ismir.net/ismir2019/latebreaking/000036.pdf)\n\nIf you use **Spleeter** in your work, please cite:\n\n```BibTeX\n@article{spleeter2020,\n doi = {10.21105/joss.02154},\n url = {https://doi.org/10.21105/joss.02154},\n year = {2020},\n publisher = {The Open Journal},\n volume = {5},\n number = {50},\n pages = {2154},\n author = {Romain Hennequin and Anis Khlif and Felix Voituret and Manuel Moussallam},\n title = {Spleeter: a fast and efficient music source separation tool with pre-trained models},\n journal = {Journal of Open Source Software},\n note = {Deezer Research}\n}\n```\n\n## License\n\nThe code of **Spleeter** is [MIT-licensed](LICENSE).\n\n## Disclaimer\n\nIf you plan to use **Spleeter** on copyrighted material, make sure you get proper authorization from right owners beforehand.\n\n## Troubleshooting\n\n**Spleeter** is a complex piece of software and although we continously try to improve and test it you may encounter unexpected issues running it. If that's the case please check the [FAQ page](https://github.com/deezer/spleeter/wiki/5.-FAQ) first as well as the list of [currently open issues](https://github.com/deezer/spleeter/issues)\n\n### Windows users\n\n It appears that sometimes the shortcut command `spleeter` does not work properly on windows. This is a known issue that we will hopefully fix soon. In the meantime replace `spleeter separate` by `python -m spleeter separate` in command line and it should work.\n\n## Contributing\n\nIf you would like to participate in the development of **Spleeter** you are more than welcome to do so. Don't hesitate to throw us a pull request and we'll do our best to examine it quickly. Please check out our [guidelines](.github/CONTRIBUTING.md) first.\n\n## Note\n\nThis repository include a demo audio file `audio_example.mp3` which is an excerpt\nfrom Slow Motion Dream by Steven M Bryant (c) copyright 2011 Licensed under a Creative\nCommons Attribution (3.0) [license](http://dig.ccmixter.org/files/stevieb357/34740)\nFt: CSoul,Alex Beroza & Robert Siekawitch", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/deezer/spleeter", "keywords": "", "license": "MIT License", "maintainer": "", "maintainer_email": "", "name": "spleeter-gpu", "package_url": "https://pypi.org/project/spleeter-gpu/", "platform": "", "project_url": "https://pypi.org/project/spleeter-gpu/", "project_urls": { "Homepage": "https://github.com/deezer/spleeter" }, "release_url": "https://pypi.org/project/spleeter-gpu/2.0.2/", "requires_dist": null, "requires_python": ">=3.6, <3.9", "summary": " The Deezer source separation library with pretrained models based on tensorflow. ", "version": "2.0.2", "yanked": false, "yanked_reason": null }, "last_serial": 8820946, "releases": { "1.4.4": [ { "comment_text": "", "digests": { "md5": "5b19eb68e554785cb336ac1ffe9920a2", "sha256": "49e776f26c561357eb9608a459030ab46cfe11edf21fb17470630a0d3777d453" }, "downloads": -1, "filename": "spleeter-gpu-1.4.4.tar.gz", "has_sig": false, "md5_digest": "5b19eb68e554785cb336ac1ffe9920a2", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.8", "size": 34796, "upload_time": "2019-11-21T17:30:33", "upload_time_iso_8601": "2019-11-21T17:30:33.297208Z", "url": "https://files.pythonhosted.org/packages/d9/08/d42ba42d10a8662eaead091cff9da028386030ec57853a0eaff30034deab/spleeter-gpu-1.4.4.tar.gz", "yanked": false, "yanked_reason": null } ], "1.4.5": [ { "comment_text": "", "digests": { "md5": "d3d5034691c72e1ead43cac15a264ddd", "sha256": "4ca8805a5bf4961dbde3a690ec94fad536182687bc1f2141540929f507581be2" }, "downloads": -1, "filename": "spleeter-gpu-1.4.5.tar.gz", "has_sig": false, "md5_digest": "d3d5034691c72e1ead43cac15a264ddd", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.8", "size": 34819, "upload_time": "2019-11-22T13:55:12", "upload_time_iso_8601": "2019-11-22T13:55:12.968048Z", "url": "https://files.pythonhosted.org/packages/f3/b2/99ee2ef3367912aa27e09e12f70315bc2bab3bf2abbb7955a7969e0ed423/spleeter-gpu-1.4.5.tar.gz", "yanked": false, "yanked_reason": null } ], "1.4.6": [ { "comment_text": "", "digests": { "md5": "83ff8d64467c1323e9311b93be196402", "sha256": "c93a2e4f6242b19e55d5463cffbd20455063060938641283949024fce371aecf" }, "downloads": -1, "filename": "spleeter-gpu-1.4.6.tar.gz", "has_sig": false, "md5_digest": "83ff8d64467c1323e9311b93be196402", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.8", "size": 34817, "upload_time": "2019-11-25T14:50:02", "upload_time_iso_8601": "2019-11-25T14:50:02.635836Z", "url": "https://files.pythonhosted.org/packages/44/c7/597af6023bf3097889c67b08d1d1a781bbe938fd7c30a8efc79bc02438a2/spleeter-gpu-1.4.6.tar.gz", "yanked": false, "yanked_reason": null } ], "1.4.7": [ { "comment_text": "", "digests": { "md5": "a2f13de718528093114f828355b43e85", "sha256": "3a8d275085d73584ff6116d4b76210fa667ea96361d08c22986a81a222840cc0" }, "downloads": -1, "filename": "spleeter-gpu-1.4.7.tar.gz", "has_sig": false, "md5_digest": "a2f13de718528093114f828355b43e85", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.8", "size": 34886, "upload_time": "2019-11-26T10:27:52", "upload_time_iso_8601": "2019-11-26T10:27:52.243336Z", "url": "https://files.pythonhosted.org/packages/7b/74/81bdf2704714bb8965140329ad77d1102a168b0546c324673f1a6b1f916f/spleeter-gpu-1.4.7.tar.gz", "yanked": false, "yanked_reason": null } ], "1.4.8": [ { "comment_text": "", "digests": { "md5": "3390d40cb7c74a3fd72e90c1499bc940", "sha256": "66ce14b260b0118a953937bcab7665b8950ba1d65cb3cbfd49b34756d623607d" }, "downloads": -1, "filename": "spleeter-gpu-1.4.8.tar.gz", "has_sig": false, "md5_digest": "3390d40cb7c74a3fd72e90c1499bc940", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.8", "size": 34830, "upload_time": "2019-11-26T12:53:09", "upload_time_iso_8601": "2019-11-26T12:53:09.407133Z", "url": "https://files.pythonhosted.org/packages/55/9f/3cc954bc0526585821988d892122d555c1e5f9f4ac0e5d29b2b64573e277/spleeter-gpu-1.4.8.tar.gz", "yanked": false, "yanked_reason": null } ], "1.4.9": [ { "comment_text": "", "digests": { "md5": "2dbb95ec6766178d1dc8b442fbb93ef4", "sha256": "6294ab301ebdb3eea0d002b3c42c18492f0356adf01a317b93edd720eb51aada" }, "downloads": -1, "filename": "spleeter-gpu-1.4.9.tar.gz", "has_sig": false, "md5_digest": "2dbb95ec6766178d1dc8b442fbb93ef4", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.8", "size": 35401, "upload_time": "2019-12-27T13:38:29", "upload_time_iso_8601": "2019-12-27T13:38:29.871968Z", "url": "https://files.pythonhosted.org/packages/37/9b/adb16ca709bb372a05a7c07236fdcb6a25030c19f18b086a57e0921757d8/spleeter-gpu-1.4.9.tar.gz", "yanked": false, "yanked_reason": null } ], "1.5.0": [ { "comment_text": "", "digests": { "md5": "0dd61feca9ef4a6acd8875f05366be5d", "sha256": "ee7c797a7bf7a957f6175012bdacc0a3eb0052b1ac7d2857aba16dde6a8d36fd" }, "downloads": -1, "filename": "spleeter-gpu-1.5.0.tar.gz", "has_sig": false, "md5_digest": "0dd61feca9ef4a6acd8875f05366be5d", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.8", "size": 37634, "upload_time": "2020-03-20T16:15:58", "upload_time_iso_8601": "2020-03-20T16:15:58.733662Z", "url": "https://files.pythonhosted.org/packages/07/6c/9274e075b8de0fa2aab65d11c840bd79c4381550a8fcf83f4fbf3534c385/spleeter-gpu-1.5.0.tar.gz", "yanked": false, "yanked_reason": null } ], "1.5.1": [ { "comment_text": "", "digests": { "md5": "de4744a918f963e6aa5019decc5df858", "sha256": "a496255d3e0998196c3d8bc193c33f3c2ca8e58de92272d5df92328a8e7ecb08" }, "downloads": -1, "filename": "spleeter-gpu-1.5.1.tar.gz", "has_sig": false, "md5_digest": "de4744a918f963e6aa5019decc5df858", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.8", "size": 38812, "upload_time": "2020-04-15T07:25:28", "upload_time_iso_8601": "2020-04-15T07:25:28.592424Z", "url": "https://files.pythonhosted.org/packages/f1/a0/8d6f3745e32140cc6d635246b60f2f66bd0f8293899b621366cfee403da4/spleeter-gpu-1.5.1.tar.gz", "yanked": false, "yanked_reason": null } ], "1.5.2": [ { "comment_text": "", "digests": { "md5": "41aed09e8ff8185298057f8015f26c12", "sha256": "7f99f456f01934fba1cb0a77e8d9c9aeb64e7dc13e8613c129a6dfcfe21af6dc" }, "downloads": -1, "filename": "spleeter-gpu-1.5.2.tar.gz", "has_sig": false, "md5_digest": "41aed09e8ff8185298057f8015f26c12", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.8", "size": 39385, "upload_time": "2020-05-15T14:19:33", "upload_time_iso_8601": "2020-05-15T14:19:33.280225Z", "url": "https://files.pythonhosted.org/packages/32/ed/797d0f39e024e0b9159b6352f6d5114e3f250c1aa56f100fee98e764f6b2/spleeter-gpu-1.5.2.tar.gz", "yanked": false, "yanked_reason": null } ], "1.5.3": [ { "comment_text": "", "digests": { "md5": "9cdd2415eeb80d9ed80aa915dc172dc7", "sha256": "dc9c6f2a4f092c93565368c66ba2efa7c2ac82e0cc698a8f3ec8c4f6ff7714ee" }, "downloads": -1, "filename": "spleeter-gpu-1.5.3.tar.gz", "has_sig": false, "md5_digest": "9cdd2415eeb80d9ed80aa915dc172dc7", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.8", "size": 39706, "upload_time": "2020-06-17T14:42:16", "upload_time_iso_8601": "2020-06-17T14:42:16.728219Z", "url": "https://files.pythonhosted.org/packages/1b/03/d1885d1289a333df63c10cf5a9dd3c04f0e1eeb18923ffb6cf7a129939a3/spleeter-gpu-1.5.3.tar.gz", "yanked": false, "yanked_reason": null } ], "1.5.4": [ { "comment_text": "", "digests": { "md5": "6b6e3094ee20db85ec083cc8400cc3dc", "sha256": "4517da544becc5d4fdc198fc2800746089a4e63133acb3e2d3f5e4b85af82e1f" }, "downloads": -1, "filename": "spleeter-gpu-1.5.4.tar.gz", "has_sig": false, "md5_digest": "6b6e3094ee20db85ec083cc8400cc3dc", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.8", "size": 38348, "upload_time": "2020-07-17T14:04:47", "upload_time_iso_8601": "2020-07-17T14:04:47.722694Z", "url": "https://files.pythonhosted.org/packages/d7/56/3752ebcac6cbceafa3312836f058d394f6154accf49537bbf23aab8a092b/spleeter-gpu-1.5.4.tar.gz", "yanked": false, "yanked_reason": null } ], "2.0": [ { "comment_text": "", "digests": { "md5": "8b5311b665ecee0dc218e1792769959d", "sha256": "c7a4fc710e84ea033eaecdc1f30f61834c5ffda669f4e553cf01fc1bdc5f3469" }, "downloads": -1, "filename": "spleeter-gpu-2.0.tar.gz", "has_sig": false, "md5_digest": "8b5311b665ecee0dc218e1792769959d", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.9", "size": 38587, "upload_time": "2020-10-09T14:10:22", "upload_time_iso_8601": "2020-10-09T14:10:22.926981Z", "url": "https://files.pythonhosted.org/packages/38/b5/d6483812a75e7bfd273517625a5b84ecabb3fd310c6c8fb047cd8a8a1b9e/spleeter-gpu-2.0.tar.gz", "yanked": false, "yanked_reason": null } ], "2.0.1": [ { "comment_text": "", "digests": { "md5": "eeafb007d21e05296d7bb6f3f20cccc7", "sha256": "9d7be1e30dbbc5ea3e2004966ccaa405c047d2c40a4148e056ee4b7036ec63c5" }, "downloads": -1, "filename": "spleeter-gpu-2.0.1.tar.gz", "has_sig": false, "md5_digest": "eeafb007d21e05296d7bb6f3f20cccc7", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.9", "size": 39482, "upload_time": "2020-10-23T12:15:40", "upload_time_iso_8601": "2020-10-23T12:15:40.352650Z", "url": "https://files.pythonhosted.org/packages/fe/a3/af69d54818bde26cec5b4bf0aabe8cf1d901874d4891b4549ab74d544458/spleeter-gpu-2.0.1.tar.gz", "yanked": false, "yanked_reason": null } ], "2.0.2": [ { "comment_text": "", "digests": { "md5": "291d041a7d0c73b6ab38e9b2e1e4ac4f", "sha256": "f57502402bf2e5e57a48a55bc787aa33332be6448087fc786ac11ab470a94634" }, "downloads": -1, "filename": "spleeter-gpu-2.0.2.tar.gz", "has_sig": false, "md5_digest": "291d041a7d0c73b6ab38e9b2e1e4ac4f", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.9", "size": 39537, "upload_time": "2020-12-04T11:44:05", "upload_time_iso_8601": "2020-12-04T11:44:05.333743Z", "url": "https://files.pythonhosted.org/packages/16/54/61711816f77cad53d19f304b1a6f85f1f2c19af8d87dd864da5d73cba961/spleeter-gpu-2.0.2.tar.gz", "yanked": false, "yanked_reason": null } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "291d041a7d0c73b6ab38e9b2e1e4ac4f", "sha256": "f57502402bf2e5e57a48a55bc787aa33332be6448087fc786ac11ab470a94634" }, "downloads": -1, "filename": "spleeter-gpu-2.0.2.tar.gz", "has_sig": false, "md5_digest": "291d041a7d0c73b6ab38e9b2e1e4ac4f", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6, <3.9", "size": 39537, "upload_time": "2020-12-04T11:44:05", "upload_time_iso_8601": "2020-12-04T11:44:05.333743Z", "url": "https://files.pythonhosted.org/packages/16/54/61711816f77cad53d19f304b1a6f85f1f2c19af8d87dd864da5d73cba961/spleeter-gpu-2.0.2.tar.gz", "yanked": false, "yanked_reason": null } ], "vulnerabilities": [] }