Home

Awesome

Ultimate Vocal Remover GUI v5.6

<img src="https://raw.githubusercontent.com/Anjok07/ultimatevocalremovergui/master/gui_data/img/UVR_v5.6.png?raw=true" />

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

<details id="WindowsManual"> <summary>Windows Manual Installation</summary>

Manual Windows Installation

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

Rubber Band Installation

In order to use the Time Stretch or Change Pitch tool, you'll need Rubber Band.

</details>

MacOS Installation

<details id="CannotOpen"> <summary>MacOS Users: Having Trouble Opening UVR?</summary>

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.)

sudo spctl --master-disable

Second, run the following command to bypass Notarization:

sudo xattr -rd com.apple.quarantine /Applications/Ultimate\ Vocal\ Remover.app
</details> <details id="MacInstall"> <summary>Manual MacOS Installation</summary>

Manual MacOS Installation

pip3 install -r requirements.txt

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

Rubber Band Installation

In order to use the Time Stretch or Change Pitch tool, you'll need Rubber Band.

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.

</details>

Linux Installation

<details id="LinuxInstall"> <summary>See Linux Installation Instructions</summary> <br />

These install instructions are for Debian & Arch based Linux systems.

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:

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
</details>

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