Frikallo / MISST

A local GUI music source separation tool built on Tkinter and demucs serving as a free and open source Stem Player
GNU General Public License v3.0
94 stars 12 forks source link
audio audio-player audio-source-separation demucs gui modern mp3 music music-player python source stemplayer tkinter tkinter-gui windows
[![](./MISST/Assets/showcase/banner.png)](https://github.com/Frikallo/MISST) [![GitHub release](https://img.shields.io/github/release/frikallo/misst.svg)](https://github.com/Frikallo/MISST/releases/latest) [![Github All Releases](https://img.shields.io/github/downloads/frikallo/misst/total?color=blue)](https://github.com/Frikallo/MISST/releases/latest) [![License](https://img.shields.io/github/license/frikallo/misst?color=blue)](https://github.com/Frikallo/MISST/blob/main/LICENSE) [![Hits-of-Code](https://hitsofcode.com/github/frikallo/MISST?branch=main)](https://github.com/Frikallo/MISST/graphs/contributors)

| MISST on Windows 11 with Dark mode and 'Blue' theme with 'Steve Lacy's Infrunami' playing

| MISST on Windows 11 with Light mode and 'Blue' theme with 'Frank Ocean's Ivy' playing

| MISST on Windows 11 Showcasing how versatile and personal you can be with MISST!

| MISST on Windows 11 Showcasing how importing audios is as easy as two clicks!

Original Repository of MISST : Music/Instrumental Stem Separation Tool.

This application uses state-of-the-art demucs source separation models to extract the 4 core stems from audio files (Bass, Drums, Other Instrumentals and Vocals). But it is not limited to this. MISST acts as a developped music player aswell, fit to enjoy and medal with your audio files as you see fit. MISST even comes prepared to import songs and playlists directly from your music library.

This project is OpenSource, feel free to use, study and/or send pull request.

Objectives:

Installation

As of version 3.1.0, MISST is only available on windows with guaranteed compatibility.

Until a later release :

Manual Installation

These instructions are for those installing MISST v3.1.0 manually only.

  1. Download & install Python 3.9 or higher (but no lower than 3.9.0) here
    • Note: Ensure the "Add Python to PATH" box is checked
  2. Download the Source code here
  3. Open the command prompt from the MISST directory and run the following commands, separately -
$ python3 -m venv ./venv
$ pip install -r requirements.txt
$ python3 MISSTapp.py

From here you should be able to open and run the MISSTapp.py file

Benchmark

The audio processing performance was evaluated using an NVIDIA GeForce RTX 2070 SUPER with 8GB VRAM and an AMD Ryzen 3700X 8-Core Processor on the htdemucs pretrained model. This test aimed to compare the processing time of audio on a CPU versus a GPU.

Here are the results of the test:

Source Source Length CPU GPU Model
Frank Ocean - Ivy 4m 09.00s 2m 22.16s 0m 28.04s htdemucs

Demo

https://github.com/Frikallo/MISST/assets/88942100/15fb7ce3-9f83-4228-9ab0-f453593be632

Open in YouTube

License

The MISST code is GPL-licensed.

Issue Reporting

Please be as detailed as possible when posting a new issue.

If possible, check the "MISST.log" file in your install directory for detailed error information that can be provided to me.

Contributing

More documentation to come...