# RustifyDL

<div align="center">

[![Crates.io](https://img.shields.io/crates/v/rustifydl.svg)](https://crates.io/crates/rustifydl)
[![Documentation](https://docs.rs/rustifydl/badge.svg)](https://docs.rs/rustifydl)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

<img src="logo.svg" alt="RustifyDL Logo" width="200"/>

**A fast, no-fuss Spotify downloader built in Rust.**

</div>

## Why RustifyDL?
Turn any Spotify track/album/playlist URL into properly tagged audio files. RustifyDL pairs Spotify metadata with audio from YouTube, then writes tidy tags and artwork so your library looks right everywhere.

## Features
- ⚡ **Concurrent downloads** for maximum speed
- 🏷️ **Accurate tags**: artist, album, track/disc numbers, genre, year, cover art
- 🔇 **Clean, minimal logging** (tune with verbosity levels)
- 🧰 **FFmpeg-based conversion** (choose bitrate/format)
- 📚 **Library and CLI** - use as a Rust crate or standalone binary

## Demo

![RustifyDL Demo](./screenshots/rustifydl_demo.gif)

*RustifyDL in action: downloading a Spotify album*

## Installation

### From crates.io (Recommended)
```bash
cargo install rustifydl
```

### From source
Prerequisites:
- FFmpeg on PATH

```bash
git clone https://github.com/ThePangel/RustifyDL.git
cd RustifyDL
cargo install --path . --force
```

## Usage

### Command Line Interface
```bash
rustifydl "https://open.spotify.com/album/..." -v info --format mp3 --bitrate 192k --concurrent-downloads 8
```

**Common options** (see `rustifydl --help` for full list):
- `-o, --output-dir <PATH>`  Output folder (default: `./output`)
- `--concurrent-downloads <N>`  Parallel downloads (e.g., 6 or 10)
- `--bitrate <RATE>`  FFmpeg bitrate, e.g., `192k`, `256k`, `320k`
- `--format <EXT>`  Output format, e.g., `mp3`, `m4a`, `opus`, `flac`
- `-v, --verbosity <LEVEL>`  `none`, `info`, `debug`, `full`
- `--no-dupes`  Skip duplicate track names when collecting

### Library Usage
Add to your `Cargo.toml`:
```toml
[dependencies]
rustifydl = "0.1"
tokio = { version = "1", features = ["full"] }
```

Example usage:
```rust
use rustifydl::{download_spotify, DownloadOptions};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
    let opts = DownloadOptions {
        url: "https://open.spotify.com/album/xxxxxxxx".into(),
        client_id: "<your_spotify_client_id>".into(),
        client_secret: "<your_spotify_client_secret>".into(),
        output_dir: "./downloads".into(),
        concurrent_downloads: 6,
        no_dupes: true,
        bitrate: "192k".into(),
        format: "mp3".into(),
        verbosity: "info".into(),
        no_tag: false,
        timeout: 60,
    };
    
    download_spotify(opts).await?;
    Ok(())
}
```

## Configuration (Automatic)
RustifyDL manages Spotify API credentials automatically. On first use it creates a config file and reuses it next time—no need to pass credentials on the command line.

Config location examples:
- Windows: `%APPDATA%/RustifyDL/config.toml`
- Linux:   `~/.config/RustifyDL/config.toml`
- macOS:   `~/Library/Application Support/RustifyDL/config.toml`

To reset, delete the file and run again.


## Project Structure
```
src/
├── lib.rs         # Library API & orchestration
├── metadata.rs    # Tag writing (lofty)
├── spotify.rs     # Spotify fetch (spotify-rs)
└── youtube.rs     # YouTube download (rustypipe + ffmpeg)
```

## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.

## Status
🚧 Active development

## License
This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.

## Support
If you encounter issues or have questions, please [open an issue](https://github.com/ThePangel/RustifyDL/issues).

---
Built with Rust 🦀 and 💖 by thepangel ^_____^