README 未给出构建与运行命令,需自行进入 openspot-mobile/ 或 openspot-desktop/ 目录按各自框架安装依赖;桌面端基于 Tauri,需另行准备 Rust 与系统 WebView 依赖;Trending 功能依赖 IPinfo API 按 IP 定位地区
openspot-music-app
BlackHatDevXMIT活跃维护跨平台开源音乐播放器,支持在线流式播放和离线下载高品质曲目,覆盖安卓、iOS、桌面全平台,界面简洁流畅。
OpenSpot is a free, open-source music app that lets you stream and download high-quality tracks across all your devices. With a sleek, intuitive UI built for a seamless experience, it supports Android, iOS, macOS, Windows, and Linux — so you can enjoy your favorite music anywhere, online or offline.
git clone https://github.com/BlackHatDevX/openspot-music-app.gitREADME 未说明硬件要求;支持 Android、iOS、macOS、Windows、Linux 平台
免费开源跨平台音乐应用,无需登录即可在线流媒体播放和离线下载高质量歌曲
跨平台开源音乐播放器,支持在线流式播放和离线下载高品质曲目,覆盖安卓、iOS、桌面全平台,界面简洁流畅。
核心能力
- 支持从任意公开 Spotify 歌单链接导入音乐
- 按 IP 地区展示 75+ 国家的 Trending 热门歌曲
- 下载曲目后离线播放,支持后台播放与锁屏控制
- 移动端用 React Native + Expo,桌面端用 Tauri + React
- 支持深色、浅色和自动三种主题模式
容易踩的坑
- v3.1.5OpenSpot v3.1.5最新正式版2026-06-02 · 2026-06-02 19:35 UTC
What's New
- Import music directly from any public Spotify playlist URL.
- Added support for Trending (from Spotify) in 75+ countries.
- Fixed an issue where some playlists, albums, or songs appeared empty or incomplete in certain countries.
- Fixed downloads being interrupted or killed while running in the background.
- Fixed various offline mode issues for a more reliable listening experience.
- Minor bug fixes and performance improvements.
DOWNLOAD NOW - https://blackhatdevx.github.io/openspot-music-app/
For macOS users, run the following command after installation:
xattr -rd com.apple.quarantine /Applications/OpenSpot.app - v3.1.4OpenSpot v3.1.42026-05-05 · 2026-05-05 13:16 UTC
查看更新说明
What's New
- Tap on an artist name to instantly search for that artist's songs.
- Added rotating music artwork animation for a smoother now-playing experience.
- You can now save artists, playlists, and albums directly to your library.
- General bug fixes and performance improvements.
- Shuffle mode for playlist, artist and albums.
DOWNLOAD NOW - https://blackhatdevx.github.io/openspot-music-app/
In macos run below command after installation
xattr -rd com.apple.quarantine /Applications/OpenSpot.app - v3.1.3OpenSpot v3.1.32026-04-30 · 2026-04-30 07:01 UTC
查看更新说明
OpenSpot v3.1.3 (Hotfix): A quick stability update following v3.1.0.
This build has been merged and addresses critical issues affecting the previous release. This was deployed as a force update to ensure all users are on a stable version.
Fixes:
- Fixed backend/API error that caused app issues
- Fixed translation errors across multiple languages
OpenSpot v3.1.0
A major stability-focused update — this is the most stable version so far with no known bugs at the moment.
This release brings offline support, better performance, and an improved experience across different devices.
What’s new & improved:
- Offline mode now supported with search and filter functionality
- Optimized player for smoother and faster performance (#50)
- Added Turkish translations
- Region-based trending toggle (on/off) added (#33)
- Screen rotation support added
- Improved compatibility with tablets and Android car systems
- Fixed notification control issues
- Added advanced update system with in-app changelogs
- Repeat-one option added for better playback control (#21)
- YouTube API integration now in beta
- Fixed search crash
OpenSpot-3.1.3-release.dmg MacOS (Apple Sillicon) added
OpenSpot-3.1.3-release.ipa added (someone just test and report bugs to me... thanks) - 05/05/2026
- v2.0.5OpenSpot v2.0.52026-04-27 · 2026-04-27 21:44 UTC
查看更新说明
OpenSpot v2.0.5 (Android & iOS - React Native)
New Features
Internationalization (i18n)
- Added support for 8 languages: German (de), English (en), Spanish (es), French (fr), Hebrew (he), Hindi (hi), Russian (ru), and Chinese (zh).
API Integrations
- Integrated support for Savan API and YouTube API.
Enhanced Search
- Users can now search public playlists, albums, and artists (available via Savan API only).
UI Improvements
- Fully revamped interface with a redesigned Welcome screen and Settings screen.
Theme Support
- Added Dark Mode, Light Mode, and Auto (system-based) theme switching.
iOS Status
-
Tested successfully on iOS 26 simulator via Expo Go (working as expected).
-
No Apple Developer Account ($100/year) currently available, so:
- .ipa builds
- TestFlight distribution are not available at the moment.
Community contributions or assistance for iOS build and distribution are welcome.
- v2.0.4OpenSpot v2.0.42025-09-20 · 2025-09-20 13:19 UTC
查看更新说明
Changelog
- New API integrated → #32
- Aggressive wakelock implementation to fix background app kill issues on MIUI / HyperOS / other aggressive ROMs → #30, #20, #19
- HyperOS navigation bar override issue resolved → #28
- Media controls notification (Play/Pause/Next/Previous) → still in beta → #9
- Downloads list infinite loading bug fixed
- iOS → Tested on iOS 26 simulator via Expo Go. Works fine (video).
⚠️ No Apple Developer Account ($100/year), so
.ipaand TestFlight builds are not available. Community help for iOS builds is welcome!
Huge thanks to Dab Music for providing API support!
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
📦 Downloads
What's New in v3.1.5
- Import music directly from any public Spotify playlist URL.
- Added support for Trending (from Spotify) in 75+ countries.
- Fixed an issue where some playlists, albums, or songs appeared empty or incomplete in certain countries.
- Fixed downloads being interrupted or killed while running in the background.
- Fixed various offline mode issues for a more reliable listening experience.
- Minor bug fixes and performance improvements.
If you have any suggestion (new add-on or fix), message me on telegram
✨ Features
🎧 High‑Quality Streaming · 📥 Offline Downloads · ❤️ Likes & Custom Playlists
🔄 Background Play · 🚫 No Login Required · 🆓 100% Free & Ad‑Free
🌍 Languages Supported (i18n)
| 🇩🇪 Deutsch | 🇺🇸 English | 🇪🇸 Español | 🇫🇷 Français | 🇮🇱 עברית | 🇮🇳 हिन्दी | 🇰🇷 한국어 | 🇷🇺 Русский | 🇨🇳 中文 | 🇹🇷 Türkçe |
|---|
More languages coming soon — contributions welcome!
🎨 Look & Feel
- Revamped UI – clean, modern design with smooth transitions
- Mini Player – capsule‑style mini player on compatible devices (OnePlus, etc.)
- Theming – Dark mode, Light mode, and Auto mode
🎼 Music Experience
- Search – find songs, public playlists, albums, and artists
- Offline Listening – download tracks and play them without internet
- Custom Playlists – create, manage, and organize your own collections
- Import Music directly from spotify playlist url
- Trending Songs – region‑based trending tracks powered by IPinfo
- Artist Albums & Playlists – full discography browsing now supported
⚡ Performance & Stability
- Improved YouTube API – more reliable streaming
- Playback Upgrades – smoother performance, fixed duration and background playback bugs
- Headset & Lockscreen Controls – seamless notification controls
- Paginated Artist Songs – all songs load completely
📖 Overview
This monorepo delivers two fully independent music streaming apps built with cutting‑edge technologies:
| App | Platforms | Framework | Location |
|---|---|---|---|
| 📱 Mobile | Android, iOS | React Native + Expo | openspot-mobile/ |
| 🖥️ Desktop | macOS, Windows/Linux | Tauri + React | openspot-desktop/ |
Both apps share the same powerful streaming core, giving you a seamless listening experience across all your devices.
🧰 Tech Stack
📱 Mobile
React Native · Expo Router · Expo AV · EAS Build · IPinfo API
🖥️ Desktop
Tauri · React · Material‑UI · React Context + useReducer
📊 Code Composition
🌍 Community & Support
- 💬 Telegram: @openspot_music
- 🐛 Issues: GitHub Issues
👤 Author
Jash Gro
📄 License
This project is licensed under the MIT License – see the LICENSE file for details.