Manifest modifier

Manifest Modifier is a work-in-progress project to modify video manifests.

Why? Video is a bit complex. Some manifests won't run on some devices because of the frame rate, or the bitrate, or other tags that may affect playback.

The image above is a perfect example that describes am usual problem: some devices can't play 60fps video. In order to solve this situation, we can use manifest-modifier to rewrite the manifest right before sending it to the users.

There are two ways to use this project, either as a lib or a server. This project is dividied into two crates: manifest-filter and manifest-server. manifest-server is a server built on top of axum and m3u8-rs. It can be used without requiring advanced knowledge of the Rust programming language.

manifest-filter is the Rust code behind manifest-server. If you running your own server and can't use the manifest-server, no worries, you can use the same features by calling Rust code directly:

```rust use manifest_filter::Master; use std::io::Read;

let mut file = std::fs::File::open("manifests/master.m3u8").unwrap(); let mut content: Vec = Vec::new(); file.readtoend(&mut content).unwrap();

let (, masterplaylist) = m3u8rs::parsemasterplaylist(&content).unwrap(); let mut master = Master { playlist: masterplaylist, }; master.filter_fps(Some(30.0)); ```

The result should be something like this

```

EXTM3U

EXT-X-VERSION:4

EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio-aach-96",LANGUAGE="en",NAME="English",DEFAULT=YES,AUTOSELECT=YES,CHANNELS="2"

EXT-X-STREAM-INF:BANDWIDTH=600000,AVERAGE-BANDWIDTH=600000,CODECS="mp4a.40.5,avc1.64001F",RESOLUTION=384x216,FRAME-RATE=30,AUDIO="audio-aach-96",CLOSED-CAPTIONS=NONE

variant-audio_1=96000-video=249984.m3u8

EXT-X-STREAM-INF:BANDWIDTH=800000,AVERAGE-BANDWIDTH=800000,CODECS="mp4a.40.5,avc1.64001F",RESOLUTION=768x432,FRAME-RATE=30,AUDIO="audio-aach-96",CLOSED-CAPTIONS=NONE

variant-audio_1=96000-video=1320960.m3u8 ```

Installation

The binary for manifest-server is manifest_server

You must have cargo to install the manifest server:

$ cargo install manifest-server`

There is no other way to install the server right now.

Usage

For the server to work, you need to export a variable LISTEN_ADDRESS

$ LISTEN_ADDRESS=127.0.0.1:3000 manifest_server`

Features

Master playlist

Bandwidth - filter variants based on min and max values.

Request:

curl --request POST \ --url 'http://localhost:3000/master?min_bitrate=800000&max_bitrate=2000000' \ --header 'content-type: text/html; charset=UTF-8' \ --header 'user-agent: vscode-restclient' \ --data '< ../manifest-filter/manifests/master.m3u8'

Response:

```

EXTM3U

EXT-X-VERSION:4

EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio-aach-96",LANGUAGE="en",NAME="English",DEFAULT=YES,AUTOSELECT=YES,CHANNELS="2"

EXT-X-STREAM-INF:BANDWIDTH=800000,AVERAGE-BANDWIDTH=800000,CODECS="mp4a.40.5,avc1.64001F",RESOLUTION=768x432,FRAME-RATE=30,AUDIO="audio-aach-96",CLOSED-CAPTIONS=NONE

variant-audio_1=96000-video=1320960.m3u8

EXT-X-STREAM-INF:BANDWIDTH=1500000,AVERAGE-BANDWIDTH=1500000,CODECS="mp4a.40.5,avc1.64001F",RESOLUTION=1280x720,FRAME-RATE=60,AUDIO="audio-aach-96",CLOSED-CAPTIONS=NONE

variant-audio_1=96000-video=3092992.m3u8

EXT-X-STREAM-INF:BANDWIDTH=2000000,AVERAGE-BANDWIDTH=2000000,CODECS="mp4a.40.5,avc1.640029",RESOLUTION=1920x1080,FRAME-RATE=60,AUDIO="audio-aach-96",CLOSED-CAPTIONS=NONE

variant-audio_1=96000-video=4686976.m3u8 ```

Frame rate - filter variants based on a predefined fps:

Request:

curl --request POST \ --url 'http://localhost:3000/master?rate=60' \ --header 'content-type: text/html; charset=UTF-8' \ --header 'user-agent: vscode-restclient' \ --data '< ../manifest-filter/manifests/master.m3u8'

Response:

```

EXTM3U

EXT-X-VERSION:4

EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio-aach-96",LANGUAGE="en",NAME="English",DEFAULT=YES,AUTOSELECT=YES,CHANNELS="2"

EXT-X-STREAM-INF:BANDWIDTH=1500000,AVERAGE-BANDWIDTH=1500000,CODECS="mp4a.40.5,avc1.64001F",RESOLUTION=1280x720,FRAME-RATE=60,AUDIO="audio-aach-96",CLOSED-CAPTIONS=NONE

variant-audio_1=96000-video=3092992.m3u8

EXT-X-STREAM-INF:BANDWIDTH=2000000,AVERAGE-BANDWIDTH=2000000,CODECS="mp4a.40.5,avc1.640029",RESOLUTION=1920x1080,FRAME-RATE=60,AUDIO="audio-aach-96",CLOSED-CAPTIONS=NONE

variant-audio_1=96000-video=4686976.m3u8 ```

Media playlist

DVR - remove segments (backwards) based on the duration (seconds)

curl --request POST \ --url 'http://localhost:3000/media?dvr=15' \ --header 'content-type: text/html; charset=UTF-8' \ --header 'user-agent: vscode-restclient' \ --data '< ../manifest-filter/manifests/media.m3u8'

Response:

```

EXTM3U

EXT-X-VERSION:4

EXT-X-INDEPENDENT-SEGMENTS

EXT-X-TARGETDURATION:8

EXT-X-MEDIA-SEQUENCE:320035373

EXTINF:5, no desc

variant-audio_1=96000-video=249984-320035703.ts

EXTINF:5, no desc

variant-audio_1=96000-video=249984-320035702.ts

EXT-X-PROGRAM-DATE-TIME:2020-09-15T14:01:39.133333+00:00

EXT-X-CUE-IN

EXTINF:5.8666, no desc

variant-audio_1=96000-video=249984-320035701.ts ```

Tests

cargo test

Lint

cargo clippy