Skip to content

mifi/hls-vod

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 

hls-vod 📺

HTTP Live Streaming with on-the-fly encoding of any video file for Apple TV, iPhone, iPad, iPod, Mac Safari and other devices that support HTTP Live Streaming. Also supports Android and normal desktop browsers through the use of mediaelement.js

hls-vod is a server application lets you stream your whole video collection on-demand, regardless of format, to your iOS devices, playable from Safari, working with AirPlay as well. It does this by invoking ffmpeg/VLC on the fly through the command line, and presenting a web based GUI for playback.

Version 1.0 is out with simpler usage 🎉

Requirements

  • node.js (Tested on >=4)
  • ffmpeg (needs >=v1, must be built with libx264 and libmp3lame) OR VLC
  • Tested on Linux and Mac, but it might work on Windows too.

Installation

npm i -g hls-vod

Running (with ffmpeg, default)

  • Make sure you have node.js and ffmpeg in PATH
  • hls-vod --root-path /path/to/my/videos
  • Or: hls-vod --transcoder-path /path/to/ffmpeg --root-path /path/to/my/videos
  • Browse to http://localhost:4040/

Running (with VLC)

  • Make sure you have node.js and VLC installed and in PATH
  • hls-vod --transcoder-type vlc --root-path /path/to/my/videos
  • Or: hls-vod --transcoder-type vlc --transcoder-path /usr/bin/vlc --root-path /path/to/my/videos
  • Browse to http://localhost:4040/

VLC or ffmpeg ?

hls-vod supports both VLC and ffmpeg as streaming backend. ffmpeg gives the best performance and best format/codec support, in my experience. Thumbs and audio is not implemented for VLC.

Arguments

--root-path PATH - Root path allowed to read files in. Defaults to current directory.

--cache-path PATH - Where to write transcoded video cache. Defaults to OS temp dir.

--transcoder-type vlc|ffmpeg - Defaults to ffmpeg.

--transcoder-path PATH - Will use ffmpeg or vlc in PATH if not specified.

For more arguments run it without arguments: hls-vod

Limitations

  • Currently only supports encoding one stream at a time (only one user at a time).