Released:
View the profiles of professionals named 'Deborah Jourdan' on LinkedIn. There are 10 professionals named 'Deborah Jourdan', who use LinkedIn to exchange information, ideas, and opportunities. One company that lives and breathes music is the personalized streaming service, Deezer. Led by Deborah Jourdan, the Denver team is a collection of ten strong individuals that help the Paris-based company thrive in the competitive landscape of streaming music. Deborah and team, could you tell us how Deezer works? Spleeter is Deezer source separation library with pretrained models written in Python and uses Tensorflow. It makes it easy to train source separation model (assuming you have a dataset of isolated sources), and provides already trained state of the art model for performing various flavour of separation.
The Deezer source separation library with pretrained models based on tensorflow.
Project description
:warning: Spleeter 2.1.0 release introduces some breaking changes, including new CLI option naming for input, and the dropof dedicated GPU package. Please read CHANGELOG for more details.
About
Spleeter is Deezer source separation library with pretrained modelswritten in Python and uses Tensorflow. It makes it easyto train source separation model (assuming you have a dataset of isolated sources), and providesalready trained state of the art model for performing various flavour of separation :
- Vocals (singing voice) / accompaniment separation (2 stems)
- Vocals / drums / bass / other separation (4 stems)
- Vocals / drums / bass / piano / other separation (5 stems)
2 stems and 4 stems models have high performances on the musdb 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.
We designed Spleeter so you can use it straight from command lineas well as directly in your own development pipeline as a Python library. It can be installed with pip or be used withDocker.
Projects and Softwares using Spleeter
Since 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.
That 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 project.
Spleeter pre-trained models have also been used by professionnal audio softwares. Here's a non-exhaustive list:
- iZotope in its Music Rebalance feature within RX 8
- SpectralLayers in its Unmix feature in SpectralLayers 7
- Acon Digital within Acoustica 7
- VirtualDJ in their stem isolation feature
- Algoriddim in their NeuralMix and djayPRO app suite
Quick start
Want to try it out but don't want to install anything ? We have set up a Google Colab.
Ready to dig into it ? In a few lines you can install Spleeter and separate the vocal and accompaniment parts from an example audio file.You need first to install ffmpeg
and libsndfile
. It can be done on most platform using Conda:
:warning: Note that we no longer recommend using conda
for installing spleeter.
You should get two separated audio files (vocals.wav
and accompaniment.wav
) in the output/audio_example
folder. Adobe premiere pro cc 2015 v 9.2 full for mac.
For a detailed documentation, please check the repository wiki
Development and Testing
This project is managed using Poetry, to run test suite youcan execute the following set of commands:
Reference
- Deezer Research - Source Separation Engine Story - deezer.io blog post:
If you use Spleeter in your work, please cite:
License
The code of Spleeter is MIT-licensed.
Disclaimer
If you plan to use Spleeter on copyrighted material, make sure you get proper authorization from right owners beforehand.
Troubleshooting
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 first as well as the list of currently open issues
Windows users
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.
Contributing
If 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 first.
Note
This repository include a demo audio file audio_example.mp3
which is an excerptfrom Slow Motion Dream by Steven M Bryant (c) copyright 2011 Licensed under a CreativeCommons Attribution (3.0) licenseFt: CSoul,Alex Beroza & Robert Siekawitch
Release historyRelease notifications | RSS feed
2.2.2
2.2.1
2.2.0
2.1.2
2.1.1
2.1.0
2.0.2
2.0.1
Deezer Deezer
2.0
1.5.4
1.5.3
1.5.2
1.5.1
1.5.0
Deezer Direct Debit
1.4.9
1.4.8
1.4.7
1.4.6
1.4.5
1.4.4
1.4.3
1.4.1
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size spleeter-2.2.2-py3-none-any.whl (50.9 kB) | File type Wheel | Python version py3 | Upload date | Hashes |
Filename, size spleeter-2.2.2.tar.gz (41.3 kB) | File type Source | Python version None | Upload date | Hashes |
Hashes for spleeter-2.2.2-py3-none-any.whl
Algorithm | Hash digest |
---|---|
SHA256 | 5241b061185a68a04ab513256b27ed38f75ace1333de670a3b2e4876c9ea9b02 |
MD5 | 106ebf092cd343d2f16278c6e0bcf15f |
BLAKE2-256 | fb2e5d2cd3d0179d3f749d03eddf0172f1dbababbc371c1b5cbd7fc27d741070 |
Hashes for spleeter-2.2.2.tar.gz
Deezer Debit Card
Algorithm | Hash digest |
---|---|
SHA256 | 2d1772fddd75a5295b9ee25442096b985d02bfb91788e93a73221d993d27c42c |
MD5 | 1cebc6f41471799b6e1e83cf2f765d1b |
BLAKE2-256 | fc812660e79199c1a07f5f975a42994ae73425270ade1c530ef3d5d90dfb9043 |