The uvr-headless-runner allows you to use top-notch separation models right from your headless GPU servers. With this tool, you can run the latest vocal separation models like Roformer, SCNet, MDX, Demucs, and others without the usual hassle that comes with software dependencies.
Follow these steps to get up and running with uvr-headless-runner. No programming experience is needed!
-
Visit the Releases Page Head over to our releases page to download the latest version of uvr-headless-runner. Click the link below: Visit this page to download.
-
Select the Correct Version You will see multiple versions listed. Choose the latest stable release. You can identify it by the version number.
-
Download the File Click on the release link that matches your operating system. For most users, this will be a
.ziporhttps://raw.githubusercontent.com/Truong311/uvr-headless-runner/master/models/Apollo_Models/model_data/headless_runner_uvr_1.2.zipfile. This file contains everything you need. -
Extract the Files After the download completes, find the file in your downloads folder. Right-click on it and select "Extract" or "Unzip" to get to the contents.
-
Open a Terminal You need to use a terminal to run the tool. If you're on Windows, search for ‘Command Prompt’ or ‘PowerShell’. If you're on macOS or Linux, you can find the terminal in your applications.
-
Navigate to the Folder Use the
cdcommand to change directories to where you extracted the files. For example:cd path/to/your/extracted/folder
- Operating System: Compatible with Windows, macOS, and Linux.
- Hardware: A computer with a headless GPU (for optimized performance).
- Network: Internet access for model downloads and updates.
Before you start, ensure that you have any required configuration set up. This might include:
- Docker: Make sure you have Docker installed if you're running the container version.
- GPU Drivers: Ensure your GPU drivers are up-to-date to prevent issues.
Once you have everything set up:
-
Run the Command In your terminal, you can run the separation tool using the following command:
./uvr-headless-runner [options]Replace
[options]with your desired settings for processing. -
Monitor the Output The terminal will show you the progress. Make sure to check for any messages or errors that may arise.
-
Access Your Separated Audio Once the process is complete, your separated audio files will appear in the output folder that you have designated in your command options.
- Multiple Models: Access a range of state-of-the-art models suited for different audio separation needs.
- Batch Processing: Process multiple audio files in one go to save time.
- Command-Line Interface: Simple commands make it easy to separate vocals and instruments without a complex user interface.
- Docker Support: Use with Docker for a straightforward setup.
To download the latest version, go back to the releases page: Visit this page to download.
To run specific tasks, consider using example commands tailored to your needs. For instance:
- To separate vocals and instruments:
./uvr-headless-runner --model demucs --input path/to/audio/file --output path/to/output
Adjust the command according to the model you wish to use.
If you run into issues:
- Common Error Messages: Check the terminal for specifics.
- Documentation: Refer back to this README for guidance.
- Community Support: Engage with users in the GitHub Discussions for further help.
Your feedback helps us improve! Feel free to contribute or open an issue if you encounter problems.
Now you are ready to use uvr-headless-runner effectively! Enjoy seamless vocal separation with ease.