Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mifi/hls-vod
HTTP Live Streaming with on-the-fly encoding of any video file for Web/Apple TV/iPhone/iPad/iPod
https://github.com/mifi/hls-vod
ffmpeg http ipad iphone live ondemand server streaming vlc
Last synced: 20 days ago
JSON representation
HTTP Live Streaming with on-the-fly encoding of any video file for Web/Apple TV/iPhone/iPad/iPod
- Host: GitHub
- URL: https://github.com/mifi/hls-vod
- Owner: mifi
- Created: 2012-12-02T22:40:24.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2023-12-09T14:01:56.000Z (about 1 year ago)
- Last Synced: 2024-05-23T00:24:02.896Z (7 months ago)
- Topics: ffmpeg, http, ipad, iphone, live, ondemand, server, streaming, vlc
- Language: JavaScript
- Homepage:
- Size: 4.72 MB
- Stars: 275
- Watchers: 19
- Forks: 70
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
- awesome-video - mifi/hls-vod - HTTP Live Streaming with on-the-fly encoding of any video file for Web/Apple TV/iPhone/iPad/iPod - mifi/hls-vod (HLS / Talks Presentations Podcasts)
README
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](http://www.mediaelementjs.com/)
`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](https://nodejs.org/en/) (Tested on >=4)
- [ffmpeg](https://ffmpeg.org/) (needs >=v1, must be built with libx264 and libmp3lame) OR [VLC](https://www.videolan.org/)
- 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).