https://github.com/dun-sin/hearitfresh
Get a personalized spotify playlist based on your current taste of music
https://github.com/dun-sin/hearitfresh
entertainment hacktoberfest music nextjs14 openai-api react reactjs spotify-web-api tailwindcss
Last synced: 6 months ago
JSON representation
Get a personalized spotify playlist based on your current taste of music
- Host: GitHub
- URL: https://github.com/dun-sin/hearitfresh
- Owner: Dun-sin
- License: mit
- Created: 2022-12-27T10:32:36.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-04T09:01:37.000Z (8 months ago)
- Last Synced: 2025-04-08T14:03:05.481Z (6 months ago)
- Topics: entertainment, hacktoberfest, music, nextjs14, openai-api, react, reactjs, spotify-web-api, tailwindcss
- Language: TypeScript
- Homepage: https://hearitfresh.favour.dev
- Size: 539 KB
- Stars: 51
- Watchers: 4
- Forks: 14
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
HearItFresh
Discover new tracks with Hear It Fresh! This user-friendly web app generates personalized Spotify playlists based on your favourite artists or a Spotify playlist link. Explore fresh music.
## 💫 Features
- Authentication of users is carried out through Spotify Login.
- Create new playlists using your favourite artists or an existing playlist
- Get better results by changing the parameters to either getting a playlist of different artists opposite to your taste or get less popular artists
- Your Spotify library will automatically receive newly added playlists.
## 👨💻 Usage
To use HearItFresh, simply navigate to the website and LogIn using your spotify account. Once logged in, you can create new playlists based on your favourite artists or based on a existing spotify playlist.
## 👥 Contributing
Contributions to HearItFresh are welcome! If you find a bug or have a feature request, please create an issue in the GitHub repository. If you would like to contribute code, please follow these steps:
- Take a look at the existing [Issues](https://github.com/Dun-sin/HearItFresh/issues) or [create a new issue](https://github.com/Dun-sin/HearItFresh/issues/new/choose)!
- [Fork the Repo](https://github.com/Dun-sin/HearItFresh/fork). Then, create a branch for any issue that you are working on. Finally, commit your work.
- Create a [Pull Request](https://github.com/Dun-sin/HearItFresh/compare) (PR), which will be promptly reviewed and given suggestions for improvements by the community.
- Add screenshots or screen captures to your Pull Request to help us understand the effects of the changes proposed in your PR.
Please ensure that your code follows the project's coding conventions and has adequate test coverage.
## ⚒️ Installation
- To begin, create a copy of the HearItFresh repository by forking it.Click on the 
Fork symbol at the top right corner.
- Clone your new fork of the repository in the terminal/CLI on your computer with the following command:
```bash
git clone https://github.com//HearItFresh
```
- Navigate to the newly created HearItFresh project directory:
```bash
cd HearItFresh
```
- Install the dependencies
```
npm install && npm install -g commitizen
```
- Run the project
```
npm run dev
```
## How to get the client ID and Secret ID from spotify
- Go to [spotify for Developers](https://developer.spotify.com/)
- Login to your spotify Account
- Go to [your dashboard](https://developer.spotify.com/dashboard)
- [Create a new App](https://developer.spotify.com/dashboard/create)
- Fill in the app name `hearitfresh`, description as whatever you want, and the redirect urls to be `http://localhost:3000`, click on add and at the bottom of the page click on save
- After the project is created, go to settings and you'll find the client secret and ID to use
- Copy them and fill them in the env file as SPOTIFY_CLIENT_ID & SPOTIFY_CLIENT_SECRET, respectively
## 🛡️ License
HearItFresh is licensed under the [MIT License](https://opensource.org/licenses/MIT).
## 🤝 Support
If you liked the project, please consider giving it a ⭐️