🌐 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(WIP)
• Location: openspot-music-mobile/
• Features: Native mobile experience with offline downloads, background playback, and persistent state

🖥️ OpenSpot Desktop (Electron + React)

• Platforms: macOS, Windows(WIP), Linux(WIP)
• 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.

Join us on Telegram (https://img.shields.io/badge/Join%20Us%20on-Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)

📱 Mobile App (React Native + Expo)

Screenshots

!WhatsApp Image 2025-07-26 at 00 52 14 (https://github.com/user-attachments/assets/cc7b262d-ccfe-4899-bd86-56d0e3e90be7)

Download Links

• Android APK: OpenSpot-2.0.4-release.apk (https://github.com/BlackHatDevX/openspot-music-app/releases/download/v2.0.4/OpenSpot-2.0.4-release.apk)
• iOS: Maintainer Needed (https://github.com/BlackHatDevX/openspot-music-app/issues/15)

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

!macOS App (https://github.com/user-attachments/assets/1cb18d3f-4986-4eb2-9cd2-1b606fbf31db)

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.

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

• Windows EXE: Coming Soon! (https://github.com/BlackHatDevX/openspot-music-app/issues/18)
• Linux DEB: Coming Soon! (https://github.com/BlackHatDevX/openspot-music-app/issues/14)

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 (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

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

🙌 Contributors

A huge thanks to these amazing people who made this project possible:

• @sixnine-dotdev (https://github.com/sixnine-dotdev) – Core contributions, API integration and overall backbone of the project

📞 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.