Command line music queue manager
Shell Other
Latest commit 7e63d17 Dec 2, 2016 @joelpurra v1.3.1
Permalink
Failed to load latest commit information.
src v1.3.1 Dec 2, 2016
.gitignore Initial commit Oct 8, 2014
CONTRIBUTE.md
INSTALL.md Use HTTPS for links where possible Dec 2, 2016
LICENSE
README.md
USAGE.md

README.md

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.

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

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 Joel Purra. Released under GNU General Public License version 3.0 (GPL-3.0).