Skip to main content

A schedulable, configurable CLI downloader for Spotify accounts

Project description

spotify_sync

Python Versions PyPi package Downloads License Documentation Code Style

Introduction

spotify_sync is a CLI app written in Python allowing you to download songs from your Spotify account. It is designed to be a 'set and forget' tool for users wanting to keep an offline copy of their library. Spotify songs are matched to a 1:1 Deezer equivalent via their ISRC and then queued for download.

Features:

  • Download of liked songs
  • Download of playlist songs
  • Up-to lossless quality downloads
  • Multi-threaded downloading
  • Scheduling (e.g. cron)
  • Multi-config support; configure and schedule multiple profiles with separate Spotify accounts
  • Backup and restore of config and persistent data
  • Notification support via Pushover
  • Automatic Plex library scanning via Autoscan

Requirements

  1. Python & pip >= 3.8
  2. Spotify account (Free)
  3. Deezer account (Free allows 128kbps downloads, up to lossless requires Deezer Hi-Fi account)

Install

python3 -m pip install -U spot_sync

Usage

Simple usage would be..

Cache Spotify OAuth token

spotify_sync utils authorize-spotify --profile myFirstProfile

Run in automatic mode

spotify_sync run auto --profile myFirstProfile

Documentation

Further configuration is required, details for which can be found at the docs.

Support

If you use or enjoy this project, please give it a :star: or

Buy Me A Coffee

Disclaimer

This tool was written for educational purposes. I will not be responsible if you use this program in bad faith. By using it, you are accepting the Deezer Terms of Use. spotify_sync is not affiliated with Deezer.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

spot_sync-1.1.1.tar.gz (28.7 kB view hashes)

Uploaded Source

Built Distribution

spot_sync-1.1.1-py3-none-any.whl (35.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page