Metadata-Version: 2.1
Name: sfotipy
Version: 1.0.0
Summary: Spotify Music Downloader - Download music from Spotify
Author: Ren
Project-URL: Homepage, https://github.com/Minu181/Sfotipy
Project-URL: Repository, https://github.com/Minu181/Sfotipy
Project-URL: Issues, https://github.com/Minu181/Sfotipy/issues
Keywords: spotify,music,downloader,mp3,yt-dlp
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: spotifyscraper>=3.9.0
Requires-Dist: rich>=13.0.0
Requires-Dist: yt-dlp>=2024.1.0
Requires-Dist: mutagen>=1.47.0
Requires-Dist: syncedlyrics>=1.0.0

# sfotipy

Spotify Music Downloader - Download music from Spotify playlists, albums, and tracks as MP3 with metadata, cover art, and watermark.

**made by Ren - Discord: wtf_renn**

## Installation

```bash
pip install sfotipy
```

### Requirements

- Python 3.8+
- [FFmpeg](https://ffmpeg.org/download.html) installed and in your PATH

## Usage

### Interactive Mode

```bash
sfotipy
```

Opens a menu to configure settings and download music.

### Direct Mode

```bash
sfotipy https://open.spotify.com/track/4iV5W9uYEdYUVa79Axb7Rh
sfotipy https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M
sfotipy https://open.spotify.com/album/1DFixLWuPmc35TjJb6Wqeq
```

### Options

| Flag | Description |
|------|-------------|
| `-p`, `--path` | Download path |
| `-q`, `--quality` | Audio quality: 128, 192, 256, 320 kbps |
| `-s`, `--source` | Audio source: soundcloud, youtube-music, audius, beatbump |
| `-l`, `--lyrics` | Download lyrics |
| `-v`, `--version` | Show version |

## Features

- Download tracks, playlists, and albums from Spotify
- Automatic metadata (title, artist, album, cover art)
- `[Sfotipy]` watermark in filename
- Multiple audio sources with fallback
- Real-time progress display
- ESC to pause with continue/exit option
- Lyrics download support

## License

MIT
