savify 1.1.1

FFmpeg

Savify relies on the open source FFmpeg library in order to convert and write metadata to the songs it downloads. Please make sure FFmpeg is installed on your computer and added to the System PATH. Follow the tutorial here.

Download the latest release (coming soon)

Go here to download the latest Savify.exe then make sure you have FFmpeg downloaded and it added to your PATH as per the section above.

That’s it, you should be good to go! See some usage examples below.

Using the Python module

$ pip install -U savify

CLI COMING SOON

Download Defaults

Query Type:

track

Quality:

best

Format:

mp3

Path:

Windows: HOME/AppData/Roaming/Savify/downloads

Linux: HOME/.local/share/Savify/downloads

MacOS: HOME/Library/Application Support/Savify/downloads

Grouping:

no grouping

For more usage examples read the docs.

Spotify Application

To use the Savify Python module you will need your own Spotify developer application to access their API. To do this sign up here. When you have made a new application take note of your client id and secret. You can pass the id and secret to Savify in two ways:

s = Savify(api_credentials=("CLIENT_ID","CLIENT_SECRET"))

Use in your Python project

Install the package to your environment:

$ pip install savify

Import and use Savify:

from savify import Savify
from savify.types import Type, Format, Quality

with Savify() as s:
     # Spotify URL
     s.download("SPOTIFY URL")

     # Search Query
     # Types: TRACK, ALBUM, PLAYLIST
     s.download("QUERY", query_type=Type.TRACK)

Savify optional constructor arguments (se above for defaults):

from pathlib import Path

from savify import Savify
from savify.types import Type, Format, Quality

# Quality Options: WORST, Q32K, Q96K, Q128K, Q192K, Q256K, Q320K, BEST
# Format Options: MP3, AAC, FLAC, M4A, OPUS, VORBIS, WAV
Savify(api_credentials=None, quality=Quality.BEST, download_format=Format.MP3, output_path=Path('path/for/downloads'), group='%artist%/%album%')

The group argument is used to sort you downloaded songs inside the output path. Possible varibles for the path string are: %artist%, %album%, and %playlist%. The variables are replaced eith the songs metadata. For example a song downloaded with the above Savify object would save to a path like this: path/for/downloads/Example Artist/Example Album/Example Song.mp3

Tip

If you are developing Savify, install the pip package locally so you can make and test your changes. From the root directorty run:

$ pip install -e .

You can then run the Python module:

$ savify