watsonbox / exportify

Export/Backup Spotify playlists using the Web API
https://exportify.app/
MIT License
3.17k stars 436 forks source link
playlists spotify spotify-api spotify-web-api

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

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:

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:

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

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

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:

[!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

Notes

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