https://github.com/jordicenzano/transport-stream-online-segmenter
Transport stream web based HLS segmenter.
https://github.com/jordicenzano/transport-stream-online-segmenter
browser chunk hls hls-chunklist javascript lhls low-latency mpeg segmenter tcp-stream transport-stream video
Last synced: about 2 months ago
JSON representation
Transport stream web based HLS segmenter.
- Host: GitHub
- URL: https://github.com/jordicenzano/transport-stream-online-segmenter
- Owner: jordicenzano
- License: gpl-3.0
- Created: 2017-12-26T21:01:20.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-01-04T10:24:10.000Z (over 2 years ago)
- Last Synced: 2025-03-26T07:11:13.687Z (2 months ago)
- Topics: browser, chunk, hls, hls-chunklist, javascript, lhls, low-latency, mpeg, segmenter, tcp-stream, transport-stream, video
- Language: JavaScript
- Homepage: https://jordicenzano.github.io/transport-stream-online-segmenter/
- Size: 517 KB
- Stars: 37
- Watchers: 7
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# transport-stream-online-segmenter
This is a tool that allows you to create an HLS chunklist from any transport stream file.
For the online version all the process is done inside the browser, so the input TS file are NOT uploaded anywhere making segmentation process fast and secure.
Taking advantage of HLS v6 we can generate a byte range HLS chunklist that prevents you to modify / split your TS file.
You can also execute the same segmenter in the CLI (nodeJS), and then segment a live TS TCP stream or a local TS file, in this case the chunks can be generated and saved to the local disc.
If you segment a TS TCP stream you can activate LHLS segementation (see: [lhls-media-streaming](https://medium.com/@periscopecode/introducing-lhls-media-streaming-eb6212948bef)). See [note 1](#note-1) if you want to test LHLS.
# Usage in the browser
* Click here [online-segmenter](https://jordicenzano.github.io/transport-stream-online-segmenter/)
* Select the desired target duration and select a .ts file from your local computer (see [note 2](#note-2) to generate a file), or put a URL of any ts file (remember should have a proper CORS policy)
* The .ts file will be processed in YOUR browser and the resulting HLS v6 chunklist displayed
## Testing the results:
* Copy the resulting chunklist data in a file in the *same directory* where your .ts file is, for example `chunklist.m3u8`
* Use any HLS player to play the resulting manifest file `chunklist.m3u8`. For instance: [VLC](https://www.videolan.org/vlc/index.html) or `Safari`
* (optional) is more "fun" if you put a webserver in front of those files. For instance [node-static](https://github.com/cloudhead/node-static)
# Usage in the console to process files
* Use the following syntax (see [note 3](#note-3) on how to generate a TS stream):
```
./transport-stream-segmenter-cli.js /your_path/input.ts /your_path/chunklist.m3u8
```
You can execute `./transport-stream-segmenter-cli.js` (without arguments) to get help about accepted parameters
# Usage in the console to process TCP streams (live)
It provides a server TCP socket to ingest a TS TCP stream, and it generates a live EVENT or WINDOW chunklist, it also saves the chunk files indicating them as growing files, useful if you want to implement [LHLS](https://medium.com/@periscopecode/introducing-lhls-media-streaming-eb6212948bef) or reduce latency using chunked transfer. See Note 2 if you want to test it.
* Use the following syntax, see note 2 for testing:
```
./transport-stream-segmenter-tcp.js 9000 /tmp media_ out.m3u8 4 127.0.0.1 event
```
You can execute `./transport-stream-segmenter-tcp.js` (without arguments) to get help about accepted parameters
# Notes
## Note 1: testing LHLS
For LHLS you need a webserver that supports chunked transfer for growing files, see: [webserver-chunked-growingfiles](https://github.com/jordicenzano/webserver-chunked-growingfiles)
## Note 2: Generating a TS file
If you do not have any ts file you can generate one by using `ffmpeg`:
```
ffmpeg -f lavfi -re -i testsrc=duration=10:size=320x200:rate=30 \
-f lavfi -re -i sine=frequency=1000:duration=10:sample_rate=44100 \
-pix_fmt yuv420p -c:v libx264 -b:v 1000k -g 30 -x264opts "keyint=120:min-keyint=120:no-scenecut" -profile:v baseline -preset veryfast \
-c:a libfdk_aac -b:a 96k \
-f mpegts demo.ts
```
## Note 3: Generation a TS stream
Note 2: If you do not have any encoder able to generate a TS TCP stream, you can execute the following script included in this repo (it uses `ffmpeg` behind the scenes):
```
./test/scripts/videoTestToLiveTSTSCP.sh 1000 120 9000 127.0.0.1
```