https://github.com/antoniomrtz/spotifyelectron

Cross-platform music streaming desktop app made with Electron-React frontend and Python-FastAPI-MongoDB. The main goal is to reproduce the original Spotify's functionalities while incorporating unique user-requested features such as the ability to upload personal music.
https://github.com/antoniomrtz/spotifyelectron

aws aws-lambda aws-s3 collaborate electron fastapi github-actions jest jwt-authentication material-ui mongodb pytest python react react-testing-library spotify spotify-clone typescript

Last synced: about 1 month ago
JSON representation

Host: GitHub
URL: https://github.com/antoniomrtz/spotifyelectron
Owner: AntonioMrtz
License: other
Created: 2023-06-08T14:30:25.000Z (almost 2 years ago)
Default Branch: master
Last Pushed: 2025-03-24T09:23:27.000Z (about 2 months ago)
Last Synced: 2025-03-30T05:04:17.739Z (about 2 months ago)
Topics: aws, aws-lambda, aws-s3, collaborate, electron, fastapi, github-actions, jest, jwt-authentication, material-ui, mongodb, pytest, python, react, react-testing-library, spotify, spotify-clone, typescript
Language: Python
Homepage: https://antoniomrtz.github.io/SpotifyElectron_Web/
Size: 101 MB
Stars: 61
Watchers: 5
Forks: 32
Open Issues: 18
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: docs/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: docs/SECURITY.md

Awesome Lists containing this project

README

# Spotify Electron

![Spotify Electron Media Preview](docs/assets/videos/SpotifyElectronReadmePreview.gif)

## Overview

[Spotify Electron](https://antoniomrtz.github.io/SpotifyElectron_Web/) is a cross-platform music streaming desktop app made with Electron-React frontend and Python-FastAPI-MongoDB. The main goal is to reproduce the original Spotify's functionalities while incorporating unique user-requested features such as the ability to upload personal music.

https://github.com/user-attachments/assets/1f32fa25-e99f-4cc3-8664-b21bce155934

## 🌐 Website

Check out our [website](https://antoniomrtz.github.io/SpotifyElectron_Web/). Contributions to the website can made through [its repository](https://github.com/AntonioMrtz/SpotifyElectron_Web).

## 📚 Docs

Check the [project documentation](https://antoniomrtz.github.io/SpotifyElectron_Web/docs/).

## 🔽 Download Installer

Download the [installer](https://github.com/AntonioMrtz/SpotifyElectron/releases). Follow the [instalation guide](docs/user/user-guides/Installation-Guide.md) for a more in deep explanation about installing and running the app.

## 🔧 Set up and run

### 1. Clone the repository

```console
git clone https://github.com/AntonioMrtz/SpotifyElectron.git
```

### 2. Set up and run

[⚙️ GLOBAL](docs/developer/SETUP.md)

[🖥 BACKEND](docs/developer/backend/SETUP.md)

[💻 FRONTEND](docs/developer/frontend/SETUP.md)

## 🖐 How to Contribute to the project

Are you interested in contributing to the project? Check our contributing rules and methodologies in
[our CONTRIBUTING documentation](docs/CONTRIBUTING.md). Also you can check all the contributors to the project [here](docs/CONTRIBUTORS.md).

## 🎯 Project's goals

Check our [project goals and vision](docs/VISION.md).

## 🏗️ Software Architecture

For an in-depth tour of the architecture, refer to the [architecture docs](docs/developer/Architecture.md).

![Spotify_Electron_Software_Diagram](docs/assets/architecture/app_architecture_blob.png)

### 🎵 Song Architecture

![Spotify_Electron_Software_Song_Diagram](docs/assets/architecture/song-architecture-blob.png)

## 🤵🏼 Contributors

We're actively looking for new contributors 🙌. Feel free to check our [CONTRIBUTING documentation](docs/CONTRIBUTING.md) for more info.

_Ferbo12

_Ercamarero

_KarlosM2

_mariete1223

_xiomaraR

_Javiks-P

_raulZC

_{TalhaBinNasir}

_ariceron5

_aarshgupta24

_ErikMisencik

_perig99

_ObuMan

_gigigimay

_SaurabhGurde

_AlesSust

_{PavlisinPhoto}

_berkaykrc

_{Nishant Singh}

_vihanvt