Awesome
<a href="https://exportify.app/"><img src="assets/screenshot.png"/></a>
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
- Fire up the app
- Click 'Get Started'
- Grant Exportify read-only access to your playlists
- 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.
<a href="https://watsonbox.github.io/exportify/"><img src="https://user-images.githubusercontent.com/17737/100668594-72be1600-335c-11eb-90d6-c9ae873e347d.png"/></a>
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:
<a href="https://watsonbox.github.io/exportify/"><img src="https://user-images.githubusercontent.com/17737/100201109-eb0d7d00-2eff-11eb-993e-7ed955e2361c.gif"/></a>
- 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:
- 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 thoughts here)
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.
<a href="http://www.bugsnag.com"> <img src="assets/bugsnag.png" width="200" /> </a>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
- Fork it ( https://github.com/watsonbox/exportify/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request