tarungupta18/spring-music-player

The JioSaavn Player project aims to create a feature-rich music player application leveraging the unofficial JioSaavn API. This application will provide users with a seamless experience to discover, stream, and organize their favorite music tracks from the extensive JioSaavn library.

⭐️ Spring - Music Player ⭐️

The Spring Music Player with JioSaavn API Integration is a web application that allows users to listen to their favorite music tracks using the JioSaavn music streaming service. It provides a seamless and user-friendly interface for discovering, playing, and managing music playlists.

✨ Features ✨

• Music/Album/Playlists/Singer Search
• Playback Controls
• Top 10 search list
• Loop Playback

🚀 Tech Stack

Client: React, TailwindCSS

Server: Node, Express, Firebase, Axios

API: JioSaavn API (unofficial) - API Link

🎨 Expected Design

Check the design in Figma

🌐 WebPage link

Visit the Spring Music Player here

🛠️ Getting Started

1. Clone the repository

 git clone https://github.com/Satyam1923/Spring.git

For Backend

1. Navigate to the backend folder

cd backend

2. Install npm packages

npm install .

3. Run the server

node index.js

4. Access it locally

Go to http://localhost:3030/

For Frontend

1. Navigate to the frontend folder

cd frontend

2. Install npm packages

npm install .

3. Run the development server

npm run dev

4. Access the local server You will receive a link in your terminal.

Contributing Readme.

For someone working on backend

1. Change directory

cd backend

2. Install npm packages

npm install .

3. Go to localhost

https://localhost:3030/

For someone working on frontend

1. Change directory

cd frontend

2. Install npm packages

npm install .

3. Run server

npm run dev

For someone working on backend+frontend

1. Change directory

cd backend

2. Install npm packages

npm install .

3. Go to localhost

https://localhost:3030/

4. Change directory

cd frontend

5. Install npm packages

npm install .

6. Change directory

cd  src

7. change in app.jsx under app component fetchSongData function change this url https://spring-music-player-3hyj.vercel.app/search with https://localhost:3030/search

🤝 Contributing

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 any suggestions for the projects, like reporting a bug, improving UI/UX, or enhancing the README.md file, feel free to open an issue to discuss it.
• Please ensure your pull request adheres to good practices and standards.
• Pleae ensure your pull request have reference to the issue assigned.
• Please make sure you check your spelling and grammar.
• Create individual Pull Requests for each issues.

🔧Creating a Pull Request

1. Fork the Project
2. Clone your forked repository

git clone https://github.com/Satyam1923/Spring.git

3. Create a new branch and move to it

git checkout -b fix-issue-<ISSUE-NUMBER>

4. Make your changes, then check the status of changed files

git status 

5. Add all the files to the staging area

git add .

or

git add <file_name1> <file_name2>

6. Commit your changes with a descriptive message

git commit -m "<EXPLAIN-YOUR_CHANGES>"

7. Push your changes to your branch

git push origin fix-issue-<ISSUE-NUMBER>

8. Open a Pull Request

Feel free to enhance this project and contribute in any way you find valuable! Let's make Spring Music Player even better together. 🎶✨