LX Music Assistant

Problem It Addresses

lx-music-assistant helps users who already run LX Music Desktop control the local player from an AI agent. It does not replace music catalogs; it calls the OpenAPI service through an embedded CLI so the model can search, play, inspect status, adjust volume, and read local playlists. The desktop app must be installed and its open API on port 23330 enabled.

How the Skill Works

The skill converts natural-language requests into CLI calls and then verifies the outcome:
- Search / wake-up: search shows results in the player and wakes it; searchPlay starts playback directly.
- Smart playback: for well-known artists, it may recommend representative songs via searchPlay; for uncertain names, it searches first to reduce wrong matches.
- Playback control: supports pause, resume, previous, and next tracks, with status used to report state.
- Playlists: local playlist IDs can be retrieved with list; online playlists require an explicit source such as kw, kg, tx, wy, or mg.

Boundaries and Caveats

This skill depends on a local desktop environment and a running OpenAPI service, so it is not suitable when LX Music Desktop is absent or when a purely cloud-based music lookup is needed. A short delay of about 500ms before checking status helps avoid stale results. Volume has a known issue: if status reports volume=0, the user should drag the volume bar once to activate the parameter, because API changes may not take effect before activation.