Skip to content

Jas0n2k/ultimatevocalremovergui

 
 

Repository files navigation

Ultimate Vocal Remover GUI v5.4.0

Release Downloads

English | 简体中文

About

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

Installation

Windows Installation

This installation bundle contains the UVR interface, Python, PyTorch, and other dependencies needed to run the application effectively. No prerequisites are required.

  • Please Note:

    • This installer is intended for those running Windows 10 or higher.
    • Application functionality for systems running Windows 7 or lower is not guaranteed.
    • Application functionality for Intel Pentium & Celeron CPUs systems is not guaranteed.
  • Download the UVR installer via the link below:

  • Update Package instructions for those who have UVR already installed:

  • Optional

    • Additional models and application patches can be downloaded via the "Settings" menu within the application.
  • Please Note: See the latest release page for more recent updates here

Other Platforms

UVR can run on macOS & Linux by performing a manual install (see the Manual Developer Installation section below for more information). Some features may not be available on non-Windows platforms.

Application Manual

General Options

VR Architecture Options

MDX-Net Options

Demucs v3 Options

Ensemble Options

User Ensemble

Other Application Notes

  • UVR only supports 64-bit platforms.
  • NVIDIA GPUs with at least 8GBs of V-RAM are recommended.
  • Additional pakages are required for certain functions:
    • SoX (Sound eXchange) is required for noise reduction.
    • FFmpeg is required to process non-wav audio files.
  • Settings will be automatically saved on quitting.
  • Time of processing significantly depends on your hardware spec.
  • These models are computationally intensive. Please proceed with caution and pay attention to your computer to ensure it doesn't overheat. We are not responsible for any hardware damage.

Change Log

  • v4 vs. v5
    • The v5 models significantly outperform the v4 models.
    • The extraction's aggressiveness can be adjusted using the "Aggression Setting." The default value of 10 is optimal for most tracks.
    • All v2 and v4 models have been removed.
    • Ensemble Mode added - This allows the user to get the most robust result from each model.
    • Stacked models have been entirely removed. The new aggression setting and model ensemble have replaced the stacked model feature.
    • The NFFT, HOP_SIZE, and SR values are now set internally.
    • The MDX-NET AI engine and models have been added.
      • This is a brand-new feature added to the UVR GUI.
      • 4 MDX-Net models are included in this package.
      • The MDX-Net models provided were trained by the core UVR developers
      • This network is less resource-intensive but incredibly powerful.
      • MDX-Net is a Hybrid Waveform/Spectrogram network.
    • The Demucs v3 AI engine and models have been added.
    • The ability to separate all 4 stems through Demucs v3.

Troubleshooting

Common Issues

  • If FFmpeg is not installed, the application will throw an error if the user attempts to convert a non-WAV file.
  • Memory allocation errors can usually be resolved by lowering the "Chunk Size".

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.

Manual Installation (For Developers)

These instructions are for those installing UVR v5.4.0 manually only.

Prerequisites

  • FFmpeg

    FFmpeg must be installed and configured for the application to process any non-WAV track. You will need to look up instructions on how to configure it on your operating system.

  • (Windows Only) Microsoft Visual C++ Build Tools

    VS C++ Build Tools will be required when you use pip install certain pakages. You will need to install Visual C++ Build Tools in the first place, otherwise, Microsoft Visual C++ 14.0 is required. Get it with “Microsoft Visual C++ Build Tools” error will be thrown.

Steps

  1. Download & install Python 3.9 or lower (but no lower than 3.6) here
    • Note: Ensure the "Add Python to PATH" box is checked.
  2. Download the Source code here
  3. Download the models via the "Settings" menu within the application.
  4. Extract the ultimatevocalremovergui-master folder within ultimatevocalremovergui-master.zip where ever you wish.
  5. Download the SoX archive here and extract the contents into the ultimatevocalremovergui-master/lib_v5/sox directory.
  6. Open the command prompt from the ultimatevocalremovergui-master directory and run the following commands, separately -
pip install --no-cache-dir -r requirements.txt
pip install torch==1.9.0+cu111 torchvision==0.10.0+cu111 torchaudio==0.9.0 -f https://download.pytorch.org/whl/torch_stable.html

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

License

The Ultimate Vocal Remover GUI code is MIT-licensed.

  • Please Note: For all third-party application developers who wish to use our models, please honor the MIT license by providing credit to UVR and its developers.

Credits

  • DilanBoskan - Your contributions at the start of this project were essential to the success of UVR. Thank you!
  • Bas Curtiz - Designed the official UVR logo, icon, banner, and splash screen.
  • tsurumeso - Developed the original VR Architecture code.
  • Kuielab & Woosung Choi - Developed the original MDX-Net AI code.
  • Adefossez & Demucs - Developed the original Demucs AI code.
  • KimberleyJSN - Advised and aided the implementation of the training scripts for MDX-Net and Demucs. Thank you!
  • Hv - Helped implement chunks into the MDX-Net AI code. Thank you!

Contributing

  • For anyone interested in the ongoing development of Ultimate Vocal Remover GUI, please send us a pull request, and we will review it.
  • This project is 100% open-source and free for anyone to use and modify as they wish.
  • We only maintain the development and support for the Ultimate Vocal Remover GUI and the models provided.

References

About

GUI for a Vocal Remover that uses Deep Neural Networks.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 98.0%
  • Tcl 2.0%