Skip to content
watsonboxPublic

About

Export/Backup Spotify playlists using the Web API

Topics

Resources

Stars

4.3k stars

Watchers

50 watching

Forks

Repository files navigation

Build Status

Export your Spotify playlists to CSV by clicking on this link: https://exportify.app/.

As many users have noted, there is no way to export/archive/backup playlists from the Spotify client for safekeeping. This application provides a simple interface for doing that using the Spotify Web API.

No data will be saved - the entire application runs in the browser.

Features

  • ⚙️ Optional inclusion of album, artist and audio features data in export files
  • 🔍 Playlist search with advanced search syntax and results export
  • 🌓 Dark mode
  • 🗺 Available in 10 languages (English, French, Spanish, Italian, German, Portuguese, Swedish, Dutch, Japanese and Arabic)
  • 📱 Mobile friendly
  • ℹ Quick reference help
  • 🚀 Advanced rate limiting handling for speedy exports
  • 👩‍💻 Modern React-based development stack + test suite

Usage

  1. Fire up the app
  2. Click 'Get Started'
  3. Grant Exportify read-only access to your playlists
  4. Click the 'Export' button to export a playlist

Click 'Export All' to save a zip file containing a CSV file for each playlist in your account. This may take a while when many playlists exist and/or they are large.

Re-importing Playlists

Once playlists are saved, it's also pretty straightforward to re-import them into Spotify. Open up the CSV file in Excel, for example, select and copy the spotify:track:xxx URIs, then simply create a playlist in Spotify and paste them in. This has only been tested with the desktop app.

Export Format

Track data is exported in UTF-8 encoded CSV format with the following fields from the Spotify track object:

  • Track URI
  • Track Name
  • Artist URI(s)
  • Artist Name(s)
  • Album URI
  • Album Name
  • Album Artist URI(s)
  • Album Artist Name(s)
  • Album Release Date
  • Album Image URL (typically 640x640px jpeg)
  • Disc Number
  • Track Number
  • Track Duration (ms)
  • Track Preview URL (mp3)
  • Explicit?
  • Popularity
  • ISRC (International Standard Recording Code)
  • Added By
  • Added At

By clicking on the cog, additional data can be exported.

By selecting "Include artists data", the following fields will be added from the Spotify artist object:

  • Artist Genres

And by selecting "Include audio features data", the following fields will be added from the Spotify audio features object:

  • Danceability
  • Energy
  • Key
  • Loudness
  • Mode
  • Speechiness
  • Acousticness
  • Instrumentalness
  • Liveness
  • Valence
  • Tempo
  • Time Signature

Additionally, by selecting "Include album data", the following fields will be added from the Spotify album object (full)

  • Album Genres
  • Label
  • Copyrights

Note that the more data being exported, the longer the export will take.

Playlist Search

If you're searching for a specific playlist to export, you can use the search facility to find it quickly by name:

  • Searching is case-insensitive.
  • Search results can be exported as a zip file by clicking "Export Results"

Warning

Please be aware that if you have a very large number of playlists, there may be a small delay before the first search results appear since the Spotify API itself doesn't allow for searching directly, so all playlists must be retrieved first.

Advanced Search Syntax

Certain search queries have special meaning:

Search query Meaning
public:true Only show public playlists
public:false Only show private playlists
collaborative:true Only show collaborative playlists
collaborative:false Don't show collaborative playlists
owner:me Only show playlists I own
owner:[owner] Only show playlists owned by [owner]

Development

In the project directory, first run pnpm install to set up dependencies, then you can run:

pnpm start

Runs the app with the Vite development server.
Open http://127.0.0.1:3000 to view it in the browser. The page updates as you make edits.

pnpm test

Launches Vitest in watch mode. Use pnpm test --run to run the suite once.

pnpm build

Typechecks and builds the app for production to the dist folder. pnpm preview serves that build locally.

Stack

In addition to Vite and Vitest, the application is built using the following tools/libraries:

History

  • 2015: Exportify is born
  • 2020: Major release including search, artist and audio features, liked songs export, and a new rate limiting system
  • 2024: Major release including dark mode, internationalization, and search enhancements

Notes

  • According to Spotify's documentation:

    Folders are not returned through the Web API at the moment, nor can be created using it".

    Unfortunately that's just how it is.

  • I've gone to some lengths to try to eliminate errors resulting from excessively high usage of the Spotify API. Nonetheless, exporting data in bulk is a fairly request-intensive process, so please do try to use this tool responsibly. If you do require more throughput, please consider creating your own Spotify application which you can use with Exportify directly.

  • Disclaimer: It should be clear, but this project is not affiliated with Spotify in any way. It's just an app using their API like any other, with a cheeky name and logo 😇.

  • In case you don't see the playlists you were expecting to see and realize you've accidentally deleted them, it's actually possible to recover them.

Error Monitoring

Error monitoring provided by Bugsnag.

Running With Docker

The Docker image builds the production bundle and serves it with nginx on port 80. To build and run it:

docker build . -t exportify

docker run --rm -p 3000:80 exportify

And then open http://127.0.0.1:3000 to view it in the browser. Spotify only accepts logins redirected back to a registered address, so keep the host port at 3000 and use 127.0.0.1 rather than localhost. To serve it anywhere else, register that address as a redirect URI on your own Spotify application and open Exportify with ?app_client_id=<your client ID>.

Contributing

  1. Fork it ( https://github.com/watsonbox/exportify/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

About

Export/Backup Spotify playlists using the Web API

Topics

Resources

Stars

4.3k stars

Watchers

50 watching

Forks

Releases

Packages

Used by

Contributors

Languages