KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

ultimatevocalremovergui

★ 25,782 Open GitHub ↗

Deep Neural Networks를 사용하는 보컬 제거 도구의 GUI입니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](https://img.shields.io/github/release/anjok07/ultimatevocalremovergui.svg)](https://github.com/anjok07/ultimatevocalremovergui/releases/latest)
[![Downloads](https://img.shields.io/github/downloads/anjok07/ultimatevocalremovergui/total.svg)](https://github.com/anjok07/ultimatevocalremovergui/releases)

## About

이 애플리케이션은 최첨단 소스 분리 모델을 사용하여 오디오 파일에서 보컬을 제거합니다. UVR의 핵심 개발자들은 이 패키지에 제공된 모든 모델을 직접 학습시켰습니다 (Demucs v3 및 v4 4-stem 모델 제외).

- **Core Developers**
    - [Anjok07](https://github.com/anjok07)
    - [aufr33](https://github.com/aufr33)

- **Support the Project**
    - [Donate](https://www.buymeacoffee.com/uvr5)

## Installation

이 번들에는 UVR 인터페이스, Python, PyTorch 및 애플리케이션을 효과적으로 실행하는 데 필요한 기타 종속 항목이 포함되어 있습니다. 별도의 사전 요구 사항은 필요하지 않습니다.

### Windows Installation

- 주의 사항:
    - 이 설치 프로그램은 Windows 10 이상 버전 사용자를 위한 것입니다.
    - Windows 7 이하 버전 시스템에서의 애플리케이션 기능은 보장되지 않습니다.
    - Intel Pentium 및 Celeron CPU 시스템에서의 애플리케이션 기능은 보장되지 않습니다.
    - UVR을 반드시 메인 C:\ 드라이브에 설치해야 합니다. 보조 드라이브에 설치할 경우 불안정해질 수 있습니다.

- 아래 링크를 통해 Windows용 UVR 설치 프로그램을 다운로드하세요:
    - [Main Download Link](https://github.com/Anjok07/ultimatevocalremovergui/releases/download/v5.6/UVR_v5.6.0_setup.exe)
    - [Main Download Link mirror](https://www.mediafire.com/file_premium/jiatpgp0ljou52p/UVR_v5.6.0_setup.exe/file)
- **AMD Radeon 또는 Intel Arc 그래픽 카드**를 사용하는 경우, DirectML 버전을 시도해 볼 수 있습니다:
    - [DirectML Version - Main Download Link](https://github.com/Anjok07/ultimatevocalremovergui/releases/download/v5.6/UVR_1_15_25_22_30_BETA_full.exe)
- UVR이 이미 설치된 분들을 위한 업데이트 패키지 안내:
    - 이미 UVR이 설치되어 있다면 이 패키지를 덮어씌워 설치하거나, 애플리케이션에서 직접 다운로드하거나 [여기에서 패치를 클릭](https://github.com/Anjok07/ultimatevocalremovergui/releases/download/v5.6/UVR_Patch_10_6_23_4_27.exe)하세요.

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

### Manual Windows Installation

- [여기](https://github.com/Anjok07/ultimatevocalremovergui/archive/refs/heads/master.zip)에서 리포지토리를 다운로드하고 압축을 푸세요.
- [여기](https://www.python.org/ftp/python/3.9.8/python-3.9.8-amd64.exe)에서 Python을 다운로드하고 설치하세요.
   - 설치 중에 "Add python.exe to PATH"를 반드시 체크하세요.
- 압축을 푼 리포지토리 디렉토리에서 다음 명령어를 실행하세요:

```
python.exe -m pip install -r requirements.txt
```

호환되는 Nvidia GPU가 있는 경우, 다음 명령어를 실행하세요:

```
python.exe -m pip install --upgrade torch --extra-index-url https://download.pytorch.org/whl/cu117
```

FFmpeg 또는 Rubber Band가 설치되어 있지 않고, 복잡한 설치 과정을 피하고 싶다면 다음 지침을 따르세요.

**FFmpeg Installation**

- 사전 컴파일된 빌드를 [여기](https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-essentials.zip)에서 다운로드하세요.
- 아카이브에서 다음 파일을 UVR 애플리케이션 디렉토리로 추출하세요:
   - ```ffmpeg-5.1.2-essentials_build/bin/ffmpeg.exe```

**Rubber Band Installation**

Time Stretch 또는 Change Pitch 도구를 사용하려면 Rubber Band가 필요합니다.

- 사전 컴파일된 빌드를 [여기](https://breakfastquay.com/files/releases/rubberband-3.1.2-gpl-executable-windows.zip)에서 다운로드하세요.
- 아카이브에서 다음 파일들을 UVR 애플리케이션 디렉토리로 추출하세요:
   - ```rubberband-3.1.2-gpl-executable-windows/rubberband.exe```
   - ```rubberband-3.1.2-gpl-executable-windows/sndfile.dll```

</details>

### MacOS Installation
- 주의 사항:
    - MacOS Sonoma의 마우스 클릭 문제가 해결되었습니다.
    - Mac M1을 위한 MPS (GPU) 가속이 Demucs v4 및 모든 MDX-Net 모델에서 작동하도록 확장되었습니다.
    - 이 번들은 macOS Big Sur 이상 버전 사용자를 위한 것입니다.
    - macOS Catalina 이하 버전 시스템에서의 애플리케이션 기능은 보장되지 않습니다.
    - 구형 또는 저사양 Mac 시스템에서의 애플리케이션 기능은 보장되지 않습니다.
    - 모든 설치가 완료된 후, 애플리케이션이 처음 실행될 때까지 최대 5~10분이 걸릴 수 있습니다 (Macbook 사양에 따라 다름).

- 아래 링크 중 하나를 통해 MacOS용 UVR dmg를 다운로드하세요:
    - Mac M1 (arm64) 사용자:
       - [Main Download Link](https://github.com/Anjok07/ultimatevocalremovergui/releases/download/v5.6/Ultimate_Vocal_Remover_v5_6_MacOS_arm64.dmg)
       - [Main Download Link mirror](https://www.mediafire.com/file_premium/u3rk54wsqadpy93/Ultimate_Vocal_Remover_v5_6_MacOS_arm64.dmg/file)

- Mac Intel (x86_64) 사용자:
       - [Main Download Link](https://github.com/Anjok07/ultimatevocalremovergui/releases/download/v5.6/Ultimate_Vocal_Remover_v5_6_MacOS_x86_64.dmg)
       - [Main Download Link mirror](https://www.mediafire.com/file_premium/2gf1werx5ly5ylz/Ultimate_Vocal_Remover_v5_6_MacOS_x86_64.dmg/file)

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

> Apple의 엄격한 애플리케이션 보안으로 인해, UVR을 열기 위해 다음 단계를 따라야 할 수도 있습니다.
>
> 먼저, 모든 소스에서 애플리케이션이 실행될 수 있도록 Terminal.app을 통해 다음 명령어를 실행하세요 (UVR이 정상적으로 열리면 다시 비활성화하는 것을 권장합니다).
> 
> ```bash
> sudo spctl --master-disable
> ```
> 
> 그 다음, 공증(Notarization)을 우회하기 위해 다음 명령어를 실행하세요: 
> 
> ```bash
> sudo xattr -rd com.apple.quarantine /Applications/Ultimate\ Vocal\ Remover.app
> ```

</details>

<details id="MacInstall">
  <summary>Manual MacOS Installation</summary>

### Manual MacOS Installation

- [여기](https://github.com/Anjok07/ultimatevocalremovergui/archive/refs/heads/master.zip)에서 이 리포지토리를 다운로드하여 저장하세요.
- [여기](https://www.python.org/ftp/python/3.10.9/python-3.10.9-macos11.pkg)에서 Python 3.10을 다운로드하고 설치하세요.
- 저장된 디렉토리에서 다음을 실행하세요 -

```
pip3 install -r requirements.txt
```

- Mac이 M1 모델인 경우, 다음 명령어를 이어서 실행하세요. 그렇지 않은 경우 이 단계를 건너뛰세요. -

```
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**

- 모든 설치가 완료되면, [여기](http://www.osxexperts.net)에서 시스템에 맞는 FFmpeg 바이너리를 다운로드하여 메인 애플리케이션 디렉토리에 배치하세요.

**Rubber Band Installation**

Time Stretch 또는 Change Pitch 도구를 사용하려면 Rubber Band가 필요합니다.

- 사전 컴파일된 빌드를 [여기](https://breakfastquay.com/files/releases/rubberband-3.1.2-gpl-executable-windows.zip)에서 다운로드하세요.
- 아카이브에서 다음 파일을 UVR/lib_v5 애플리케이션 디렉토리로 추출하세요:
   - ```rubberband-3.1.2-gpl-executable-macos/rubberband```

이 프로세스는 MacBook Pro 2021 (M1 사용) 및 MacBook Air 2017에서 테스트되었으며 두 기기 모두에서 작동하는 것이 확인되었습니다.

</details>

### Linux Installation (Updated Instructions)

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

<br />

**이 설치 지침은 Debian 및 Arch 기반 Linux 시스템을 위한 것입니다.**

---

#### **Step 1: Download the Repository**
- [GitHub](https://github.com/Anjok07/ultimatevocalremovergui/archive/refs/heads/master.zip)에서 이 리포지토리를 다운로드하여 저장하세요.
- 다운로드한 파일을 원하는 디렉토리에 압축 해제하세요.

---

#### **Step 2: Install Dependencies**
시스템 유형에 따라 다음 명령어를 사용하세요:

**Debian 기반 시스템 (Ubuntu, Mint 등):**
```bash
sudo apt update && sudo apt upgrade
sudo apt-get install -y ffmpeg python3-pip python3-tk
```

**Arch 기반 시스템 (EndeavourOS):**
```bash
sudo pacman -Syu
sudo pacman -S ffmpeg python-pip tk
```

---

#### **Step 3: Set Up a Virtual Environment (Recommended)**
가상 환경(venv)을 설정하면 프로그램의 종속 항목이 시스템 전체의 Python 패키지와 충돌하는 것을 방지할 수 있습니다.

1. **압축을 푼 리포지토리 디렉토리로 이동하세요:**
   ```bash
   cd /path/to/ultimatevocalremovergui
   ```

2. **가상 환경을 생성하세요:**
   ```bash
   python3 -m venv venv
   ```

3. **가상 환경을 활성화하세요:**
   - **Debian 기반 및 Arch 기반 시스템:**
     ```bash
     source venv/bin/activate
     ```

4. **가상 환경에 종속 항목을 설치하세요:**
   ```bash
   pip install -r requirements.txt
   ```

---

#### **Step 4: Run the Application**
가상 환경이 활성화된 상태에서 애플리케이션을 시작하세요:
```bash
python UVR.py
```

---

#### **Important Notes**
1. **시스템 파일 수정 금지:**  
   이전 지침에서는 `/usr/lib/python3.11/EXTERNALLY-MANAGED` 파일을 삭제하도록 안내했으나, 이는 위험하며 Python 패키지 관리를 망가뜨릴 수 있습니다. 이 파일을 **삭제하지 마십시오**.

2. **가상 환경을 사용하는 이유:**  
   가상 환경은 프로그램의 종속 항목을 격리하여 시스템 Python 패키지와의 충돌을 방지합니다. 더 자세한 정보는 [여기](https://stackoverflow.com/questions/75602063/pip-install-r-requirements-txt-is-failing-this-environment-is-externally-mana/75696359#75696359)에서 확인하실 수 있습니다.

3. **알려진 이슈 및 토론:**  
   - [Issue #1578](https://github.com/Anjok07/ultimatevocalremovergui/issues/1578)  
   - [Pull Request #1068](https://github.com/Anjok07/ultimatevocalremovergui/pull/1068)

---

문제가 발생하면 [GitHub Issues](https://github.com/Anjok07/ultimatevocalremovergui/issues) 페이지를 참조하여 도움을 받으세요.

</details>

### Other Application Notes
- GPU 변환을 위한 최소 요구 사양은 Nvidia GTX 1060 6GB입니다.
- 최소 8GB의 V-RAM을 갖춘 Nvidia GPU를 권장합니다.
- AMD Radeon GPU 지원은 현재 제한적입니다.
   - 현재 AMD GPU 사용자를 위한 작동 브랜치가 [여기](https://github.com/Anjok07/ultimatevocalremovergui/tree/v5.6-amd-gpu)에 있습니다.
- 이 애플리케이션은 64비트 플랫폼과만 호환됩니다. 
- 이 애플리케이션은 Time-Stretch 및 Pitch-Shift 옵션을 위해 Rubber Band 라이브러리에 의존합니다.
- 이 애플리케이션은 wav가 아닌 오디오 파일을 처리하기 위해 FFmpeg에 의존합니다.
- 애플리케이션을 종료할 때 설정이 자동으로 기억됩니다.
- 변환 시간은 사용자의 하드웨어에 따라 크게 달라집니다. 
- 이 모델들은 연산 집약적입니다.

### Performance:
- 모델 로드 시간이 빨라졌습니다.
- 오디오 파일의 가져오기/내보내기 속도가 빨라졌습니다.

## Troubleshooting

### Common Issues

- FFmpeg가 설치되어 있지 않은 경우, 사용자가 WAV 파일이 아닌 파일을 변환하려고 하면 애플리케이션에서 오류가 발생합니다.
- 메모리 할당 오류는 일반적으로 "Segment" 또는 "Window" 크기를 줄여 해결할 수 있습니다.

#### MacOS Sonoma Left-click Bug
MacOS Sonoma에서 앱 내의 왼쪽 클릭이 올바르게 인식되지 않는 알려진 문제가 있습니다. 이는 Sonoma에서 Tkinter로 빌드된 모든 애플리케이션에 영향을 미쳤으며, 현재 해결되었습니다. 여전히 문제가 발생한다면 다음 링크를 통해 최신 버전을 다운로드하세요 - [link](https://github.com/Anjok07/ultimatevocalremovergui/releases/tag/v5.6)

이 문제는 [여기](https://github.com/Anjok07/ultimatevocalremovergui/issues/840)에서 추적되었습니다.

### Issue Reporting

새로운 이슈를 게시할 때는 가능한 한 자세하게 작성해 주세요.

가능하다면 "Start Processing" 버튼 왼쪽에 있는 "Settings Button"을 클릭하고 "Error Log" 버튼을 클릭하여 저희에게 제공할 수 있는 상세한 오류 정보를 확인해 주세요.

## License

**Ultimate Vocal Remover GUI** 코드는 [MIT 라이선스](LICENSE)를 따릅니다.

- **주의 사항:** 저희 모델을 사용하고자 하는 모든 제3자 애플리케이션 개발자분들은 UVR과 개발자들에게 크레딧을 제공함으로써 MIT 라이선스를 준수해 주시기 바랍니다.

## Credits
- [ZFTurbo](https://github.com/ZFTurbo) - 새로운 MDX23C 모델의 가중치 생성 및 학습. 
- [DilanBoskan](https://github.com/DilanBoskan) - 프로젝트 초기 단계에서의 기여는 UVR의 성공에 필수적이었습니다. 감사합니다!
- [Bas Curtiz](https://www.youtube.com/user/bascurtiz) - 공식 UVR 로고, 아이콘, 배너 및 스플래시 화면 디자인.
- [tsurumeso](https://github.com/tsurumeso) - 오리지널 VR Architecture 코드 개발. 
- [Kuielab & Woosung Choi](https://github.com/kuielab) - 오리지널 MDX-Net AI 코드 개발. 
- [Adefossez & Demucs](https://github.com/facebookresearch/demucs) - 오리지널 Demucs AI 코드 개발. 
- [KimberleyJSN](https://github.com/KimberleyJensen) - MDX-Net 및 Demucs 학습 스크립트 구현 자문 및 지원. 감사합니다!
- [Hv](https://github.com/NaJeongMo/Colab-for-MDX_B) - MDX-Net AI 코드에 청크(chunks) 구현을 도움. 감사합니다!

## Contributing

- **Ultimate Vocal Remover GUI**의 지속적인 개발에 관심이 있는 분은 풀 리퀘스트(pull request)를 보내주시면 검토하겠습니다. 
- 이 프로젝트는 100% 오픈 소스이며 누구나 원하는 대로 사용하고 수정할 수 있습니다. 
- 저희는 **Ultimate Vocal Remover GUI**와 제공되는 모델들의 개발 및 지원만을 유지 관리합니다.

## References
- [1] Takahashi et al., "Multi-scale Multi-band DenseNets for Audio Source Separation", https://arxiv.org/pdf/1706.09588.pdf

ultimatevocalremovergui

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README