dyoung2019 / mkv2hls

Converts mkv videos to hls video format

mkv2hls - MKV Video to HLS conversion

Batch operation to convert .mkv file to HLS video format (based on Peer 5 guide)

Usage: mkv2hls -i <video_file> [args]

Commands:
  mkv2hls -i  converts file1.mkv into hls video parts

Options:
  -i, --input    .mkv file for conversion                             [required]
  -o, --output   output folder for conversion
  -h, --help     Show help                                             [boolean]
  -v, --version  Show version number                                   [boolean]

Installation

Pre-install

1. Install ffmpeg with aac audio support (e.g. homebrew-ffmpeg via homebrew )

   brew install ffmpeg
   brew tap homebrew-ffmpeg/ffmpeg
   brew install homebrew-ffmpeg/ffmpeg/ffmpeg --with-fdk-aac

2. Install MkvtoolNix for mkvmerge CLI application

   brew install mkvtoolnix
   

Post-install

1. Downloads test5.mkv from Matroska test files from github

Processes

1. Analyzes mkv container file for tracks and subtitles
2. Converts video file to HLS via ffmpeg into:
   • m3u8 playlist
   • video parts split in chunks for each rendition
   • split audio tracks in chunks
   • subtitle parts split in chunks
3. Write master playlist
   1. file tag
   2. for each all audio tracks
   3. for each subtitle track
   4. for each rendition

Links

• Creating a Production Ready Multi Bitrate HLS VOD stream

  • https://docs.peer5.com/guides/production-ready-hls-vod/

• misc/create-vod-hls.sh bash script

  • https://gist.github.com/mrbar42/ae111731906f958b396f30906004b3fa

• Subtitles, Captions, WebVTT, HLS, and those magic flags

  • https://mux.com/blog/subtitles-captions-webvtt-hls-and-those-magic-flags/

• MKVToolNix – Matroska tools for Linux/Unix and Windows

  • https://mkvtoolnix.download/

• Apple Streaming Examples

  • https://developer.apple.com/streaming/examples/

• HLS authoring rules for Apple Devices

  • https://developer.apple.com/documentation/http_live_streaming/hls_authoring_specification_for_apple_devices