{"id":30195778,"url":"https://github.com/blackhatdevx/openspot-music-app","last_synced_at":"2025-08-13T05:02:31.515Z","repository":{"id":304215576,"uuid":"1006172589","full_name":"BlackHatDevX/openspot-music-app","owner":"BlackHatDevX","description":"OpenSpot is a free and open-source music streaming application designed for a seamless, high-fidelity listening experience. Built with a modern tech stack, it features a beautiful, responsive UI that looks great on any device.","archived":false,"fork":false,"pushed_at":"2025-07-25T19:31:34.000Z","size":1680,"stargazers_count":748,"open_issues_count":5,"forks_count":59,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-07-26T02:14:10.324Z","etag":null,"topics":["android","android-studio","api","eas","electron-app","electronjs","expo","flac","free-music","linux","macos","mp3","music-player","nextjs","opensource","react-native","songs","stream","windows"],"latest_commit_sha":null,"homepage":"https://github.com/BlackHatDevX/openspot-music-app/releases","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BlackHatDevX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-21T16:51:20.000Z","updated_at":"2025-07-26T01:28:06.000Z","dependencies_parsed_at":"2025-07-11T19:13:30.122Z","dependency_job_id":"09b285aa-9075-42e5-8a7c-30a9eb6b046d","html_url":"https://github.com/BlackHatDevX/openspot-music-app","commit_stats":null,"previous_names":["blackhatdevx/openspot-music-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/BlackHatDevX/openspot-music-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackHatDevX%2Fopenspot-music-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackHatDevX%2Fopenspot-music-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackHatDevX%2Fopenspot-music-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackHatDevX%2Fopenspot-music-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BlackHatDevX","download_url":"https://codeload.github.com/BlackHatDevX/openspot-music-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackHatDevX%2Fopenspot-music-app/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270183606,"owners_count":24541341,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-13T02:00:09.904Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-studio","api","eas","electron-app","electronjs","expo","flac","free-music","linux","macos","mp3","music-player","nextjs","opensource","react-native","songs","stream","windows"],"created_at":"2025-08-13T05:00:54.948Z","updated_at":"2025-08-13T05:02:31.389Z","avatar_url":"https://github.com/BlackHatDevX.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\r\n\u003cdiv align=\"right\"\u003e\r\n  \u003cdetails\u003e\r\n    \u003csummary \u003e🌐 Language\u003c/summary\u003e\r\n    \u003cdiv\u003e\r\n      \u003cdiv align=\"center\"\u003e\r\n        \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=en\"\u003eEnglish\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=zh-CN\"\u003e简体中文\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=zh-TW\"\u003e繁體中文\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=ja\"\u003e日本語\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=ko\"\u003e한국어\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=hi\"\u003eहिन्दी\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=th\"\u003eไทย\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=fr\"\u003eFrançais\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=de\"\u003eDeutsch\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=es\"\u003eEspañol\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=it\"\u003eItapano\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=ru\"\u003eРусский\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=pt\"\u003ePortuguês\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=nl\"\u003eNederlands\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=pl\"\u003ePolski\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=ar\"\u003eالعربية\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=fa\"\u003eفارسی\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=tr\"\u003eTürkçe\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=vi\"\u003eTiếng Việt\u003c/a\u003e\r\n        | \u003ca href=\"https://openaitx.github.io/view.html?user=BlackHatDevX\u0026project=openspot-music-app\u0026lang=id\"\u003eBahasa Indonesia\u003c/a\u003e\r\n      \u003c/div\u003e\r\n    \u003c/div\u003e\r\n  \u003c/details\u003e\r\n\u003c/div\u003e\r\n\r\n# OpenSpot Music 🎶\r\n\r\n\u003cp align=\"center\"\u003e\r\n \u003cimg width=\"100\" alt=\"OpenSpot Logo\" src=\"https://github.com/user-attachments/assets/9f56500d-d950-48c6-a362-bcbc74be88cb\" /\u003e\r\n\u003c/p\u003e\r\n\r\n\u003ch3 align=\"center\"\u003eYour Gateway to Limitless Music - Cross-Platform Music Streaming\u003c/h3\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003cstrong\u003eStream and download high-quality music for free across all your devices, with no ads and no login required.\u003c/strong\u003e\r\n\u003c/p\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003ca href=\"https://github.com/BlackHatDevX/openspot-music-app/stargazers\"\u003e\r\n    \u003cimg src=\"https://img.shields.io/github/stars/BlackHatDevX/openspot-music-app?style=for-the-badge\u0026color=ffd700\" alt=\"Stars\"\u003e\r\n  \u003c/a\u003e\r\n  \u003ca href=\"https://github.com/BlackHatDevX/openspot-music-app/network/members\"\u003e\r\n    \u003cimg src=\"https://img.shields.io/github/forks/BlackHatDevX/openspot-music-app?style=for-the-badge\u0026color=84b4a3\" alt=\"Forks\"\u003e\r\n  \u003c/a\u003e\r\n  \u003ca href=\"https://github.com/BlackHatDevX/openspot-music-app/issues\"\u003e\r\n    \u003cimg src=\"https://img.shields.io/github/issues/BlackHatDevX/openspot-music-app?style=for-the-badge\u0026color=f38ba8\" alt=\"Issues\"\u003e\r\n  \u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n---\r\n\r\n## 📱📺 Two Amazing Apps, One Repository\r\n\r\nThis repository contains **two complete music streaming applications**:\r\n\r\n### 🎵 **OpenSpot Mobile** (React Native + Expo)\r\n- **Platforms**: Android, iOS\r\n- **Location**: `openspot-music-mobile/`\r\n- **Features**: Native mobile experience with offline downloads, background playback, and persistent state\r\n\r\n### 🖥️ **OpenSpot Desktop** (Electron + React)\r\n- **Platforms**: macOS, Windows, Linux\r\n- **Location**: `openspot-music-electron/`\r\n- **Features**: Desktop-optimized interface with global audio controls, window management, and local storage\r\n\r\n---\r\n\r\n### 📢 Join Our Telegram Channel\r\n\r\nStay updated with **version releases**, and **important announcements** on official Openspot Telegram channel.\r\n\r\n[![Join us on Telegram](https://img.shields.io/badge/Join%20Us%20on-Telegram-2CA5E0?style=for-the-badge\u0026logo=telegram\u0026logoColor=white)](https://t.me/openspot_music)\r\n\r\n\r\n---\r\n\r\n\r\n## 📱 Mobile App (React Native + Expo)\r\n\r\n### Screenshots\r\n\r\n![WhatsApp Image 2025-07-26 at 00 52 14](https://github.com/user-attachments/assets/cc7b262d-ccfe-4899-bd86-56d0e3e90be7)\r\n\r\n\r\n\r\n### Download Links\r\n\r\n- **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)\r\n- **iOS**: Maintainer Needed\r\n\r\n### Development Setup\r\n\r\n```bash\r\ncd openspot-music-app\r\ncd openspot-music-mobile/\r\nnpm install\r\nnpx expo start\r\n```\r\n\r\n### Build for Production\r\n\r\n```bash\r\ncd openspot-music-app/\r\n\r\n# Development Build\r\neas build --platform android --profile development\r\n\r\n# Preview Build (APK)\r\neas build --platform android --profile preview\r\n\r\n# Production Build\r\neas build --platform android --profile production\r\n```\r\n\r\n---\r\n\r\n## 🖥️ Desktop App (Electron + React)\r\n\r\n### Screenshots\r\n\r\n![macOS App](https://github.com/user-attachments/assets/1cb18d3f-4986-4eb2-9cd2-1b606fbf31db)\r\n\r\n### Download Links\r\n\r\n- **macOS DMG**: [OpenSpot.Music-2.0.2-arm64.zip](https://github.com/BlackHatDevX/openspot-music-app/releases/download/v2.0.2/OpenSpot.Music-2.0.2-arm64-mac.zip)\r\n- Run this if you are facing damaged app issue after installation.\r\n  ```bash\r\n  xattr -rd com.apple.quarantine /Applications/OpenSpot\\ Music.app\r\n- **Windows EXE**: Coming Soon!\r\n- **Linux DEB**: Coming Soon!\r\n\r\n### Development Setup\r\n\r\n```bash\r\ncd openspot-music-app/\r\ncd openspot-music-electron/\r\nnpm install\r\nnpm run electron-dev\r\n```\r\n\r\n### Build for Production\r\n\r\n```bash\r\ncd openspot-music-app/\r\ncd openspot-music-electron/\r\nnpm run build\r\nnpm run electron-pack\r\n```\r\n\r\n---\r\n\r\n## ✨ Key Features (Both Apps)\r\n\r\n- **🎵 High-Quality Streaming**: Listen to your favorite tracks in the best possible quality\r\n- **💾 Offline Downloads**: Save music directly to your device for offline listening\r\n- **❤️ Like \u0026 Collect**: Build your personal collection by liking songs\r\n- **🔄 Background Playback**: Continue listening while using other apps\r\n- **🚫 No Login Required**: Jump right in! No accounts or sign-ups needed\r\n- **💾 Persistent State**: Your liked songs and recently played tracks are saved across app restarts\r\n- **🎨 Beautiful UI**: Clean, modern interface designed for each platform\r\n- **🆓 Completely Free \u0026 Ad-Free**: Enjoy uninterrupted music without any cost or advertisements\r\n\r\n---\r\n\r\n\r\n## 💻 Tech Stack\r\n\r\n### Mobile App\r\n- **Framework**: [React Native](https://reactnative.dev/) with [Expo](https://expo.dev/)\r\n- **Navigation**: [Expo Router](https://expo.github.io/router/)\r\n- **Audio**: [Expo AV](https://docs.expo.dev/versions/latest/sdk/av/)\r\n- **Build**: [EAS Build](https://docs.expo.dev/build/introduction/)\r\n- **Location-Fetching**: [IPinfo API](https://github.com/ipinfo)\r\n\r\n### Desktop App\r\n- **Framework**: [Electron](https://www.electronjs.org/) + [React](https://reactjs.org/)\r\n- **UI**: [Material-UI](https://mui.com/)\r\n- **State**: React Context + useReducer\r\n- **Storage**: [electron-store](https://github.com/sindresorhus/electron-store)\r\n- **Build**: [electron-builder](https://www.electron.build/)\r\n\r\n### Shared\r\n- **Language**: [TypeScript](https://www.typescriptlang.org/)\r\n- **Package Manager**: npm/yarn\r\n\r\n---\r\n\r\n### Environment Configuration\r\n\r\nThis project requires a single environment variable to function correctly.\r\n\r\n- A template is provided in the [`.env.template`](https://github.com/BlackHatDevX/openspot-music-app/blob/main/openspot-mobile/.env.template) file.\r\n- 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).\r\n\r\n\r\n---\r\n\r\n## 🚀 Quick Start\r\n\r\n### For Mobile Development\r\n```bash\r\ngit clone https://github.com/BlackHatDevX/openspot-music-app.git\r\ncd openspot-music-app/\r\ncd openspot-music-mobile/\r\nnpm install\r\nnpx expo start\r\n```\r\n\r\n### For Desktop Development\r\n```bash\r\ngit clone https://github.com/BlackHatDevX/openspot-music-app.git\r\ncd openspot-music-app/\r\ncd openspot-music-electron/\r\nnpm install\r\nnpm run electron-dev\r\n```\r\n\r\n---\r\n\r\n## 🤝 Contributing\r\n\r\nWe welcome contributions to both apps!\r\n## 📞 Community \u0026 Support\r\n\r\n- **Telegram**: [Openspot Music](https://telegram.dog/Openspot_Music)\r\n- **Issues**: [GitHub Issues](https://github.com/BlackHatDevX/openspot-music-app/issues)\r\n\r\n## 👤 Author \u0026 Contact\r\n\r\n**Jash Gro**\r\n\r\n- **LinkedIn**: [https://linkedin.com/in/jash-gro/](https://linkedin.com/in/jash-gro/)\r\n- **Portfolio**: [https://bit.ly/jashgro](https://bit.ly/jashgro)\r\n- **Telegram**: [https://telegram.dog/deveIoper_x](https://telegram.dog/deveIoper_x)\r\n- **GitHub**: [https://github.com/BlackHatDevX](https://github.com/BlackHatDevX)\r\n\r\n## 📄 License\r\n\r\nThis project is open-source and licensed under the MIT License. See the `LICENSE` file for more information.\r\n\r\n---\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003cstrong\u003e⭐ If you like this project, please give it a star! ⭐\u003c/strong\u003e\r\n  \u003cbr /\u003e\r\n  \u003cem\u003eYour support helps us continue developing amazing free music apps for everyone.\u003c/em\u003e\r\n\u003c/p\u003e \r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackhatdevx%2Fopenspot-music-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblackhatdevx%2Fopenspot-music-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackhatdevx%2Fopenspot-music-app/lists"}