angrplayr

angrplayr

A music player for the console, in Node.

• Changes
• License

---

Installation

npm i -g angrplayr

angrplayr uses MPlayer under the hood, so you'll need that installed as well. This module will fail to install if you don't have mplayer in your path somewhere.

Important

angrplayr requires at least Node verson 6 and does not work on Windows.

Unfeatures

• No playlists
• No shuffle
• No streaming
• No video
• No GUI
• No remote control

Usage

angrplayr

This will open a file explorer in your terminal. Use arrows to find an audio file, and hit enter to play.

Keys:

• enter or space: immediately play selected file
• p: toggle paused/playing
• .: volume up
• ,: volume down
• ;: seek back
• ': seek forward

Config

angrplayr will read from a config file if it exists. The config file must be valid JSON at ~/.config/angrplayr.json.

Defaults:

~/.config/angrplayr.json

{
  "showHiddenFiles": false
}

Why?

I really love MOC, but I use a Mac sometimes and audio on Macs is a little weird.

I also love MPlayer, but it's a bit unfriendly sometimes.

angrplayr is meant to fit somewhere in between more full-featured audio programs like CMus and MOC and command-line clients like MPlayer and MPV. Most of the time I don't need playlists, streaming, remote control, or other features; I just want to play audio.

TODO

• Fix jumping tracks when changing selection in the middle of playing
• File browsing above cwd
• Colors in config
• Improve UI:
  • Fix progress bar jump at beginning of playback
  • Fix progress bar not showing up depending on size of terminal