Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/joelpurra/npshell

Command line music queue manager. A music player from the comfort of your own shell.
https://github.com/joelpurra/npshell

command-line-interface daemon music-player music-playlist shell

Last synced: 11 days ago
JSON representation

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

Host: GitHub
URL: https://github.com/joelpurra/npshell
Owner: joelpurra
License: gpl-3.0
Created: 2014-11-26T21:43:03.000Z (almost 10 years ago)
Default Branch: master
Last Pushed: 2021-02-24T17:32:48.000Z (over 3 years ago)
Last Synced: 2024-10-12T14:31:07.672Z (27 days ago)
Topics: command-line-interface, daemon, music-player, music-playlist, shell
Language: Shell
Homepage: https://joelpurra.com/projects/npshell/
Size: 128 KB
Stars: 15
Watchers: 3
Forks: 0
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-starred - joelpurra/npshell - Command line music queue manager. A music player from the comfort of your own shell. (shell)

README

# [npshell `np` -- command line music queue manager](https://github.com/joelpurra/npshell/)

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.

- 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](INSTALL.md) as well as how to enable notifications.

On Mac with [Homebrew](https://brew.sh/):

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

## Get started

See [USAGE.md for the full list of command and configuration](USAGE.md) with examples.

Everyday usage, assuming `np daemon` has been started elsewhere:

```bash
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'
```

---