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 March 22, 2026:

The latest Windows release is already live on Microsoft Store.
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 refactored edition of this project is expected around two months later, which currently points to roughly May 2026.
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 newest production-facing build first, start from Microsoft Store.
If you want to follow the architecture, roadmap, and ecosystem direction, this repository remains the main workspace entry point.

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:

A refactored NSMusicS edition expected around two months later.
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 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

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 production release: Microsoft Store Web Page
Windows Store deep link: ms-windows-store://pdp/?productid=9N0RWS2TJXG1
Electron releases: https://github.com/Super-Badmen-Viper/NSMusicS/releases
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

| Project | Status | Stack | Platforms | License | | --- | --- | --- | --- | --- | | NSMusicS Desktop and Docker | Updating | Electron, Node.js, Vue, TypeScript, SQLite, Docker | Windows, Linux, Docker, macOS | AGPL-3.0 with commercial-use restrictions noted in project docs | | NineSong | Frozen public snapshot | Go, MongoDB, Gin, JWT, SQLite, Docker | Docker | AGPL-3.0 with commercial-use restrictions noted in project docs | | NineSongAI | Updating | Java, MongoDB, Spring Boot, MySQL, Docker | Docker | AGPL-3.0 with commercial-use restrictions noted in project docs | | NineSongPro | Updating | Java, MongoDB, Spring Cloud Alibaba, MySQL, Docker | Docker | AGPL-3.0 with commercial-use restrictions noted in project docs | | NSMusicS For Flutter | Updating | Flutter, Dart | Android, iOS, Windows, macOS | AGPL-3.0 with commercial-use restrictions noted in project docs | | NSMusicS For HarmonyOS | Planned | ArkTS, ArkUI | HarmonyOS | AGPL-3.0 with commercial-use restrictions noted in project docs | | NSMusicS For Audio | Planned | PyTorch, Python, Jupyter, MATLAB | Docker | AGPL-3.0 with commercial-use restrictions noted in project docs | | NSMusicS For Knowledge Graph | Planned | NebulaGraph or Neo4j | Docker | AGPL-3.0 with commercial-use restrictions noted in project docs | | NSMusicS WPF | Needs refactor | .NET, C#, SQLite | Windows | AGPL-3.0 with commercial-use restrictions noted in project docs |

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

Attribution

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

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 str

NSMusicS

Install / Use

README