qiaomu-music-player-ncm

Control NetEase Cloud Music playback and generate music recommendations via ncm-cli.

2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/augustscl/awesome-xiawang-skills --skill qiaomu-music-player-ncm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qiaomu-music-player-ncm
Source: https://github.com/augustscl/awesome-xiawang-skills/tree/main/qiaomu-music-player-ncm
Command: npx skills add https://github.com/augustscl/awesome-xiawang-skills --skill qiaomu-music-player-ncm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a unified, conversational interface to control NetEase Cloud Music playback, discover songs, and get personalized recommendations so users don't need to manually manage search, playback, lyrics, or scheduling across multiple tools.

Core Features & Use Cases

  • Playback control: play, pause, next/prev, seek, volume and state inspection via ncm-cli and a local player.
  • Search & queue management: search songs/albums/playlists (Chinese keywords supported), add to queue, insert next, and clear queue.
  • NetEase-specific recommendations: daily recommend, heartbeat (心动模式), FM, radar playlists, and bulk filtering for playable tracks.
  • Preference analysis & intelligent recommendations: analyze red-heart playlist to build time/content preference profiles and produce scored, two-layer recommendation reasons.
  • Scene & genre exploration: map Chinese scene descriptions to precise search keywords and enhance with a large RateYourMusic-derived genre database.
  • Scheduling & automation: configure timed pushes (cron), persist schedule and history files for repeatable deliveries.
  • Safety & checks: enforces playback eligibility (visible, plLevel, freeTrialFlag) and content safety checks before executing actions.

Quick Start

Tell the skill a playback intent such as play a mood ("play deep-night folk") or play daily recommendations to start playback and preference analysis.

Frequently Asked Questions about qiaomu-music-player-ncm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control NetEase Cloud Music playback through a command line interface?

NetEase Cloud Music playback control via a CLI lets you manage play, pause, seek, and volume. Using ncm-cli with a local player like mpv, you can execute these commands and inspect playback state directly from your terminal.

Can I search for Chinese songs and manage my music queue using ncm-cli?

Yes, searching for Chinese songs and managing your queue is fully supported. You can search for tracks, albums, and playlists with Chinese keywords, then add results to your queue, insert tracks to play next, or clear the queue.

How does intelligent music recommendation work for liked NetEase tracks?

Intelligent music recommendation analyzes your liked red-heart playlist to build time and content preference profiles. It then produces scored recommendations with two-layer reasons, mapping Chinese scene descriptions to precise search keywords using a genre database.

Do I need Node.js and mpv installed to use NetEase Cloud Music CLI tools?

You need Node.js version 18 or higher and ncm-cli configured with NetEase API keys. A local player like mpv is optional but required for local playback, while the system enforces visibility and plLevel checks for track eligibility.

Can I schedule timed music pushes and automate daily NetEase recommendations?

Yes, you can configure timed pushes using cron scheduling. The system persists schedule and history files for repeatable deliveries, allowing you to automate daily NetEase recommendations, heartbeat mode, FM, and radar playlists.

What playback eligibility checks are enforced for NetEase Cloud Music tracks?

Playback eligibility checks enforce track visibility, plLevel, and freeTrialFlag before executing actions. The system also performs content safety checks to ensure only playable, eligible tracks are processed for queueing and recommendation filtering.