Metadata-Version: 2.4
Name: extra-roformers
Version: 0.1.0
Summary: Extended audio-seprator with yt-dlp and Video support.
License: MIT
License-File: LICENSE
Keywords: audio-separation,vocal-extract,music-source-separation,yt-dlp,ffmpeg,deep-learning,music-remove
Author: mohammadmansour200
Author-email: mohammadamansour03@gmail.com
Requires-Python: >=3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: audio-separator[gpu] (>=0.30.0)
Requires-Dist: validators (>=0.35.0)
Requires-Dist: yt-dlp (>=2026.2.21)
Description-Content-Type: text/markdown

<div align="center">
  <a href="https://pypi.org/project/extra-roformers" target="_blank"><img src="https://img.shields.io/pypi/v/extra-roformers?label=PyPI%20Version&color=limegreen" /></a>
  <a href="https://pypi.org/project/extra-roformers" target="_blank"><img src="https://img.shields.io/pypi/pyversions/extra-roformers?color=limegreen" /></a>
  <a href="https://github.com/mohammadmansour200/extra-roformers/blob/main/LICENSE" target="_blank"><img src="https://img.shields.io/pypi/l/extra-roformers?color=limegreen" /></a>
  <a href="https://pepy.tech/project/extra-roformers" target="_blank"><img src="https://static.pepy.tech/badge/extra-roformers" /></a>
  <a href="https://baseet.netlify.app/ai" target="_blank"><img src="https://colab.research.google.com/assets/colab-badge.svg" /></a>
</div>

`extra-roformers`: Extended [audio-separator](https://github.com/nomadkaraoke/python-audio-separator/) with yt-dlp media downloading and Video
Music removal

## Features

- 🎧 **Vocal isolation** using Mel-Band RoFormer model
- 📥 **Media download** from URLs (e.g., YouTube) using `yt-dlp`
- 📁 Works with both **audio** and **video** files
- ✅ Local + remote (URL) input support

## Get started

*Make sure you have [ffmpeg](https://www.ffmpeg.org/download.html) installed.*

```bash
sudo apt install ffmpeg
```

Download package:
> Requires Python 3.10+

```bash
pip install extra-roformers
```

## Usage

```bash
from extra_roformers.separate import extra_separator

extra_separator(
    files=[
        "https://www.youtube.com/watch?v=123",
        "local_audio.mp3"
    ],
    download_format="audio",   # or "video"
    quality="medium",     # "low", "medium", "high"
    output_dir="outputs"
)

```

