sfotipy 1.0.0__tar.gz

sfotipy-1.0.0/PKG-INFO

@@ -0,0 +1,78 @@
+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

sfotipy-1.0.0/README.md

@@ -0,0 +1,58 @@
+# 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

sfotipy-1.0.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=64,<75", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sfotipy"
+version = "1.0.0"
+description = "Spotify Music Downloader - Download music from Spotify"
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [
+    { name = "Ren" },
+]
+keywords = ["spotify", "music", "downloader", "mp3", "yt-dlp"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Topic :: Multimedia :: Sound/Audio",
+]
+dependencies = [
+    "spotifyscraper>=3.9.0",
+    "rich>=13.0.0",
+    "yt-dlp>=2024.1.0",
+    "mutagen>=1.47.0",
+    "syncedlyrics>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Minu181/Sfotipy"
+Repository = "https://github.com/Minu181/Sfotipy"
+Issues = "https://github.com/Minu181/Sfotipy/issues"
+
+[project.scripts]
+sfotipy = "sfotipy.cli:main"
+
+[tool.setuptools]
+license-files = []

sfotipy-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sfotipy-1.0.0/sfotipy/__init__.py

@@ -0,0 +1,4 @@
+"""sfotipy - Spotify Music Downloader"""
+
+__version__ = "1.0.0"
+__author__ = "sfotipy"

sfotipy-1.0.0/sfotipy/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running as python -m sfotipy"""
+
+from sfotipy.cli import main
+
+if __name__ == "__main__":
+    main()

sfotipy-1.0.0/sfotipy/cli.py

@@ -0,0 +1,335 @@
+import sys
+import argparse
+from pathlib import Path
+
+from sfotipy import __version__
+from sfotipy.config import load_config, save_config, ensure_download_dir
+from sfotipy.downloader import parse_url, get_track_metadata, get_playlist_name, download_all
+from sfotipy.source import get_source_name, SOURCE_OPTIONS
+from sfotipy.utils import (
+    console,
+    show_banner,
+    show_error,
+    show_warning,
+    show_success,
+    show_info,
+    ask_url,
+    ask_download_path,
+    ask_quality,
+    show_tracks,
+    ask_download_action,
+    ask_track_selection,
+    ask_continue_or_exit,
+    show_summary,
+    confirm_continue,
+    show_source_table,
+    DownloadProgress,
+)
+
+
+def interactive_mode():
+    show_banner()
+
+    config = load_config()
+    current_path = config["download_path"]
+    current_quality = config["quality"]
+    current_source = config["source"]
+    current_lyrics = config.get("download_lyrics", False)
+
+    while True:
+        console.print()
+        console.print("[bold cyan]═══ Settings ═══[/bold cyan]")
+        console.print(f"  Download path: [green]{current_path}[/green]")
+        console.print(f"  Quality:       [green]{current_quality}kbps[/green]")
+        console.print(f"  Source:        [green]{get_source_name(current_source)}[/green]")
+        console.print(f"  Lyrics:        [green]{'ON' if current_lyrics else 'OFF'}[/green]")
+        console.print()
+
+        console.print("[bold cyan]═══ Options ═══[/bold cyan]")
+        console.print("  1. Change settings")
+        console.print("  2. Download music")
+        console.print("  3. Exit")
+        console.print()
+
+        choice = input("Select option (1-3): ").strip()
+
+        if choice == "1":
+            current_path, current_quality, current_source, current_lyrics = change_settings(
+                current_path, current_quality, current_source, current_lyrics
+            )
+        elif choice == "2":
+            download_flow(current_path, current_quality, current_source, current_lyrics)
+        elif choice == "3":
+            console.print("\n[bold cyan]Goodbye![/bold cyan]\n")
+            break
+        else:
+            show_warning("Invalid option. Please try again.")
+
+
+def change_settings(path: str, quality: int, source: str, lyrics: bool) -> tuple:
+    console.print()
+    console.print("[bold cyan]═══ Change Settings ═══[/bold cyan]")
+    console.print("  1. Change download path")
+    console.print("  2. Change quality")
+    console.print("  3. Change audio source")
+    console.print("  4. Toggle lyrics download")
+    console.print("  5. Back to main menu")
+    console.print()
+
+    choice = input("Select option (1-5): ").strip()
+
+    if choice == "1":
+        path = ask_download_path(path)
+        show_success(f"Download path set to: {path}")
+    elif choice == "2":
+        quality = ask_quality(quality)
+        show_success(f"Quality set to: {quality}kbps")
+    elif choice == "3":
+        source = ask_source(source)
+        show_success(f"Source set to: {get_source_name(source)}")
+    elif choice == "4":
+        lyrics = not lyrics
+        show_success(f"Lyrics download: {'ON' if lyrics else 'OFF'}")
+    elif choice == "5":
+        return path, quality, source, lyrics
+    else:
+        show_warning("Invalid option.")
+
+    save_config({
+        "download_path": path,
+        "quality": quality,
+        "source": source,
+        "output_format": "mp3",
+        "download_lyrics": lyrics,
+    })
+
+    return path, quality, source, lyrics
+
+
+def ask_source(current: str) -> str:
+    from rich.prompt import Prompt
+
+    console.print()
+    source_map = show_source_table(current)
+
+    reverse_map = {v: k for k, v in source_map.items()}
+    default = reverse_map.get(current, "1")
+    choices = list(source_map.keys())
+
+    choice = Prompt.ask(
+        "[bold cyan]Select source[/bold cyan]",
+        choices=choices,
+        default=default,
+    )
+
+    return source_map[choice]
+
+
+def download_flow(path: str, quality: int, source: str, lyrics: bool):
+    console.print()
+    url = ask_url()
+
+    if not url:
+        show_warning("No URL provided.")
+        return
+
+    url_info = parse_url(url)
+
+    if url_info["type"] == "unknown":
+        show_error("Invalid Spotify URL. Please provide a valid track, playlist, or album URL.")
+        return
+
+    console.print(f"[dim]Detected: {url_info['type'].capitalize()}[/dim]")
+
+    tracks, track_dicts = get_track_metadata(url)
+
+    if not track_dicts:
+        show_error("No tracks found. Please check the URL and try again.")
+        return
+
+    show_tracks(track_dicts)
+
+    if url_info["type"] in ("playlist", "album"):
+        folder_name = get_playlist_name(url)
+    else:
+        folder_name = sanitize_folder_name(f"{track_dicts[0]['artist']} - {track_dicts[0]['title']}")
+
+    output_dir = ensure_download_dir(folder_name)
+    show_info(f"Download folder: {output_dir}")
+
+    action = ask_download_action()
+
+    if action == "1":
+        selected_tracks = tracks
+        selected_count = len(tracks)
+    elif action == "2":
+        selected_indices = ask_track_selection(len(track_dicts))
+        if not selected_indices:
+            show_warning("No tracks selected.")
+            return
+        selected_tracks = [tracks[i - 1] for i in selected_indices]
+        selected_count = len(selected_tracks)
+        show_info(f"Selected {selected_count} track(s)")
+    else:
+        console.print("[dim]Cancelled.[/dim]")
+        return
+
+    console.print()
+    show_info(f"Starting download: {selected_count} track(s) to {output_dir}")
+    show_info(f"Quality: {quality}kbps | Source: {get_source_name(source)}")
+    if lyrics:
+        show_info("Lyrics: ON")
+    console.print()
+
+    if not confirm_continue("Start downloading?"):
+        console.print("[dim]Cancelled.[/dim]")
+        return
+
+    progress = DownloadProgress()
+    progress.start(len(selected_tracks))
+
+    downloaded, skipped, failed, errors = download_all(
+        selected_tracks, output_dir, quality, source, progress
+    )
+
+    if progress.force_stop:
+        progress.stop()
+        remaining = len(selected_tracks) - downloaded - failed - skipped
+        if not ask_continue_or_exit(downloaded, failed, skipped, remaining):
+            show_summary(downloaded, skipped, failed, errors)
+            return
+        else:
+            remaining_tracks = selected_tracks[downloaded + failed + skipped:]
+            if remaining_tracks:
+                progress = DownloadProgress()
+                progress.start(len(remaining_tracks))
+                d, s, f, e = download_all(
+                    remaining_tracks, output_dir, quality, source, progress
+                )
+                downloaded += d
+                skipped += s
+                failed += f
+                errors.extend(e)
+    else:
+        progress.stop()
+
+    show_summary(downloaded, skipped, failed, errors)
+
+
+def direct_mode(url: str, path: str = None, quality: int = None, source: str = None):
+    show_banner()
+
+    config = load_config()
+    path = path or config["download_path"]
+    quality = quality or config["quality"]
+    source = source or config["source"]
+
+    console.print(f"[dim]Using: {path} | {quality}kbps | {get_source_name(source)}[/dim]")
+
+    url_info = parse_url(url)
+
+    if url_info["type"] == "unknown":
+        show_error("Invalid Spotify URL.")
+        return
+
+    tracks, track_dicts = get_track_metadata(url)
+
+    if not track_dicts:
+        show_error("No tracks found.")
+        return
+
+    show_tracks(track_dicts)
+
+    if url_info["type"] in ("playlist", "album"):
+        folder_name = get_playlist_name(url)
+    else:
+        folder_name = sanitize_folder_name(f"{track_dicts[0]['artist']} - {track_dicts[0]['title']}")
+
+    output_dir = ensure_download_dir(folder_name)
+
+    if len(tracks) > 1:
+        if not confirm_continue("Download all tracks?"):
+            return
+    progress = DownloadProgress()
+    progress.start(len(tracks))
+    downloaded, skipped, failed, errors = download_all(
+        tracks, output_dir, quality, source, progress
+    )
+
+    if progress.force_stop:
+        progress.stop()
+        remaining = len(tracks) - downloaded - failed - skipped
+        if not ask_continue_or_exit(downloaded, failed, skipped, remaining):
+            show_summary(downloaded, skipped, failed, errors)
+            return
+        else:
+            remaining_tracks = tracks[downloaded + failed + skipped:]
+            if remaining_tracks:
+                progress = DownloadProgress()
+                progress.start(len(remaining_tracks))
+                d, s, f, e = download_all(
+                    remaining_tracks, output_dir, quality, source, progress
+                )
+                downloaded += d
+                skipped += s
+                failed += f
+                errors.extend(e)
+    else:
+        progress.stop()
+
+    show_summary(downloaded, skipped, failed, errors)
+
+
+def sanitize_folder_name(name: str) -> str:
+    invalid_chars = '<>:"/\\|?*'
+    for char in invalid_chars:
+        name = name.replace(char, "")
+    return name.strip()[:100] or "Spotify_Download"
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="sfotipy",
+        description="Spotify Music Downloader - Download music from Spotify",
+    )
+    parser.add_argument(
+        "url",
+        nargs="?",
+        help="Spotify URL (track, playlist, or album)",
+    )
+    parser.add_argument(
+        "--path", "-p",
+        help="Download path",
+    )
+    parser.add_argument(
+        "--quality", "-q",
+        type=int,
+        choices=[128, 192, 256, 320],
+        help="Audio quality in kbps",
+    )
+    parser.add_argument(
+        "--source", "-s",
+        choices=SOURCE_OPTIONS + ["auto"],
+        help="Audio source",
+    )
+    parser.add_argument(
+        "--lyrics", "-l",
+        action="store_true",
+        help="Download lyrics",
+    )
+    parser.add_argument(
+        "--version", "-v",
+        action="version",
+        version=f"sfotipy {__version__}",
+    )
+
+    args = parser.parse_args()
+
+    if args.url:
+        direct_mode(args.url, args.path, args.quality, args.source)
+    else:
+        interactive_mode()
+
+
+if __name__ == "__main__":
+    main()

sfotipy-1.0.0/sfotipy/config.py

@@ -0,0 +1,69 @@
+import json
+from pathlib import Path
+
+CONFIG_DIR = Path.home() / ".sfotipy"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+DEFAULT_CONFIG = {
+    "download_path": str(Path.home() / "Music" / "sfotipy"),
+    "quality": 320,
+    "source": "auto",
+    "output_format": "mp3",
+    "download_lyrics": False,
+}
+
+
+def get_config_dir() -> Path:
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    return CONFIG_DIR
+
+
+def load_config() -> dict:
+    get_config_dir()
+    if CONFIG_FILE.exists():
+        try:
+            with open(CONFIG_FILE, "r", encoding="utf-8") as f:
+                saved = json.load(f)
+            config = {**DEFAULT_CONFIG, **saved}
+            return config
+        except (json.JSONDecodeError, IOError):
+            pass
+    return DEFAULT_CONFIG.copy()
+
+
+def save_config(config: dict) -> None:
+    get_config_dir()
+    with open(CONFIG_FILE, "w", encoding="utf-8") as f:
+        json.dump(config, f, indent=4)
+
+
+def update_config(key: str, value) -> None:
+    config = load_config()
+    config[key] = value
+    save_config(config)
+
+
+def get_download_path() -> Path:
+    config = load_config()
+    path = Path(config["download_path"])
+    path.mkdir(parents=True, exist_ok=True)
+    return path
+
+
+def get_quality() -> int:
+    return load_config().get("quality", 320)
+
+
+def get_source() -> str:
+    return load_config().get("source", "auto")
+
+
+def get_lyrics_setting() -> bool:
+    return load_config().get("download_lyrics", False)
+
+
+def ensure_download_dir(name: str) -> Path:
+    base = get_download_path()
+    folder = base / name
+    folder.mkdir(parents=True, exist_ok=True)
+    return folder