# OpenSpot Music 🎶
Your Gateway to Limitless Music - Cross-Platform Music Streaming
Stream and download high-quality music for free across all your devices, with no ads and no login required.
---
## 📱📺 Two Amazing Apps, One Repository
This repository contains **two complete music streaming applications**:
### 🎵 **OpenSpot Mobile** (React Native + Expo)
- **Platforms**: Android, iOS
- **Location**: `openspot-music-mobile/`
- **Features**: Native mobile experience with offline downloads, background playback, and persistent state
### 🖥️ **OpenSpot Desktop** (Electron + React)
- **Platforms**: macOS, Windows, Linux
- **Location**: `openspot-music-electron/`
- **Features**: Desktop-optimized interface with global audio controls, window management, and local storage
---
### 📢 Join Our Telegram Channel
Stay updated with **version releases**, and **important announcements** on official Openspot Telegram channel.
[](https://t.me/openspot_music)
---
## 📱 Mobile App (React Native + Expo)
### Screenshots
### Download Links
- **Android APK**: [OpenSpot-2.0.3-release.apk](https://github.com/BlackHatDevX/openspot-music-app/releases/download/v2.0.3/OpenSpot-2.0.3-release.apk)
- **iOS**: Maintainer Needed
### Development Setup
```bash
cd openspot-music-app
cd openspot-music-mobile/
npm install
npx expo start
```
### Build for Production
```bash
cd openspot-music-app/
# Development Build
eas build --platform android --profile development
# Preview Build (APK)
eas build --platform android --profile preview
# Production Build
eas build --platform android --profile production
```
---
## 🖥️ Desktop App (Electron + React)
### Screenshots
### Download Links
- **macOS DMG**: [OpenSpot.Music-2.0.3-arm64.zip](https://github.com/BlackHatDevX/openspot-music-app/releases/download/v2.0.3/OpenSpot.Music-2.0.3-arm64.dmg)
- Run this if you are facing damaged app issue after installation.
```bash
xattr -rd com.apple.quarantine /Applications/OpenSpot\ Music.app
- **Windows EXE**: Coming Soon!
- **Linux DEB**: Coming Soon!
### Development Setup
```bash
cd openspot-music-app/
cd openspot-music-electron/
npm install
npm run electron-dev
```
### Build for Production
```bash
cd openspot-music-app/
cd openspot-music-electron/
npm run build
npm run electron-pack
```
---
## ✨ Key Features (Both Apps)
- **🎵 High-Quality Streaming**: Listen to your favorite tracks in the best possible quality
- **💾 Offline Downloads**: Save music directly to your device for offline listening
- **❤️ Like & Collect**: Build your personal collection by liking songs
- **🔄 Background Playback**: Continue listening while using other apps
- **🚫 No Login Required**: Jump right in! No accounts or sign-ups needed
- **💾 Persistent State**: Your liked songs and recently played tracks are saved across app restarts
- **🎨 Beautiful UI**: Clean, modern interface designed for each platform
- **🆓 Completely Free & Ad-Free**: Enjoy uninterrupted music without any cost or advertisements
---
## 💻 Tech Stack
### Mobile App
- **Framework**: [React Native](https://reactnative.dev/) with [Expo](https://expo.dev/)
- **Navigation**: [Expo Router](https://expo.github.io/router/)
- **Audio**: [Expo AV](https://docs.expo.dev/versions/latest/sdk/av/)
- **Build**: [EAS Build](https://docs.expo.dev/build/introduction/)
- **Location-Fetching**: [IPinfo API](https://github.com/ipinfo)
### Desktop App
- **Framework**: [Electron](https://www.electronjs.org/) + [React](https://reactjs.org/)
- **UI**: [Material-UI](https://mui.com/)
- **State**: React Context + useReducer
- **Storage**: [electron-store](https://github.com/sindresorhus/electron-store)
- **Build**: [electron-builder](https://www.electron.build/)
### Shared
- **Language**: [TypeScript](https://www.typescriptlang.org/)
- **Package Manager**: npm/yarn
---
### Environment Configuration
This project requires a single environment variable to function correctly.
- A template is provided in the [`.env.template`](https://github.com/BlackHatDevX/openspot-music-app/blob/main/openspot-mobile/.env.template) file.
- The required **value** to complete your `.env` file is shared in the **pinned message** of our **official Telegram channel**: [@openspot_music](https://t.me/openspot_music).
---
## 🚀 Quick Start
### For Mobile Development
```bash
git clone https://github.com/BlackHatDevX/openspot-music-app.git
cd openspot-music-app/
cd openspot-music-mobile/
npm install
npx expo start
```
### For Desktop Development
```bash
git clone https://github.com/BlackHatDevX/openspot-music-app.git
cd openspot-music-app/
cd openspot-music-electron/
npm install
npm run electron-dev
```
---
## 🤝 Contributing
We welcome contributions to both apps!
## 📞 Community & Support
- **Telegram**: [Openspot Music](https://telegram.dog/Openspot_Music)
- **Issues**: [GitHub Issues](https://github.com/BlackHatDevX/openspot-music-app/issues)
## 👤 Author & Contact
**Jash Gro**
- **LinkedIn**: [https://linkedin.com/in/jash-gro/](https://linkedin.com/in/jash-gro/)
- **Portfolio**: [https://bit.ly/jashgro](https://bit.ly/jashgro)
- **Telegram**: [https://telegram.dog/deveIoper_x](https://telegram.dog/deveIoper_x)
- **GitHub**: [https://github.com/BlackHatDevX](https://github.com/BlackHatDevX)
## 📄 License
This project is open-source and licensed under the MIT License. See the `LICENSE` file for more information.
---
⭐ If you like this project, please give it a star! ⭐
Your support helps us continue developing amazing free music apps for everyone.