Skip to content

Command line music queue manager. A music player from the comfort of your own shell.

License

Notifications You must be signed in to change notification settings

joelpurra/npshell

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

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/"
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.

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