Metadata-Version: 2.4
Name: fm-dlp
Version: 3.9.9.1
Summary: CLI tool for searching YouTube/YTMusic and downloading audio/video from 1000+ platforms
Project-URL: Homepage, https://github.com/Fkernel653/fm-dlp
Project-URL: Repository, https://github.com/Fkernel653/fm-dlp.git
Project-URL: Documentation, https://github.com/Fkernel653/fm-dlp#readme
Author: Fkernel653
License-Expression: MIT
License-File: LICENSE
Keywords: audio,cli,downloader,video,youtube,youtube-music,yt-dlp,ytmusic
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
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
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: arg-kiss
Requires-Dist: mutagen
Requires-Dist: platformdirs
Requires-Dist: yt-dlp
Requires-Dist: ytmusicapi
Provides-Extra: dev
Requires-Dist: ruff; extra == 'dev'
Description-Content-Type: text/markdown

# fm-dlp — Download from YouTube, YTMusic, and 1000+ sites

[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://python.org)
[![PyPI](https://img.shields.io/pypi/v/fm-dlp.svg)](https://pypi.org/project/fm-dlp/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-linux%20%7C%20macOS%20%7C%20windows-lightgrey)]()
[![Ruff](https://img.shields.io/badge/code%20style-ruff-261230?logo=ruff&logoColor=white)](https://docs.astral.sh/ruff/)

CLI tool for searching YouTube/YTMusic and downloading audio/video from 1000+ platforms

## 🚀 Quick Start
```bash
pip install fm-dlp                    # Python 3.10+ & FFmpeg required
fm-dlp config ~/Music                 # Set download directory
fm-dlp search "artist"                # Search tracks
fm-dlp download "URL" --codec flac    # Download audio
```

## 📋 Commands

### `search`
```bash
fm-dlp search <query> [--limit 10] [--yt-video] [--album] [--raw]
```
`--yt-video` (YouTube vs YTMusic), `--album`, `--limit N`, `--raw` (JSON output)

### `download`
```bash
fm-dlp download <urls> [--codec CODEC] [--kbps 256] [--jobs 5]
```
**URLs:** Single, multiple (space/comma), or file (one per line, `#` comments)

| Option | Description |
|--------|-------------|
| `--codec` | Audio: `mp3,aac,flac,m4a,opus,vorbis,wav` Video: `mp4,mkv,webm,mov,avi,flv` |
| `--kbps` | Bitrate 64–320 (default: 256) |
| `--jobs` | Parallel downloads (default: 5) |
| `--quiet` | Suppress yt-dlp output |
| `--no-metadata` | Skip metadata tagging |
| `--path` | Override download directory |
| `--cookies` | Browser (`chrome,firefox`) or cookies file |

## 📄 License & Acknowledgments

MIT License — Built with:

| Library | Purpose |
|---------|---------|
| [yt-dlp](https://github.com/yt-dlp/yt-dlp) | Download engine |
| [ytmusicapi](https://github.com/sigma67/ytmusicapi) | YouTube Music API |
| [mutagen](https://github.com/quodlibet/mutagen) | Metadata tagging |
| [platformdirs](https://github.com/platformdirs/platformdirs) | Config paths |
| [arg-kiss](https://github.com/Fkernel653/arg-kiss) | CLI framework |

**Author:** [Fkernel653](https://github.com/Fkernel653)
**Project:** [GitHub](https://github.com/Fkernel653/fm-dlp) • [PyPI](https://pypi.org/project/fm-dlp/)
