Repository files navigation

Export your Spotify playlists toCSV 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 theSpotify Web API.

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

• ⚙️ Optional inclusion of album, artist and audio features data in export files
• 🔍 Playlist search withadvanced 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
• 👩‍💻 ModernReact-based development stack + test suite

1. Fire upthe 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.

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 thespotify:track:xxx URIs, then simply create a playlist in Spotify and paste them in. This has only been tested with the desktop app.

Track data is exported inUTF-8 encodedCSV format with the following fields from theSpotify 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 theSpotify artist object:

• Artist Genres

And by selecting "Include audio features data", the following fields will be added from theSpotify 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 theSpotify album object (full)

• Album Genres
• Label
• Copyrights

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

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

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

Certain search queries have special meaning:

This project was bootstrapped withCreate React App.

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

yarn start

Runs the app in the development mode.
Openhttp://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 aboutrunning tests for more information.

yarn build

Builds the app for production to thebuild folder.

In addition toCreate React App, the application is built using the following tools/libraries:

• React - A JavaScript library for building user interfaces
• Bootstrap 5 - styling and UI components
• Font Awesome 6 - vector icon set and toolkit
• react-i18next - internationalization framework
• React Testing Library - light-weight solution for testing React DOM nodes
• MSW - network-level request mocking (more of my own thoughtshere)

• 2015: Exportify isborn
• 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

• According to Spotify'sdocumentation:

  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'vegone 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 considercreating 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 torecover them.

Error monitoring provided by Bugsnag.

To build and run Exportify with docker, run:

docker build . -t exportify

docker run -p 3000:3000 exportify

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

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