RVC-Models-Downloader/README.md

# RVC-Models-Downloader
Quickly download RVC models in 🤗 Hugging Face.

## Quick Start
### Preparation
Put this program into the root directory of RVC. You can download it at [Release](https://github.com/RVC-Project/RVC-Models-Downloader/releases) page.
### Download
#### All Assets
```bash
rvcmd assets/all
```
#### Latest General Pack (Windows Only)
```bash
rvcmd packs/general/latest
```
#### ffmpeg Tools (Windows Only)
```bash
rvcmd tools/ffmpeg
```
### Customized Download
#### Ex.1. Download ffmpeg Tools & Latest Intel Pack
1. Write and save the following `cust.yaml`.
    ```yaml
    BaseURL: https://huggingface.co/lj1995/VoiceConversionWebUI/resolve/main
    Targets:
      - Refer: tools/ffmpeg
      - Refer: packs/intel/latest
    ```
2. Run `rvcmd` in the same folder.
    ```bash
    rvcmd -c cust
    ```
#### Ex.2. Download other Repositories
> Use [Stable Diffusion v1-5](https://huggingface.co/runwayml/stable-diffusion-v1-5) as the example.
1. Write and save the following `cust.yaml`.
    ```yaml
    BaseURL: https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main
    Targets:
      - Folder: sd1.5 # the folder you want to download into
        Copy: # files to download
          - v1-5-pruned-emaonly.ckpt
          - v1-5-pruned-emaonly.safetensors
          - vae/diffusion_pytorch_model.bin
    ```
2. Run `rvcmd` in the same folder.
    ```bash
    rvcmd -c cust
    ```
## Full Usage
```bash
Usage: rvcmd [-notrs] [-dns dns.yaml] 'target/to/download'
  -c    use custom yaml instruction
  -dns string
        custom dns.yaml
  -notrs
        use standard TLS client
  'target/to/download'
        like packs/general/latest
All available targets:
    assets:
        all    hubert    rmvpe    uvr5    v1    v2
    packs:
        amd:
            latest
            v2:
                20230813    20231006
        general:
            latest
            v1:
                20230331    20230416    20230428    20230508    20230513    20230516    20230717
            v2:
                20230528    20230618
        intel:
            latest
            v2:
                20230813    20231006
        nvidia:
            latest
            v2:
                20230813    20231006
    tools:
        ffmpeg
```