node package manager



A simple http server and file browser with html5 video player to watch your video collection either remotely or on your home network from any browser. Use it to watch media files stored on you PC via a browser on your smart TV or blu-ray player. Or open up your home firewall and access your media remotely.

Any files already compatible with html5 video will be streamed to the client via the 'node-static' module. If a file is not compatible with html5 video it will be transcodeed on the fly using ffmpeg and the result is streamed to the client. ffmpeg is auto installed as part of npm-install so everything works out of the box!

Getting started

  • Install node.js
  • Install npm package globally npm -g install vid-server
  • Go to the folder you want to serve
  • Run the server vid-server


-p, --port <n>  the port to listen to for incoming HTTP connections


desktop screen mobile screen video screen

Known Issues

  • Seek wont work when transcoding with ffmpeg and streaming. (Good luck getting that working!)


  • Can I use this project in production environments? Go for it!
  • Can this server run php, ruby, python or any other cgi script? No.
  • Is this server ready to receive thousands of requests? absolutely!.