mrkeyoor.com_
Tue 01 Sept 17:43 UTC
Webevaluationupdated 25 Aug 2026

kumone review

Kumone is an unofficial native client for NetEase Cloud Music on macOS, iPhone, and iPad. It talks directly to NetEase's services, plays a user's library and recommendations, shows synchronized lyrics, and can seek alternate sources when a track is unavailable. The README is in English with a Simplified Chinese translation, and the app interface supports both languages.

+184stars / 7d
Verdict

Kumone requires macOS 15+ or a self-signed iOS 16+ installation, so its polished Apple experience comes with a narrow platform and unofficial-service boundary. It is a good fit for committed NetEase listeners who understand sideloading and accept direct private-API use. Choose the official client or a broader cross-platform project if account stability, store distribution, or predictable service compatibility matters more.

We ran it

Screenshot of kumone (github.com/missuo/kumone)

Answers from our run

Did you run kumone yourself?

No. Its code is Swift, and it carries no manifest our lab installs from, and no Dockerfile, so there was nothing standard to install, build or test. This review is written from the repository's own documentation.

Who should not use kumone?

Windows, Linux, or Android users: the distributed clients require macOS 15+ or iOS 16+.

What are the alternatives to kumone?

YesPlayMusic, Sonimbus, LyricsX. Kumone requires macOS 15+ or a self-signed iOS 16+ installation, so its polished Apple experience comes with a narrow platform and unofficial-service boundary.

Setup3/5Easy signed Mac install; iOS requires repeated sideloading
Docs5/5Clear bilingual install, build, architecture, and update details
Community3/5Small audience with same-day releases and accepted contributions
Maturity3/5Broad client features at version 0.3.5, tied to private APIs

Who it’s for

NetEase Cloud Music listeners who want a native SwiftUI desktop client on macOS 15 or newer.
Apple users who value synced desktop lyrics, media-key support, and playback restoration.
iPhone or iPad users comfortable signing and reinstalling an unofficial IPA.
Swift developers studying a direct NetEase API client with playback, local account storage, and multi-platform UI code.

Who it’s NOT for

Windows, Linux, or Android users: the distributed clients require macOS 15+ or iOS 16+.
People without the official NetEase Cloud Music app for QR login: the README's login flow depends on scanning with that app.
iOS users unwilling to sideload and periodically re-sign an IPA: Kumone is absent from both the App Store and TestFlight, and only TrollStore gets in-app installation.
Teams that need an official, supported music service client: Kumone is unofficial and implements private NetEase request encryption directly.
Anyone uncomfortable with alternate-source track resolution: gray-track unblocking queries pyncmd, Kuwo, and Kugou sources.
Users seeking downloads or social features: the README explicitly says neither is included.

Setup reality

We did not run Kumone because our sandbox has no supported Swift ecosystem and the repository has no Dockerfile. The supplied lab block therefore contains no install, build, test, dependency, timing, or vulnerability result to report.

For macOS, the supported path is a Homebrew cask or a signed and notarized release archive. Building requires macOS 15+ and Xcode 26+. Login uses a QR code scanned in the NetEase Cloud Music app, after which cookies are stored locally and refreshed.

The iOS 16+ artifact is unsigned and must be signed with an Apple ID through AltStore, SideStore, Sideloadly, or Xcode. Updates normally mean downloading and reinstalling the IPA; only TrollStore can hand off an in-app update automatically.

Kumone is a native client for one specific music service

Kumone replaces NetEase Cloud Music's normal Apple clients with a SwiftUI application for macOS, iPhone, and iPad. It covers home recommendations, Personal FM, playlists, albums, artists, search, liked tracks, cloud disk, playback queues, and synchronized lyrics. On the Mac it also integrates media keys and Control Center, restores the queue after relaunch, and can keep one lyric line floating above other windows.

The project is narrow by design. macOS requires version 15 or newer, while the sideloaded mobile build supports iOS 16+. Login is not a generic username form: users scan a QR code with the official NetEase Cloud Music app, and Kumone stores and refreshes the resulting cookies locally. This is for people already inside that service, not a general local music player.

Direct NetEase calls remove a server and inherit its fragility

Requests go straight to music.163.com and interface.music.163.com. Kumone implements NetEase's weapi and eapi request encryption in Swift, so there is no third-party API server to deploy or trust with the account cookie. The repository describes about 50 API endpoints behind its client layer, covering discovery, libraries, playlists, and account actions.

That design also binds the app to private service behavior. Kumone is unofficial, and NetEase can change endpoints, encryption details, response shapes, or login policy without treating this client as a supported consumer. The code's unified track model tolerates two JSON shapes, which is practical evidence that responses already vary. Anyone using it should expect occasional breakage after a service-side change.

Gray-track unblocking raises a separate choice. When a NetEase track is unavailable or trial-only, Kumone can resolve audio through pyncmd, Kuwo, or Kugou sources. The README names UnblockNeteaseMusic as the reference for endpoint behavior and matching strategy. Some users will see that as the feature that makes the client worthwhile; others will reject the legal, policy, or provenance uncertainty and should leave the app alone.

What happened when we ran it

We did not run the repository because the lab has no supported Swift ecosystem and Kumone provides no Dockerfile. As a result, there are no measured installation seconds, dependency totals, build results, test counts, or vulnerability findings. A successful release or contributor claim cannot substitute for a sandbox result, so this review makes none.

The supported source build requires macOS 15+ and Xcode 26+. The README lists swift build, a packaging script that writes the application into .build/app, and another script that kills, repackages, and relaunches it. Those instructions are specific and short, but they depend on Apple's current SDK and cannot be reproduced in our Debian container.

macOS installation is ordinary, while iOS remains sideloaded

Mac users can install the Homebrew cask or download the release ZIP and drag the application into Applications. The app is signed with an Apple Developer ID, notarized, and updated through Sparkle. That is a much cleaner distribution story than most unofficial desktop clients, and it keeps routine updates inside the application.

Every release also includes an unsigned iOS 16+ IPA. Users must sign it with their own Apple ID through AltStore, SideStore, Sideloadly, or Xcode because Kumone is unavailable through the App Store and TestFlight. Normal updates require another download and reinstall with the same tool. TrollStore users get a special handoff that can install the new IPA, but plain sideloading cannot replace the app from within itself.

The mobile compatibility range carries UI differences. iOS 26 uses the system Liquid Glass tab-bar behavior, while iOS 16 through 25 receive a simulated glass bar. An open pull request on August 25, 2026, adds a fuller iPhone playback screen and says simulator and macOS builds passed, but physical-device interaction automation had not been run. That unchecked item matters for gesture-heavy playback UI.

The music experience is unusually complete for version 0.3.5

Release 0.3.5 arrived on August 25, 2026, the same day as the last repository push. It added Dock controls and shortcuts to the 6 most recent playback sources. It also added optional romanized Japanese lyrics, using NetEase data when present and offline system transcription for gaps. Fixes address a window that grew by the sidebar width and a hidden toolbar that left about 68 points of empty space.

Those notes show careful attention to native desktop behavior rather than a website placed in a window. AVPlayer handles playback, the interface follows English or Simplified Chinese system language, and the architecture separates API, models, playback, storage, design components, and feature screens. GitHub reported only 1 open item, a pull request, and 707 stars on August 25. The project is active, though still young by its 0.3.5 version.

The license does not make service rights disappear

The code is LGPL-3.0-only, with GPL text included alongside it. The README also says the project is for learning and personal use, assigns music data and rights to NetEase and the source platforms, and excludes downloading and social features. Redistributors should reconcile the software license with those stated content and service limits before packaging a fork.

For a NetEase subscriber on current Apple hardware, Kumone offers a coherent native client with desktop lyrics and direct account access. Its boundaries are equally clear: no Windows or Linux app, no store-delivered iOS build, and no official API contract. Those are sensible reasons to walk away, even if the interface itself is appealing.

Alternatives

ProjectWhat it isPick it when
YesPlayMusicA cross-platform NetEase Cloud Music client built with web technology.pick this instead when Windows or Linux support matters more than a native SwiftUI interface.
SonimbusA NetEase Cloud Music client made for Apple TV.pick this instead when the main listening screen is tvOS rather than a Mac, iPhone, or iPad.
LyricsXA macOS application focused on desktop lyrics for existing players.pick this instead when floating synchronized lyrics are the requirement and replacing the music client is unnecessary.

What people are saying

  1. [velocity-scout] missuo/kumone

Sources

  1. Kumone README
  2. Kumone 0.3.5 release
  3. iOS playback pull request

More web reviews

axios · super-productivity · Graphite · fastify · tabler · go-zero · the whole board →