node package manager


Video streaming demo


Streams data from a file-like seekable object into a <video> or <audio> node (a HTMLMediaElement). Seeking the media element will request a different byte range from the incoming file-like object.

For now only mp4 files are supported. The goal is to support most files that conform to ISO/IEC 14496-12.

Version 2 is completely rewritten and substantially more robust than the previous version that relied on mp4box.js. The only major regression compared to the previous architecture is that fragmented mp4 files aren't supported. If this is a problem I may add support again at some point.

Support for most other formats will take significant work.


Videostream just exports a function. Use it like this:

var exampleFile = {
    createReadStream: function (opts) {
        var start = opts.start;
        var end = opts.end;
        // Return a readable stream that provides the bytes 
        // between offsets "start" and "end" inclusive 
var VideoStream = require('videostream');
var elem = document.createElement('video');
var videostream = VideoStream(exampleFile, elem);
elem.addEventListener('error', function () {
  // listen for errors on the video/audio element directly 
  var errorCode = elem.error
  var detailedError = videostream.detailedError
  // videostream.detailedError will often have a more detailed error message 


Handle errors by listening to the 'error' event on the <video> or <audio> tag.

Some (but not all) errors will also cause videostream.detailedError to be set to an error value that has a more informative error message.


MIT. Copyright (c) John Hiesey.