Metadata-Version: 2.4
Name: grabr
Version: 0.1.0
Summary: Download music from YouTube Music and Spotify via CLI
Author-email: Chidananda Reddy <chidanandareddyjonnala.nambur@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/Chidanandareddyj/grabr
Project-URL: Issues, https://github.com/Chidanandareddyj/grabr/issues
Keywords: music,downloader,spotify,youtube,cli,mp3
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: yt-dlp>=2024.1.0
Requires-Dist: spotdl>=4.0.0
Requires-Dist: mutagen>=1.47.0
Requires-Dist: rich>=13.0.0
Requires-Dist: click>=8.1.0
Requires-Dist: requests>=2.31.0
Dynamic: license-file

# grabr

Download music from YouTube Music and Spotify via CLI.

## Prerequisites

- Python 3.10+
- ffmpeg

```bash
# Windows
winget install ffmpeg

# macOS
brew install ffmpeg

# Linux (Debian/Ubuntu)
sudo apt install ffmpeg
```

## Installation

```bash
pip install grabr
```

## Usage

```bash
grabr <url>                        # download track/playlist/album
grabr <url> --format flac          # choose format (mp3/flac/opus)
grabr <url> --output ~/Downloads   # custom output directory
grabr search "query"               # search and pick interactively
grabr search "query" --source spotify
grabr search "query" --limit 8
```

## Spotify Search Setup

Only needed for `--source spotify`.

- Get free credentials at developer.spotify.com
- Set environment variables:

```bash
SPOTIFY_CLIENT_ID=your_id
SPOTIFY_CLIENT_SECRET=your_secret
```

## Output

Files are saved to `~/Music/grabr/` by default.

## License

MIT
