Accept cookies for analytics, social media, and advertising, or learn more and adjust your preferences. These cookies are on by default for visitors outside the UK and EEA. Privacy Notice.
This NGINX module generates audio track for hls streams on the fly.
Available on GitHub
Apple HTTP Live Streaming (HLS) has being adopted for almost all video stream players, and one of their recommendations is to serve an audio-only track to users that have experiencing bad bandwidth connections.
This module aims to serve audio-only track directly on NGINX, without the necessity to pre-demux the stream on Video On Demand (VoD) scenarios or the overhead and occupation of one stream output on the encoder side for live streams.
Using a combination of NGINX locations with simple scripts written in Lua and this module, it’s possible to generate the entire audio track on NGINX. Look at how things are done.
A viewer requests the master playlist, and the response is modified. A simple lua script gets the first stream of the list and add an audio-playlist at the end:
location ~ /master-playlist.m3u8$ {
rewrite (.*)master-playlist.m3u8$ $1playlist.m3u8 break;
content_by_lua '
local res = ngx.location.capture(ngx.var.uri);
local first_playlist = res.body:match("[^\\n]*m3u8")
local audio_playlist = first_playlist:gsub("\.m3u8", "-audio.m3u8")
local ext_inf = "#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=64000\\n"
ngx.print(res.body)
ngx.print(ext_inf)
ngx.print(audio_playlist)
ngx.print("\\n")
';
}
Then, when user’s connection goes bad and he needs to go to the audio target, another location will handle the request, getting the original (video) playlist and changing the extension of the chunks:
location ~ -audio\.m3u8$ {
default_type application/vnd.apple.mpegurl;
content_by_lua '
local base_m3u8_url = ngx.var.uri:gsub("-audio.m3u8", ".m3u8")
local res = ngx.location.capture(base_m3u8_url)
local new_body = res.body:gsub("\.ts", ".aac")
ngx.print(new_body)
';
}
Every request for .aac
extensions will invoke audio extract module:
location ~ (\.aac)$ {
ngx_hls_audio_track;
ngx_hls_audio_track_rootpath "/path/were/video/chunks/are/";
expires 10m;
}
That’s it!
This module is under heavy development. Feedbacks, issues and patches are welcome.
This module depends from some libraries (headers and shared objects) which has to be installed before it, all are commonly distributed with FFmpeg:
For now, the audio extractor module only supports extraction from mpegts
video chunks to aac
audio-only chunks.
Look at project issues to see which other formats are going to be supported in the future.
Follow the steps:
Clone this project
$ git clone git://github.com/flavioribeiro/nginx-audio-track-for-hls-module.git
Clone Lua module
$ git clone git://github.com/chaoslawful/lua-nginx-module.git
Download NGINX and compile it using both modules:
$ ./configure --add-module=/path/to/nginx-audio-track-for-hls-module --add-module=/path/to/lua-nginx-module
$ make install
Now you can look at our NGINX configuration example and make your changes. Have fun!
Warning
It’s highly recommended to use caching in all locations of HLS, in special the one that returns the generated .aac
.