A web app that utilizes Spotify's API in order to generate curated Spotify playlists of the songs/artists you keep on repeat.
- 🤔 Have you ever wondered what your top songs or artists of all-time are?
- ❤️ Did you just listen to a song that you forgot to heart?
- 🙏 In desparate need of a new playlist that will be generated straight to your Spotify account?
Listy is everything you've been looking for and more!
This App is readily available on Listy.dev
If you are interested in hosting your own version of this app, you will need to create an account with Spotify For Developers in order to access the necessary APIs that this app utilizes.
-
Clone the repo
git clone https://github.com/your_username_/Project-Name.git
-
Install NPM packages
npm install
-
Fill in Client Secret Environment Variable with what you receive from your Spotify For Developers Account. This will provide you access to Spotify Web APIs
-
Replace the Redirect URI with your personal URL of choice to host the server
There are 3 Sections of this Web App:
- Top Tracks
- Top Artists
- Recently Played
For the Top Tracks and Top Artists section, you have the option to select a timeframe of
- All Time
- Most Recent 6 Months
- Most Recent Month
When you select your section and timeframe of interest, you will receive a list of your top songs/artists. For the Top Tracks section, you will receive your top 50 tracks of the selected timeframe. For the Top Artists section, you will receive a list of your top 50 artists. For the Recently Played section, you will receive your 50 most recent tracks that you have played.
Each of the items on the list you generate will link you to their respective Spotify page.
You can also create a playlist from your list of songs/artists which will create a playlist directly in your Spotify Account. No extra work required! Just name your playlist and it will show up on your Spotify App.
- Add Top Artists Page
- Add Top Tracks Page
- Add Recently Played Page
- Add Functionality to Create Playlist
- Get Approval for Authentication Quota Extension
See the open issues for a full list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE.txt for more information.
Hollis Kuang - [email protected]
Project Link: https://github.com/holliskuang/Listy.dev
Use this space to list resources you find helpful and would like to give credit to. I've included a few of my favorites to kick things off!