NSMusicS Workspace

Language: English | Chinese

NSMusicS is a cross-platform music client project for local libraries, private cloud music, and self-hosted streaming ecosystems.
Its paired server, NineSong, provides the cloud-native backend for music today and is also intended to support broader personal digital center scenarios over time, including video, gallery, notes, documents, and more.

Current Release And Roadmap

As of April 9, 2026:

• The Windows release currently listed on Microsoft Store is the NSMusicS-Flutter closed-source paid edition.
• Microsoft Store web page: https://apps.microsoft.com/detail/9N0RWS2TJXG1
• Windows Store deep link: ms-windows-store://pdp/?productid=9N0RWS2TJXG1
• A 15-day free trial is currently available on Windows.
• The current GitHub releases published from this repository remain the open-source Electron transition edition.
• The current Electron and Web delivery line is a transition release that keeps the project available before the next-generation client wave lands.
• The next refactored client wave is targeted for roughly mid-May 2026.
• That refactored wave is planned to include React, React Native, Vue, and Angular client lines.
• The Electron and Web variants in that wave are intended to follow the official and community-recommended best practices of each stack instead of forcing one shared implementation style across all frameworks.
• App Store releases for macOS and iOS, plus the Google Play release for Android, are planned next.
• The product direction remains centered on local music libraries, private cloud music, compatibility with major self-hosted servers, and deeper integration with NineSong.

If you want the Windows commercial release, start from Microsoft Store.
If you want the current open-source release line, source tree, architecture, and roadmap context, use this repository and its GitHub Releases.

Open-source And Store Editions

The current public-facing delivery is split into two different product lines. They are related, but they are not the same build or the same source release.

Why NSMusicS

NSMusicS is designed for people whose music no longer lives in one simple folder.

• It supports local music libraries and private cloud music scenarios.
• It works with major self-hosted music servers such as Navidrome, Jellyfin, and Emby.
• It is being built as a unified music hub instead of a single-source player.
• It focuses on large-library usability through search, metadata, tags, ratings, playlists, and lyrics workflows.
• It also pushes beyond basic playback through lossless support, lyric precision, audio effects, immersive playback views, and theme customization.

As of March 22, 2026, the main NSMusicS open-source repository had reached 2,265 GitHub stars.
The product line first built credibility through open-source distribution, then moved toward the current refactoring roadmap.

Product Planning

The current planning direction includes:

• The current Electron/Web release line serving as the transition edition before the refactored client wave ships.
• A refactored NSMusicS client wave targeted for roughly mid-May 2026.
• Parallel client lines for React, React Native, Vue, and Angular.
• Electron and Web implementations for the refactored wave following the best-practice direction of each stack and its surrounding community.
• Continued evolution of the NineSong-backed client and cloud experience.
• Expansion of the cross-platform product line across Windows, macOS, iOS, Android, Linux, and later HarmonyOS scenarios.
• Deeper support for local libraries, private cloud music, and broader self-hosted media workflows.

Ecosystem Components

NSMusicS Electron

The desktop client currently covers:

• Windows
• macOS
• Linux
• Docker-oriented desktop and web-adjacent scenarios

Current status:

• This is the currently published open-source release line in this repository.
• This is the currently released transition client line.
• It remains the bridge release until the refactored React, React Native, Vue, and Angular client wave is published.
• Its Web mirror and Docker delivery remain important for the current transition period.

Current focus areas include:

• Music library management
• Compatibility with NineSong, Navidrome, Jellyfin, and Emby
• Local library playback
• Professional playback workflows
• Internationalization
• Background and tray playback

NineSong Server

NineSong is the server-side foundation paired with NSMusicS.
Compared with conventional music servers, its direction emphasizes:

• Richer music library management
• Stronger metadata and tag workflows
• Better music-focused search behavior
• Advanced playback scenarios such as CUE-related workflows
• Recommendation capabilities based on user data and metadata
• A broader long-term personal digital center architecture

Archived public-readme references:

• English reference: doc/NineSong_Open_Source_Reference.md
• Chinese reference: doc/NineSong_Open_Source_Reference.zh-CN.md

Important status note:

• The archived public NineSong README describes the open-source backend repository as a frozen public snapshot rather than a continuously updated open-source backend.

If you want detailed backend capabilities, deployment packages, or server-side roadmap context, refer to the NineSong repository directly:

• NineSong repository: https://github.com/Super-Badmen-Viper/NineSong
• NineSong releases: https://github.com/Super-Badmen-Viper/NineSong/releases/

NSMusicS Flutter

The Flutter product line represents the next major cross-platform client direction for:

• Android
• iOS
• Windows
• macOS

Important distribution note:

• The Windows app currently available on Microsoft Store belongs to this Flutter line.
• That Store package is the closed-source paid commercial edition, not the open-source build published from this repository.
• Its codebase, packaging, release rhythm, and store policy are separate from the open-source Electron/Web transition line here.

The current roadmap expects the refactored edition around two months later, with mobile store releases planned after the Windows track already in market.

Downloads

• Windows commercial Flutter edition: Microsoft Store Web Page
• Windows Store deep link: ms-windows-store://pdp/?productid=9N0RWS2TJXG1
• Open-source Electron releases: https://github.com/Super-Badmen-Viper/NSMusicS/releases
• Web mirror Docker image: https://hub.docker.com/r/xiangch007/nsmusics
• Legacy WPF release: https://github.com/Super-Badmen-Viper/NSMusicS_WPF/releases/tag/NSMusicS_Win(WPF)_0.9.0
• NineSong releases: https://github.com/Super-Badmen-Viper/NineSong/releases/

Screenshots

• NSMusicS Electron is under active development.
• Current preview set:

Version Matrix

Community

• QQ Group 1: full
• QQ Group 2: 610551734

Sponsorship

• Afdian: https://afdian.com/a/fu_zi_qian

Development

Run NSMusicS Electron

Detailed development references:

• English guide: doc/NSMusicS_Electron_Development.md
• Chinese guide: doc/NSMusicS_Electron_Development.zh-CN.md

cd NSMusicS\NSMusicS-Electron
# node -v 20.15.0
# npm -v 10.4.0
npm install
# or:
cnpm install

Install MPV separately for local desktop playback scenarios:

• MPV installation: https://mpv.io/installation/
• Windows unpack path: NSMusicS\NSMusicS-Electron\resources\mpv-x86_64-20241124
• macOS unpack path: NSMusicS\NSMusicS-Electron\resources\mpv-x86_64-20241124

If better-sqlite3 needs manual rebuild support:

cd NSMusicS/NSMusicS-Electron/node_modules/better-sqlite3
npm install electron-rebuild -D

For the full fallback paths, including the old manual binary replacement flow, use the development guides linked above.

Run the app:

cd NSMusicS\NSMusicS-Electron
npm run dev

Build the app:

cd NSMusicS\NSMusicS-Electron
npm run build

Related Projects And Dependencies

• Electron
• better-sqlite3
• howler.js
• MPV
• Node-MPV
• Vue3
• go-backend-clean-architecture
• node-taglib-sharp
• Naive UI
• feishin
• navidrome
• jellyfin
• emby

Attribution

Image resource attributions remain available in the repository and project assets.
For the current image list and historical dependency credits, see:

• doc/Historical_Attributions.md
• doc/Historical_Attributions.zh-CN.md

Vision

NSMusicS is still being independently developed and is still being refactored.
The long-term goal is to let more users access free, open-source, and user-friendly music products with stronger architecture, richer interoperability, and a broader ecosystem foundation.

The name NSMusicS comes from "Nine Song Music Super" and is inspired by Chu Ci and the legacy of Qu Yuan.