// the find
guo-yu/player
a command line player, supports play mp3 both from uri and local stream.
A Node.js CLI and library for playing MP3 files from local paths or HTTP URLs, built on top of mplayer. The API is clean and event-driven — create a player, hand it a playlist, listen to events. Aimed at developers who need audio playback in a Node.js script or terminal tool.
The playlist + event model is genuinely usable: add songs on the fly, listen for playend to chain logic, handle errors without polling. The CLI wrapper is minimal and does what it says. Shipping both a programmatic API and a global CLI binary from the same package is the right call for this kind of tool. Examples directory covers enough real cases that you can copy-paste your way to a working prototype.
Last commit was December 2019 and it targets Node 0.12 and io.js 2.0 — both are well past end-of-life and this hasn't been touched since. It shells out to mplayer under the hood, which means Linux/macOS only and a hard system dependency that isn't documented in the README. No pause-resume state tracking in the API surface, and the shuffle/stream 'enable' options are mentioned but not explained anywhere. 262 stars over a decade with zero recent maintenance signals this is effectively abandoned.