{"id":28600852,"url":"https://github.com/eddycrack864/uvr5-ui","last_synced_at":"2025-06-11T14:39:08.330Z","repository":{"id":246990398,"uuid":"823186835","full_name":"Eddycrack864/UVR5-UI","owner":"Eddycrack864","description":"Ultimate Vocal Remover 5 with Gradio UI. Separate an audio file into various stems, using multiple models","archived":false,"fork":false,"pushed_at":"2025-05-02T02:25:12.000Z","size":491,"stargazers_count":366,"open_issues_count":6,"forks_count":32,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-02T03:26:25.441Z","etag":null,"topics":["audio","gradio-python-app","instrumental","karaoke","separation","vocal","vocal-remover"],"latest_commit_sha":null,"homepage":"https://huggingface.co/spaces/TheStinger/UVR5_UI","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Eddycrack864.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"eddycrack864","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2024-07-02T14:45:50.000Z","updated_at":"2025-05-02T02:25:16.000Z","dependencies_parsed_at":"2024-07-22T15:30:26.403Z","dependency_job_id":"9eabd890-dcf4-49e2-8085-47d167b46aea","html_url":"https://github.com/Eddycrack864/UVR5-UI","commit_stats":null,"previous_names":["eddycrack864/uvr5-ui"],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eddycrack864%2FUVR5-UI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eddycrack864%2FUVR5-UI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eddycrack864%2FUVR5-UI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eddycrack864%2FUVR5-UI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Eddycrack864","download_url":"https://codeload.github.com/Eddycrack864/UVR5-UI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eddycrack864%2FUVR5-UI/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259280915,"owners_count":22833475,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","gradio-python-app","instrumental","karaoke","separation","vocal","vocal-remover"],"created_at":"2025-06-11T14:39:07.486Z","updated_at":"2025-06-11T14:39:08.318Z","avatar_url":"https://github.com/Eddycrack864.png","language":"Python","funding_links":["https://ko-fi.com/eddycrack864","https://www.buymeacoffee.com/uvr5"],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\u003cb\u003e 🎵 UVR5 UI 🎵 \u003c/b\u003e\u003c/h1\u003e\r\n\u003cdiv align=\"center\"\u003e\r\n\r\n[![madewithlove](https://img.shields.io/badge/made_with-%E2%9D%A4-red?style=for-the-badge\u0026labelColor=orange)](https://github.com/Eddycrack864/UVR5-UI)\r\n\r\n![cutecounter](https://count.nett.moe/get/uvr5_ui_colab/img?theme=rule34)\r\n\r\n[![Open In Colab](https://img.shields.io/badge/Colab-F9AB00?style=for-the-badge\u0026logo=googlecolab\u0026color=525252)](https://colab.research.google.com/github/Eddycrack864/UVR5-UI/blob/main/UVR_UI.ipynb)\r\n[![Open In Kaggle](https://img.shields.io/badge/Kaggle-20BEFF?style=for-the-badge\u0026logo=Kaggle\u0026logoColor=white)](https://www.kaggle.com/code/eddycrack864/uvr5-ui)\r\n\u003ca target=\"_blank\" href=\"https://lightning.ai/new?repo_url=https%3A%2F%2Fgithub.com%2FEddycrack864%2FUVR5-UI%2Fblob%2Fmain%2FUVR_UI.ipynb\"\u003e\r\n\u003cimg src=\"https://pl-bolts-doc-images.s3.us-east-2.amazonaws.com/app-2/studio-badge.svg\" alt=\"Open in Studio\"/\u003e\u003c/a\u003e\r\n[![Licence](https://img.shields.io/badge/LICENSE-MIT-green.svg?style=for-the-badge)](https://github.com/Eddycrack864/UVR5-UI/blob/main/LICENSE)\r\n[![Discord](https://img.shields.io/badge/Community-Discord-7289DA?style=for-the-badge\u0026logo=discord\u0026logoColor=white)](https://discord.gg/aihub)\r\n\r\nThis project is based on [python-audio-separator](https://github.com/karaokenerds/python-audio-separator) (a CLI version of UVR5). This project was originally created for the [AI ​​HUB](https://discord.gg/aihub) community.\r\n\r\n\u003c/div\u003e\r\n\u003cdiv align=\"center\"\u003e\r\n  \r\n[![Hugging Face](https://huggingface.co/datasets/huggingface/badges/resolve/main/open-in-hf-spaces-xl-dark.svg?download=true)](https://huggingface.co/spaces/TheStinger/UVR5_UI)\r\n\r\nYou can also try it on HuggingFace Spaces running with Zero GPU (A100)!\r\n\r\n\u003c/div\u003e\r\n \r\n\u003cdiv align=\"center\"\u003e\r\n\r\n**[Docs](https://github.com/Eddycrack864/UVR5-UI/blob/main/info/docs.md) / [Troubleshooting](https://github.com/Eddycrack864/UVR5-UI/blob/main/info/troubleshooting.md)**\r\n\r\n\u003c/div\u003e\r\n\r\n## Features: \r\n* User Friendly Interface\r\n* All VR Arch Models\r\n* All MDX-NET Models\r\n* Demucs v4 Models\r\n* MDX23C Models\r\n* Mel-Band Roformer Models\r\n* BS Roformer Models\r\n* Music Source Separation Models\r\n* VIP Models\r\n* Separation of an audio/video from all sites supported by [yt_dlp](https://github.com/yt-dlp/yt-dlp). Check the complete list [here](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md).\r\n* Batch Separation\r\n* Available in multiple languages\r\n* Colab/Kaggle/Lightning.ai support\r\n* Windows/Linux support\r\n\r\n## Requirements\r\n\r\n### Hardware Requirements:\r\n* Nvidia Series 2000 (RTX) or higher.\r\n* At least 10Gb of disk space. \r\n\r\n\u003e [!NOTE]  \r\n\u003e Older NVIDIA GPUs will be very slow. CPU will be insanely slow. If you don't meet the hardware requirements use our [Colab](https://colab.research.google.com/github/Eddycrack864/UVR5-UI/blob/main/UVR_UI.ipynb)/[Kaggle](https://www.kaggle.com/code/eddycrack864/uvr5-ui)/[Lightning.ai](https://lightning.ai/eddycrack864/studios/uvr5-ui)/[Hugging Face](https://huggingface.co/spaces/TheStinger/UVR5_UI).\r\n\r\n### Prerequisites:\r\n- Git. You can download Git [here](https://git-scm.com/downloads).\r\n- FFmpeg. You can download FFmpeg [here](https://www.ffmpeg.org/download.html) or you can use my [automated installation script](https://github.com/Eddycrack864/UVR5-UI/blob/main/info/ffmpeg-installer.bat) (for Windows).\r\n- For linux users, run this command on an terminal: (Debian and Ubuntu users): `sudo apt install ffmpeg git` (For Arch linux users): `sudo pacman -S ffmpeg git` (For Fedora users): `sudo dnf install ffmpeg git`\r\n(Some distributions already come with Git and FFmpeg preinstalled so this step may be optional.)\r\n\r\n\u003e [!IMPORTANT]  \r\n\u003e FFmpeg has to be added to the PATH. (only needed on Windows)\r\n\r\n## Getting Started\r\n\r\nClone the repository (git needed) or download the source code of the latest release [here](https://github.com/Eddycrack864/UVR5-UI/releases)\r\n\r\n```\r\ngit clone https://github.com/Eddycrack864/UVR5-UI.git\r\n```\r\n\r\nThen continue with the steps described below\r\n\r\n### 1. Installation\r\n\r\nRun the installation script based on your operating system:\r\n\r\n- **Windows:** Double-click `UVR5-UI-installer.bat` (DONT RUN AS ADMINISTRATOR 🚧).\r\n- **Linux:** Run `UVR5-UI-installer.sh` with `chmod +x UVR5-UI-installer.sh` and `./UVR5-UI-installer.sh`.\r\n\r\n### 2. Running UVR5 UI\r\n\r\nStart UVR5 UI using:\r\n\r\n- **Windows:** Double-click `run-UVR5-UI.bat`.\r\n- **Linux:** Run `run-UVR5-UI.sh` with `chmod +x run-UVR5-UI.sh` and `./run-UVR5-UI.sh`.\r\n\r\n### 3. Update UVR5 UI (If you want/need it)\r\n\r\nUpdate UVR5 UI using (git needed):\r\n\r\n- **Windows:** Double-click `UVR5-UI-updater.bat`.\r\n- **Linux:** Run `UVR5-UI-updater.sh` with `chmod +x UVR5-UI-updater.sh` and `./UVR5-UI-updater.sh`.\r\n\r\nIf you find an error when installing or running the program please consult [this troubleshooting file](https://github.com/Eddycrack864/UVR5-UI/blob/main/info/troubleshooting.md) first, if your error is not described there please create an [issue](https://github.com/Eddycrack864/UVR5-UI/issues)\r\n\r\n### 4. Debug (If you want/need it)\r\n\r\nCheck the status of audio-separator core:\r\n\r\n- **Windows:** Double-click `status-checker.bat`.\r\n- **Linux:** Run `status-checker.sh` with `chmod +x status-checker.sh` and `./status-checker.sh`.\r\n\r\n## Precompiled Version\r\n1. Get the precompiled version (.zip) for your PC:\r\n   - **[Windows](https://huggingface.co/Eddycrack864/UVR5-UI/tree/main/Windows)**\r\n   - **[Linux](https://huggingface.co/Eddycrack864/UVR5-UI/tree/main/Linux)**\r\n\r\n2. Extract the .zip file, I recommend using the \"extract here\" option.\r\n3. You can now use all the features of the normal installation.\r\n\r\n\u003e [!NOTE]  \r\n\u003e Still, to update UVR5 UI you need to install Git.\r\n\r\n## Docker Instance\r\n\r\nA more technical level is required for this type of use. You can use this Jupyter notebook to initialize UVR5 on virtual machines with GPU. This will install the entire UVR5 from the main branch of GitHub.\r\n\r\n### Requirements/Recommendations\r\n- Use the docker image `\u003e= ubuntu/ubuntu:20.04`\r\n- At least `20 GB of storage minimum.` (Add more space for your models/training)\r\n- Use Jupyter `\u003e= 7.3.1`\r\n- Configure port forwarding `9999 (UVR5-UI GUI)`\r\n- Install necessary drivers to use the GPU\r\n\r\nYou can get the notebook here: [Jupyter Notebook](https://github.com/Eddycrack864/UVR5-UI/blob/main/UVR_UI_Jupyter.ipynb) by iroaK\r\n\r\n\r\n## Contributions\r\nIf you want to participate and help me with this project feel free to create an [issue](https://github.com/Eddycrack864/UVR5-UI/issues) if something goes wrong or make a [pull request](https://github.com/Eddycrack864/UVR5-UI/pulls) to improve this project.\r\n\r\nAny type of contribution is welcome 💖\r\n\r\nIf you like this project you can star this repository. I will appreciate a lot 💖💖💖\r\n\r\nYou can donate to the original UVR5 project here:\r\n\r\n[![\"Buy Me A Coffee\"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/uvr5)\r\n\r\n## TO-DO\r\n* Add more models\r\n* Add more output formats\r\n\r\n## Credits\r\n* python-audio-separator by [beveradb](https://github.com/beveradb).\r\n* Special thanks to [Ilaria](https://github.com/TheStingerX) for hosting this space and help 💖\r\n* Thanks to [Mikus](https://github.com/cappuch) for the help with the code.\r\n* Thanks to [Nick088](https://github.com/Nick088Official) for the help to fix roformers.\r\n* Thanks to [yt_dlp](https://github.com/yt-dlp/yt-dlp) devs.\r\n* Separation by link source code and improvements by [NeoDev](https://github.com/TheNeodev).\r\n* Thanks to [ArisDev](https://github.com/aris-py) for porting UVR5 UI to Kaggle and improvements.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feddycrack864%2Fuvr5-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feddycrack864%2Fuvr5-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feddycrack864%2Fuvr5-ui/lists"}