See npshell np – command line music queue manager


The npshell daemon is designed to start upon login.

On Mac with Homebrew

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

On other systems

  • Clone the code then add a symlink to npshell/src/np to your path.
  • Add np daemon --is-running || ( np daemon & ) to your ~/.bash_profile or similar.
  • Requirements:
    • One of the music players afplay, mplayer, mpg123, mpg321, play in your $PATH.
    • fswatch, bash 4+, shuf (or brew prefixed gshuf), tac (or brew prefixed gtac) from coreutils.


The notification system is started separately.

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