Skip to content

README.md

Latest commit

 

History

History
114 lines (88 loc) · 2.6 KB

README.md

File metadata and controls

114 lines (88 loc) · 2.6 KB

SpotifyDl

Un'applicazione Python per scaricare playlist, album e brani da Spotify come file MP3.

Caratteristiche

  • Download Multi-thread: Scarica più brani contemporaneamente configurando il numero di thread
  • Qualità Personalizzabile: Configura la qualità audio desiderata
  • Supporto Metadati: Ogni file MP3 viene salvato con i metadati corretti (titolo, artista, album, ecc.)
  • Aggiornamento Playlist: Scarica automaticamente solo i nuovi brani aggiunti alle playlist

Requisiti

  • Credenziali API Spotify (Client ID e Client Secret) spotify.com
  • Connessione Internet
  • Python 3.8 o superiore
  • FFmpeg

Installazione

  1. Clona il repository:
git clone https://github.com/fdemusso/SpotifyDowloader.git
cd SpotifyDl
  1. Installa le dipendenze:
pip install -r requirements.txt
  1. Installa FFmpeg:

Windows:

macOS:

brew install ffmpeg

Linux:

sudo apt update
sudo apt install ffmpeg
  1. Esegui l'applicazione:
python -m src.main

Configurazione

Al primo avvio, l'applicazione ti chiederà di inserire:

  • SPOTIFY_CLIENT_ID
  • SPOTIFY_CLIENT_SECRET
  • MAX_THREADS (numero di download simultanei)
  • PREFERRED_QUALITY (qualità audio preferita)

Utilizzo

L'applicazione supporta i seguenti comandi:

  • download: Scarica una playlist, album o brano da Spotify
  • update <numero>: Aggiorna una playlist specifica o tutte le playlist
  • list: Mostra la lista delle playlist scaricate
  • addmeta: Aggiunge i metadati di un brano Spotify a un file audio
  • settings: Modifica le impostazioni dell'applicazione
  • help: Mostra la lista dei comandi disponibili
  • exit: Chiude l'applicazione

Docker

Per eseguire l'applicazione con Docker:

  1. Costruisci l'immagine:
docker build -t spotifydl .
  1. Esegui il container:
docker run -it spotifydl

Struttura del Progetto

SpotifyDl/
├── src/
│   ├── core/
│   │   ├── spotify.py
│   │   ├── downloader.py
│   │   └── metadata.py
│   ├── utils/
│   │   ├── config.py
│   │   └── logger.py
│   ├── commands/
│   │   └── commands.py
│   └── main.py
├── requirements.txt
├── Dockerfile
└── README.md

Note

  • L'applicazione utilizza YouTube per il download dei brani
  • I file vengono salvati in formato MP3
  • I metadati vengono estratti direttamente da Spotify
  • La cache di YouTube viene salvata nella cartella yt-cache