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.

npshell in action

  • 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.


See 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 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/"
Convenient aliases Save a keystroke or two, at least until tab completion is... completed. Add to your `~/.bash_profile` or similar autoexecuted file of your choice. ```bash alias npa='np add' alias npn='np next' alias npl='np list' ```

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