https://github.com/makandra/validate-hls
Smoke test for HLS stream integrity
https://github.com/makandra/validate-hls
hls validator
Last synced: 7 months ago
JSON representation
Smoke test for HLS stream integrity
- Host: GitHub
- URL: https://github.com/makandra/validate-hls
- Owner: makandra
- License: mit
- Created: 2017-04-12T15:59:10.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2017-04-26T15:05:02.000Z (about 8 years ago)
- Last Synced: 2024-08-07T23:57:25.289Z (10 months ago)
- Topics: hls, validator
- Language: Ruby
- Homepage:
- Size: 6.84 KB
- Stars: 11
- Watchers: 7
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Validate HLS streams
====================
This script checks a HLS playlist for the following:
- Whether all `.ts` fragments can be downloaded for all quality levels
- Whether all `.ts` fragments have video frames
- Whether all `.ts` fragments start with a keyframe
These are just the issues that we check for. There are other things that can go wrong with a HLS stream.
Note that **we do not actively maintain this script**. You will need to fix any issues yourself.
Setup
-----
- Install `ffmpeg`
- Install `wget`
- Install Ruby 2+
- Clone this repo to get the script
Usage
------
```
ruby validate-hls.rb "http://host/path/playlist.m3u8"
```
This will download, validate and print results for each `.m3u8` and `.ts` URL.
The URL can point to either a playlist of `.ts` files, or to a master playlist of multiple quality playlists.
You can also pass more than one playlist URL as multiple arguments to `validate-hls.rb`, in which case all URLs will be validated.
The script returns an error code if there was at least one validation error.
Credits
-------
Henning Koch ([@triskweline](https://twitter.com/triskweline)) from [makandra](https://makandra.com).