search

Anjok07 / ultimatevocalremovergui

GUI for a Vocal Remover that uses Deep Neural Networks.
MIT License
16.41k stars 1.24k forks source link
audio instrumental karaoke kareokee music pytorch separation source spectrogram vocal vocal-remover vocals

readme

Ultimate Vocal Remover GUI v5.6

Release Downloads

About

This application uses state-of-the-art source separation models to remove vocals from audio files. UVR's core developers trained all of the models provided in this package (except for the Demucs v3 and v4 4-stem models).

Installation

These bundles contain the UVR interface, Python, PyTorch, and other dependencies needed to run the application effectively. No prerequisites are required.

Windows Installation

Windows Manual Installation ### Manual Windows Installation - Download and extract the repository [here](https://github.com/Anjok07/ultimatevocalremovergui/archive/refs/heads/master.zip) - Download and install Python [here](https://www.python.org/ftp/python/3.9.8/python-3.9.8-amd64.exe) - Make sure to check "Add python.exe to PATH" during the install - Run the following commands from the extracted repo directory: ``` python.exe -m pip install -r requirements.txt ``` If you have a compatible Nvidia GPU, run the following command: ``` python.exe -m pip install --upgrade torch --extra-index-url https://download.pytorch.org/whl/cu117 ``` If you do not have FFmpeg or Rubber Band installed and want to avoid going through the process of installing them the long way, follow the instructions below. **FFmpeg Installation** - Download the precompiled build [here](https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-essentials.zip) - From the archive, extract the following file to the UVR application directory: - ```ffmpeg-5.1.2-essentials_build/bin/ffmpeg.exe``` **Rubber Band Installation** In order to use the Time Stretch or Change Pitch tool, you'll need Rubber Band. - Download the precompiled build [here](https://breakfastquay.com/files/releases/rubberband-3.1.2-gpl-executable-windows.zip) - From the archive, extract the following files to the UVR application directory: - ```rubberband-3.1.2-gpl-executable-windows/rubberband.exe``` - ```rubberband-3.1.2-gpl-executable-windows/sndfile.dll```

MacOS Installation

MacOS Users: Having Trouble Opening UVR? > Due to Apples strict application security, you may need to follow these steps to open UVR. > > First, run the following command via Terminal.app to allow applications to run from all sources (it's recommended that you re-enable this once UVR opens properly.) > > ```bash > sudo spctl --master-disable > ``` > > Second, run the following command to bypass Notarization: > > ```bash > sudo xattr -rd com.apple.quarantine /Applications/Ultimate\ Vocal\ Remover.app > ```
Manual MacOS Installation ### Manual MacOS Installation - Download and save this repository [here](https://github.com/Anjok07/ultimatevocalremovergui/archive/refs/heads/master.zip) - Download and install Python 3.10 [here](https://www.python.org/ftp/python/3.10.9/python-3.10.9-macos11.pkg) - From the saved directory run the following - ``` pip3 install -r requirements.txt ``` - If your Mac is running with an M1, please run the following command next. If not, skip this step. - ``` cp /Library/Frameworks/Python.framework/Versions/3.10/lib/python3.10/site-packages/_soundfile_data/libsndfile_arm64.dylib /Library/Frameworks/Python.framework/Versions/3.10/lib/python3.10/site-packages/_soundfile_data/libsndfile.dylib ``` **FFmpeg Installation** - Once everything is done installing, download the correct FFmpeg binary for your system [here](http://www.osxexperts.net) and place it into the main application directory. **Rubber Band Installation** In order to use the Time Stretch or Change Pitch tool, you'll need Rubber Band. - Download the precompiled build [here](https://breakfastquay.com/files/releases/rubberband-3.1.2-gpl-executable-windows.zip) - From the archive, extract the following files to the UVR/lib_v5 application directory: - ```rubberband-3.1.2-gpl-executable-macos/rubberband``` This process has been tested on a MacBook Pro 2021 (using M1) and a MacBook Air 2017 and is confirmed to be working on both.

Linux Installation

See Linux Installation Instructions
**These install instructions are for Debian & Arch based Linux systems.** - Download and save this repository [here](https://github.com/Anjok07/ultimatevocalremovergui/archive/refs/heads/master.zip) - From the saved directory run the following commands in this order- **For Debian Based (Ubuntu, Mint, etc.):** ``` sudo apt update && sudo apt upgrade sudo apt-get update sudo apt install ffmpeg sudo apt install python3-pip sudo apt-get -y install python3-tk pip3 install -r requirements.txt python3 UVR.py ``` **For Arch Based (EndeavourOS):** ``` sudo pacman -Syu sudo pacman -Sy sudo pacman -S python-pip sudo pacman -S --noconfirm tk sudo pacman -S ffmpeg ``` To bypass environment setup and proceed with the installation, use: - Take caution; this modifies system files. ``` sudo rm /usr/lib/python3.11/EXTERNALLY-MANAGED ``` Then proceed with the following in order: ``` chmod +x install_packages.sh ./install_packages.sh python UVR.py ```

Other Application Notes

Performance:

Troubleshooting

Common Issues

MacOS Sonoma Left-click Bug

There's a known issue on MacOS Sonoma where left-clicks aren't registering correctly within the app. This was impacting all applications built with Tkinter on Sonoma and has since been resolved. Please download the latest version via the following link if you are still experiencing issues - link

This issue was being tracked here.

Issue Reporting

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

If possible, click the "Settings Button" to the left of the "Start Processing" button and click the "Error Log" button for detailed error information that can be provided to us.

License

The Ultimate Vocal Remover GUI code is MIT-licensed.

Credits

Contributing

References