HLS vod

HLS vod is server software that provides video uploading, transcoding, storage, and delivery. It can be used as the origin server for websites and APPs that provide video-on-demand services. It consists of two parts: the Web Server and the Transcoder, the former provides video access and API services, and the latter provides online video transcoding.

Web Server

It provides video access and API services.

Dependencies

OpenResty

Run

Before starting the Web Server, you need to start MongoDB and Redis and modify the corresponding configuration items in the config.lua file, so that the Web Server can correctly access the MongoDB and Redis services.

$ ./resolvers.sh
$ ./lua_ssl.sh
$ openresty -p . -c hls_vod.conf

Video Access

Video Cover: http[s]://<Server Netloc>/hls_vod/media/<Video ID>.jpg
HLS Playlist: http[s]://<Server Netloc>/hls_vod/media/<Video ID>_<Profile>.m3u8

HTTP APIs

Upload Raw Video

URL: http://<Server Hostname>:2981/hls_vod/api/upload/raw
Request Method: POST
Request Content-Type: multipart/form-data
HTTP Status: 200 means success
Response Content-Type: application/json
Response Body:

[
  {
    "id": "<Video ID>",
    "filename": "<Filename of Raw Video>"
  },
  ...
]

Download Raw Video

URL: http://<Server Hostname>:2981/hls_vod/api/download/raw
Request Method: GET
URL Parameters:

Name	Type	Description
id	string	Video ID

HTTP Status: 200 means success
Response Content-Type: application/octet-stream
Response Body: Binary Data Stream

Extract Video Cover

URL: http://<Server Hostname>:2981/hls_vod/api/extract_cover
Request Method: POST
Request Content-Type: application/x-www-form-urlencoded
Request Parameters:

Name	Type	Description
id	string	Video ID
ss	double	Timeline Position of the Cover (second) Optional Default: 0

HTTP Status: 202 means success
Response Content-Type: application/json
Response Body:

{
  "path": "<Resource Path of the Extracted Cover>"
}

Video Transcode

URL: http://<Server Hostname>:2981/hls_vod/api/transcode
Request Method: POST
Request Content-Type: application/x-www-form-urlencoded
Request Parameters:

Name	Type	Description
id	string	Video ID
profile	string	Profile Name
width/height	int	Width/Height of the Output Video (-1 means scaling in the aspect ratio) Optional Default: -1
logo_x/logo_y	int	Position of LOGO Watermark (0,0 means top left) Optional Default: 0
logo_w/logo_h	int	Width/Height of the LOGO Watermark (-1 means scaling in the aspect ratio) Optional Default: -1

HTTP Status: 202 means success
Response Content-Type: application/json
Response Body:

{
  "path": "<Resource Path of the Transcoded Video>"
}

Query Videos

URL: http://<Server Hostname>:2981/hls_vod/api/videos
Request Method: GET
URL Parameters:

Name	Type	Description
start/finish	double	Upload Time Range (Unix Timestamp) Optional
skip/limit	int	Parameters of Pagination Optional

HTTP Status: 200 means success
Response Content-Type: application/json
Response Body:

{
  "videos": [
    {
      "id": "<Video ID>",
      "date": <Upload Time (Unix Timestamp)>,
      "duration": <Video Duration (second)>,
      "raw_width": <Width of Raw Video>,
      "raw_height": <Height of Raw Video>,
      "raw_rotation": <Rotation Angle of Raw Video (degree)>,
      "profiles": [
        "<Profile Name>",
        ...
      ]
    },
    ...
  ],
  "total": <Total Number of Videos>
}

Query Video Meta-Data

URL: http://<Server Hostname>:2981/hls_vod/api/video_meta
Request Method: GET
URL Parameters:

Name	Type	Description
id	string	Video ID

HTTP Status: 200 means success
Response Content-Type: application/json
Response Body:

{
  "id": "<Video ID>",
  "date": <Upload Time (Unix Timestamp)>,
  "duration": <Video Duration (second)>,
  "raw_width": <Width of Raw Video>,
  "raw_height": <Height of Raw Video>,
  "raw_rotation": <Rotation Angle of Raw Video (degree)>,
  "profiles": [
    "<Profile Name>",
    ...
  ]
}

Remove Video

URL: http://<Server Hostname>:2981/hls_vod/api/remove_video
Request Method: POST
Request Content-Type: application/x-www-form-urlencoded
Request Parameters:

Name	Type	Description
id	string	Video ID

HTTP Status: 204 means success

Callbacks

HLS vod will call the callbacks set in config.lua when some specific events are completed, so that the upper business layer can respond to the changes in the video state. If the callback fails, the Web Server will repeat the callback every minute until it succeeds (up to 30 times).

raw_meta Callback

After the raw video is uploaded successfully, the Web Server will automatically request the Transcoder to parse the video. When the parsing is completed, this callback will be called to pass the meta-data of the video to the upper business layer. Then you can request extracting the video cover and transcoding the video in this callback.

Request Method: POST
Request Content-Type: application/x-www-form-urlencoded
Request Parameters:

Parsing Succeeded

Name	Type	Description
id	string	Video ID
format	string	Format of Raw Video
duration	double	Video Duration (second)
bit_rate	int	Bitrate of Raw Video
width	int	Width of Raw Video
height	int	Height of Raw Video
rotation	int	Rotation Angle of Raw Video (degree)

Parsing Failed

Name	Type	Description
id	string	Video ID
error	string	Error Description

HTTP Status: 200/204 means success

cover Callback

This callback will be called after the video cover extracting is completed.

Request Method: POST
Request Content-Type: application/x-www-form-urlencoded
Request Parameters:

Extracting Succeeded

Name	Type	Description
id	string	Video ID

Extracting Failed

Name	Type	Description
id	string	Video ID
error	string	Error Description

HTTP Status: 200/204 means success

transcode Callback

This callback will be called after the video transcoding is completed.

Request Method: POST
Request Content-Type: application/x-www-form-urlencoded
Request Parameters:

Transcoding Succeeded

Name	Type	Description
id	string	Video ID
profile	string	Profile Name

Transcoding Failed

Name	Type	Description
id	string	Video ID
profile	string	Profile Name
error	string	Error Description

HTTP Status: 200/204 means success

Transcoder

It provides the video parsing and transcoding services.

Dependencies

Python3
- redis-py
- m3u8
- requests
- ffmpeg-python

Install dependencies:

$ pip3 install -r requirements.txt

Run

$ python3 transcoder.py --help
usage: transcoder.py [-h] [--work_dir WORK_DIR] [--workers WORKERS] [--api_entry API_ENTRY] [--logo LOGO]

Start the transcoder service.

optional arguments:
  -h, --help            show this help message and exit
  --work_dir WORK_DIR   set the work directory (default: /tmp)
  --workers WORKERS     set the number of worker processes (default: CPUs x2)
  --api_entry API_ENTRY
                        set the entry of platform APIs (default: http://127.0.0.1:2981)
  --logo LOGO           set the path of logo file

About

HLS video-on-demand server

GNU General Public License v3.0

Languages

Language:Lua 67.6%Language:Python 21.4%Language:Shell 7.4%Language:JavaScript 3.6%

ufownl / hls_vod

HLS vod

Contents

Web Server

Dependencies

Run

Video Access

HTTP APIs

Upload Raw Video

Download Raw Video

Extract Video Cover

Video Transcode

Query Videos

Query Video Meta-Data

Remove Video

Callbacks

raw_meta Callback

cover Callback

transcode Callback

Transcoder

Dependencies

Run

About

Languages