Imported from nagi-studio/YesPlayMusic (
skills/ypm/SKILL.md). Install upstream withnpx skills add nagi-studio/YesPlayMusic --skill ypm. Copyright stays with the author.
ypm — YesPlayMusic remote control
ypm is the YesPlayMusic CLI. It talks to whichever player is running on this
machine (desktop GUI or terminal TUI) over a local socket; nothing here touches
the network or needs credentials.
Procedure
- Pick the subcommand:
status(what's playing),pause,resume,toggle,next,prev, orseek <seconds>for an absolute position. - Run it with
--jsonand answer from the parsed output — the output is the truth about player state:ypm status --json. - After a mutation, report it as done; run a follow-up
ypm status --jsononly when the user asked what is now playing.
Reference
- No player running: the command prints
没有运行中的播放器(GUI 或 TUI 都不在线)— relay that and suggest opening YesPlayMusic (GUI) or runningypm(TUI). Retrying without a player is a no-op. - Both players running:
--gui/--tuiforces the target; by default ypm picks the running one itself. ypm updateupgrades the ypm binary, not playback — run it only when the user asks to upgrade ypm.- For any flag not listed here,
ypm --helpis authoritative.