🌐 Language

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | हिन्दी | ไทย | Français | Deutsch | Español | Itapano | Русский | Português | Nederlands | Polski | العربية | فارسی | Türkçe | Tiếng Việt | Bahasa Indonesia

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.

---

📱 Mobile App (React Native + Expo)

Screenshots

Download Links

• Android APK: OpenSpot-2.0.3-release.apk
• iOS: Maintainer Needed

Development Setup

cd openspot-music-app
cd openspot-music-mobile/
npm install
npx expo start

Build for Production

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
• Run this if you are facing damaged app issue after installation.

  xattr -rd com.apple.quarantine /Applications/OpenSpot\ Music.app

• Windows EXE: Coming Soon!
• Linux DEB: Coming Soon!

Development Setup

cd openspot-music-app/
cd openspot-music-electron/
npm install
npm run electron-dev

Build for Production

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 with Expo
• Navigation: Expo Router
• Audio: Expo AV
• Build: EAS Build
• Location-Fetching: IPinfo API

Desktop App

• Framework: Electron + React
• UI: Material-UI
• State: React Context + useReducer
• Storage: electron-store
• Build: electron-builder

Shared

• Language: TypeScript
• Package Manager: npm/yarn

---

Environment Configuration

This project requires a single environment variable to function correctly.

• A template is provided in the .env.template file.
• The required value to complete your .env file is shared in the pinned message of our official Telegram channel: @openspot_music.

---

🚀 Quick Start

For Mobile Development

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

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
• Issues: GitHub Issues

👤 Author & Contact

Jash Gro

• LinkedIn: https://linkedin.com/in/jash-gro/
• Portfolio: https://bit.ly/jashgro
• Telegram: https://telegram.dog/deveIoper_x
• GitHub: 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.