exportify-cli

Export Spotify playlists to CSV or JSON directly from the terminal, inspired by pavelkomarov/exportify.

This tool can export all saved playlists, including liked songs.

Installation:

If you use Windows, you can download the binary and skip steps 1 and 2. It's recommended to place it in a dedicated folder for better organization.

1. Clone this repository:

git clone https://github.com/donmerendolo/exportify-cli.git

2. Install the required packages: (recommended to use a virtual environment)

cd exportify-cli
pip install -r requirements.txt

3. Set up Client ID, Client Secret and Redirect URI:

The first time you run exportify-cli, it will guide you through the setup:

File "config.cfg" not found or invalid. Let's create it.

1. Go to Spotify Developer Dashboard (https://developer.spotify.com/dashboard).
2. Create a new app.
3. Set a name and description for your app.
4. Add a redirect URI (e.g. http://127.0.0.1:3000/callback).

Now after creating the app, press the Settings button on the upper right corner.
Copy the Client ID, Client Secret and Redirect URI and paste them below.

After running python exportify-cli.py (or exportify-cli.exe if you use the Windows binary) the first time, it should keep you authenticated so you don't have to log in each time.

If you wish to log out, simply remove the .cache file (you may also have to remove access to exportify-cli in https://www.spotify.com/us/account/apps/).

---

Usage:

Usage: exportify-cli.py (-a | -p NAME|ID|URL|URI [-p ...] | -l) [OPTIONS]

  Export Spotify playlists to CSV or JSON.

Options:
    -a, --all                     Export all playlists
    -p, --playlist NAME|ID|URL|URI
                                  Spotify playlist name, ID, URL, or URI;
                                  repeatable.
    -l, --list                    List available playlists.
    -c, --config PATH             Path to configuration file (if omitted, uses
                                  ./config.cfg next to this script).
    -o, --output PATH             Directory to save exported files (if
                                  omitted, uses ./playlists).
    -f, --format [csv|json]       Output file format (if omitted, defaults to
                                  'csv').
    --uris                        Include album and artist URIs.
    --external-ids                Include track ISRC and album UPC.
    --no-bar                      Hide progress bar.
  -h, --help                      Show this message and exit.
  -v, --version                   Show the version and exit.

• Default values can be changed in config.cfg.

• Playlist names support partial matching, provided they uniquely identify a single playlist.

• You can also export a playlist that's not saved in your library by using its ID, URL, or URI.

• A single command can export multiple playlists by using the -p option multiple times.

• The default fields are: Track URI, Track Name, Album Name, Artist Name(s), Release Date, Duration_ms, Popularity, Added By, Added At, Record Label. With flags, Album URI(s), Artist URI(s), Track ISRC and Album UPC can be included too. If you want any other field to be added, feel free to open an issue or PR.

Examples:

# List all saved playlists
python exportify-cli.py --list

# Export all saved playlists, including liked songs with Artist and Album URIs
exportify-cli.exe --all --uris

# Export playlist whose name is "COCHE" to JSON
python exportify-cli.py -p COCHE -f json

# Export playlist whose ID is "2VqAIceMCzBRhzq6zVmDZw" to current directory
exportify-cli.exe -p 2VqAIceMCzBRhzq6zVmDZw --output .

# Export playlist with its URL
exportify-cli.exe -p https://open.spotify.com/playlist/2VqAIceMCzBRhzq6zVmDZw?si=16df8ae16c2d492b

# Export playlists "Instrumental" and "COCHE" to CSV without progress bar
python exportify-cli.py -p instr -p COCHE -f csv --no-bar

---

Building:

I used PyInstaller to build the windows binary with this command:

pyinstaller --onefile .\exportify-cli.py