Skip to content

watsonbox/exportify

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 8 languages (English, French, Spanish, Italian, German, Portuguese, Swedish, and Dutch)
  • 📱 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

This project was bootstrapped with Create React App.

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

yarn start

Runs the app in the development mode.
Open http://localhost:3000 to view it in the browser.

The page will reload if you make edits.
You will also see any lint errors in the console.

yarn test

Launches the test runner in the interactive watch mode.
See the section about running tests for more information.

yarn build

Builds the app for production to the build folder.

Stack

In addition to Create React App, 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

To build and run Exportify with docker, run:

docker build . -t exportify

docker run -p 3000:3000 exportify

And then open http://localhost:3000 to view it in the browser.

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