npshell np -- command line music queue manager

Keep a daemon running in the background. Add sounds to a queue. Let the daemon play the sweet music for you. All from the comfort of your own shell.

<p align="center"> <a href="https://github.com/joelpurra/npshell/"><img src="https://cloud.githubusercontent.com/assets/1398544/5836151/b8d8e31e-a171-11e4-8412-d23765b54a25.gif" alt="npshell in action" border="0" /></a> </p>

• Strictly command line based for extra nerd credits.
• Adds sounds from deep folder structures by default.
• Control music playback daemon from any terminal window.
• Displays song paths relative to $PWD.
• Optional system notifications displaying the path or id3v2 tags.
• Creates cached/index files to handle large sound libraries, useful on slow disks and network drives.
• Works on Mac OS X, Linux, and similar systems.

Installation

See INSTALL.md for Linux, other systems, and manual steps as well as how to enable notifications.

On Mac with Homebrew:

brew tap joelpurra/joelpurra
brew install npshell
brew services start npshell

Get started

See USAGE.md for the full list of command and configuration with examples.

Everyday usage, assuming np daemon has been started elsewhere:

cd Music/     # Go to a folder with some sounds.
np add 10     # Add 10 shuffled sounds from current folder hierarchy.
np next       # Play next sound.
np            # Display the currently playing sound.
np list       # List sounds in queue.
              # Add an album by folder path.
np add all in-order "Jazz/My Favorite Album/"

<details> <summary>Convenient aliases</summary>

Save a keystroke or two, at least until tab completion is... completed. Add to your ~/.bash_profile or similar autoexecuted file of your choice.

alias npa='np add'
alias npn='np next'
alias npl='np list'

</details>

---

Copyright (c) 2014, 2015, 2016, 2017 Joel Purra. Released under GNU General Public License version 3.0 (GPL-3.0).