http-music

http-music's code is no longer updated on GitHub

Please check out https://git.ed1.club/florrie/http-music.git instead.

---

A command line program that lets you download music from places (like the internet, or your hard drive) and play it. It's also decently powerful.

Installation

$ git clone https://github.com/towerofnix/http-music
$ cd http-music
$ npm install

# Installs http-music GLOBALLY, i.e., so you can use from in any directory.
$ npm link # (You might need sudo here.)

# (Hey, you! That one person who only reads the install code! Please also
# read the "you will also need" section below.)

You will also need:

• A player: play (from SoX) and mpv both work. You'll only need one of these, but mpv gives you access to play/pause and seeking controls.

• A sound converter: either avconv or ffmpeg will work.

• Optionally, youtube-dl lets you play music from just about anywhere (rather than just http://blah/foo.mp3-like URLs!).

There's a fair chance you already have some of these installed; you can always check from your terminal using the type command!

Usage

# Generate a playlist file, using the handy interactive setup utility..
$ http-music setup

# ..or one of these shell commands:
$ http-music crawl-http http://some.directory.listing.server/ > playlist.json
$ http-music crawl-local ~/Music/ > playlist.json

# Then play it:
$ http-music play

# (You can use `python3 -m http.server` or `python2 -m SimpleHTTPServer` to
# run a quick and easy directory listing, to pass into crawl-http!)

Screenshots

Super-basic usage (http-music play):

Load music from the file system (http-music crawl-local . > playlist.json):

Load music from an HTTP server (http-music crawl-http http://some.directory.listing):

Filter by a specific group (http-music play --clear --keep 'C418/one'):

(A shorthand also works! Try http-music play -c -k C418/one.)

Visually look at the longest tracks in a playlist:

Documentation

Check out the man pages. (Or view them with man http-music.)