Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/satyam1923/spring-music-player

The Spring Music Player project aims to create a feature-rich music player application leveraging the multiple APIs. This application will provide users with a seamless experience to discover, stream, and organize their favorite music tracks from the extensive library.
https://github.com/satyam1923/spring-music-player

api-rest axios docker expressjs figma firebase firebase-auth javascript nodejs npm-package postman reactjs redux vercel-deployment vscode

Last synced: 6 days ago
JSON representation

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

Awesome Lists containing this project

README

        


⭐️ 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
- User authentication


## 🚀 Tech Stack

**Client:** React

**Server:** Node, Express, Firebase, Axios

**API:** [API Link](http://jiosaavn-olj6ym1v4-thesumitkolhe.vercel.app)


## 🎨 Expected Design

![Screenshot 2024-06-07 012636](https://github.com/Satyam1923/Spring-Music-Player/assets/104068640/34b12993-4a35-431b-bebb-b390591de6ae)

Check the Expected design in [Figma](https://www.figma.com/design/WQnt0qRFSdaV3jW5XF8NSc/Spring-Music-player-new-design?node-id=0-1&t=Q8iDfJsPXtkoDLTG-1)


## 🛠️ Getting Started

### With Docker
1. **Clone the repository**

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

### For Backend
1. **Navigate to the backend folder**
```sh
cd backend
```
2. **Build Docker Image**
```sh
docker build -t backend:v1 .
```
3. **Run Docker Image**
```sh
docker run -p 3030:3030 backend:v1
```
4. **Access it locally**

Go to http://localhost:3030/

### For Frontend
1. **Navigate to the frontend folder**

```sh
cd frontend
```
2. **Build Docker Image**
```sh
docker build -t frontend:v1 .
```
3. **Run Docker Image**
```sh
docker run -p 3000:3000 frontend:v1
```
4. **Access it locally**

Go to http://localhost:3000/

### Without Docker

1. **Clone the repository**

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

### For Backend
1. **Navigate to the backend folder**
```sh
cd backend
```
2. **Install npm packages**
```sh
npm install .
```
3. **Run the server**
```sh
node index.js
```
4. **Access it locally**

Go to http://localhost:3030/

### For Frontend
1. **Navigate to the frontend folder**

```sh
cd frontend
```
2. **Install npm packages**
```sh
npm install .
```
3. **Run the development server**
```sh
npm run dev
```
4. **Access the local server.**
You will receive a link in your terminal.

5. Make dummy firebase project and Use it's config in firebase.js

## Contributing Readme.

### For someone working on backend
1. Change directory
```sh
cd backend
```
2. Install npm packages
```sh
npm install .
```
3. Go to localhost
```sh
https://localhost:3030/
```
### For someone working on frontend
1. Change directory
```sh
cd frontend
```
2. Install npm packages
```sh
npm install .
```
3. Run server
```sh
npm run dev
```
4. Make dummy firebase project and Use it's config in firebase.js

## For someone working on backend+frontend
1. Change directory
```sh
cd backend
```
2. Install npm packages
```sh
npm install .
```
3. Go to localhost
```sh
https://localhost:3030/
```
4. Change directory
```sh
cd frontend
```
5. Install npm packages
```sh
npm install .
```
6. Change directory
```sh
cd src
```
7. Make dummy firebase project and Use it's config in firebase.js


## 🤝 Contributing

[![GitHub repo Good Issues for newbies](https://img.shields.io/github/issues/Satyam1923/Spring-Music-Player/good%20first%20issue?style=flat&logo=github&logoColor=green&label=Good%20First%20issues)](https://github.com/Satyam1923/Spring-Music-Player/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) [![GitHub Help Wanted issues](https://img.shields.io/github/issues/Satyam1923/Spring-Music-Player/help%20wanted?style=flat&logo=github&logoColor=b545d1&label=%22Help%20Wanted%22%20issues)](https://github.com/Satyam1923/Spring-Music-Player/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) [![GitHub Help Wanted PRs](https://img.shields.io/github/issues-pr/Satyam1923/Spring-Music-Player/help%20wanted?style=flat&logo=github&logoColor=b545d1&label=%22Help%20Wanted%22%20PRs)](https://github.com/Satyam1923/Spring-Music-Player/pulls?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) [![GitHub repo Issues](https://img.shields.io/github/issues/Satyam1923/Spring-Music-Player?style=flat&logo=github&logoColor=red&label=Issues)](https://github.com/Satyam1923/Spring-Music-Player/issues?q=is%3Aopen)

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.
- Please 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**
```sh
git clone https://github.com/Satyam1923/Spring.git
```
3. **Create a new branch and move to it**
```sh
git checkout -b fix-issue-
```
4. **Make your changes, then check the status of changed files**
```sh
git status
```

5. **Add all the files to the staging area**
```sh
git add .
```
or
```sh
git add
```
6. **Commit your changes with a descriptive message**
```sh
git commit -m ""
```
7. **Push your changes to your branch**
```sh
git push origin fix-issue-
```
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. 🎶✨**




Open Source Programs





GSSOC Logo


GSSOC 2024




This project is part of GirlScript Summer of Code. We're excited to have contributions from the community to help make Spring-Music-Player even better.





Code of Conduct


Please note that this project is released with a [Contributor Code of Conduct](./CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.




License


This project is licensed under the [MIT License](./LICENSE).





Contributors


Thank you for contributing to our project! Your support is invaluable in enhancing Spring-Music-Player and making it even better. 😊