# Intro

spotify\_sync is a CLI app written in Python that allows 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 songs.

This is achieved by linking your Spotify account to a configuration and then running spotify\_sync either manually or on a schedule.

Directly downloading songs from Spotify is currently impossible. To work around this, song metadata is downloaded from Spotify which is then used to match it to a Deezer equivalent. Songs that are successfully matched are then queued for download via the [Deemix Api](https://deemix.app).

Currently, spotify\_sync features include:

* 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
* Runtime notification support via [Pushover](https://pushover.net)
* Automatic Plex library scanning via [Autoscan](https://github.com/Cloudbox/autoscan)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.spotify-sync.jbh.cloud/home/intro.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
