sfotipy 1.5.0

Spotify Music Downloader - Download music from Spotify

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

pip install sfotipy

Requirements

• Python 3.9+
• FFmpeg installed and in your PATH

Usage

Interactive Mode

sfotipy

Opens a menu to configure settings and download music.

Direct Mode

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: 0 (auto), 128, 192, 256, 320 kbps
-s, --source	Audio source: auto, soundcloud, youtube-music, youtube
-l, --lyrics	Download lyrics
-o, --output-template	Filename template (e.g. "{track_number}. {artist} - {title}")
-w, --workers	Number of parallel download workers (1-8, default: 3)
--overwrite	Re-download existing tracks
--dry-run	Preview what would be downloaded without downloading
-V, --verbose	Enable verbose/debug output
-v, --version	Show version

Features

• Download tracks, playlists, albums, and episodes from Spotify
• Automatic metadata (title, artist, album, cover art)
• [Sfotipy] watermark in filename
• Multiple audio sources with fallback (YouTube Music → YouTube → SoundCloud)
• Parallel downloads with configurable worker count
• Real-time progress display with per-song progress bars
• ESC to pause with continue/exit option
• Lyrics download support (synced + plain)
• Resume interrupted downloads
• Low-quality track detection with per-track choices
• Automatic update checking from PyPI

License

MIT