https://github.com/monyone/biim
LL-HLS implementation written in Python3
https://github.com/monyone/biim
hls ll-hls llhls low-latency low-latency-hls m3u8 mpegts
Last synced: 5 months ago
JSON representation
LL-HLS implementation written in Python3
- Host: GitHub
- URL: https://github.com/monyone/biim
- Owner: monyone
- License: mit
- Created: 2022-04-06T15:16:21.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-17T01:58:58.000Z (6 months ago)
- Last Synced: 2024-12-10T05:41:43.435Z (5 months ago)
- Topics: hls, ll-hls, llhls, low-latency, low-latency-hls, m3u8, mpegts
- Language: Python
- Homepage:
- Size: 184 KB
- Stars: 47
- Watchers: 6
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# biim
An example for Apple Low Lantency HLS Packager and Origin
## Feature
* MPEG-TS Demuxing and Apple LL-HLS Packaging in pure Python3 (using asyncio)
* Packaging MPEG-TS stream to HLS media segment (MPEG-TS or fmp4)
* `main.py`: Packaging MPEG-TS stream to MPEG-TS segment (for H.264/AVC, AAC, ID3)
* Support TIMED-ID3 Metadata PassThrough
* `fmp4.py`: Packaging MPEG-TS stream to fmp4 segment (for H.265/HEVC, AAC, ID3)
* Support TIMED-ID3 Metadata to EMSG-ID3 Conversion
* Support LL-HLS Feature (1s Latency with HTTP/2, 2s Latency with HTTP/1.1)
* Support Blocking Request
* Support EXT-X-PRELOAD-HINT with Chunked Transfer
* NOTE: HTTP/2 is currently not Supported. If use with HTTP/2, please proxing HTTP/2 to HTTP/1.1.
* In Memory (On the fly) LL-HLS Serving
* Not use disk space for LL-HLS Delivery
## Dependency
* aiohttp
## Usege
Ingest MPEG-TS Stream to biim's STDIN!
```bash
# mpegts (for H.264)
ffmpeg xxx -f mpegts - | ./main.py --port 8080
# fmp4 (for H.264/H.265)
ffmpeg xxx -f mpegts - | ./fmp4.py --port 8080
# watch http://localhost:8080/playlist.m3u8
```
### Options
* `-i`, `--input`,
* Specify input source.
* if not Specified, use STDIN.
* if Specified file, throttled for pseudo live serving.
* DEFAULT: STDIN
* `-t`, `--target_duration`
* Specify minmum TARGETDURATION for LL-HLS
* DEFAULT: 1
* `-p`, `--part_duration`
* Specify PART-TARGET for LL-HLS
* DEFAULT: 0.1
* `-w`, `--window_size`
* Specify Live Window for LL-HLS
* if Not Specifed, window size is Infinify, for EVENT(DVR).
* DEFAULT: Infinity (None)
* `--port`
* Specify Serving PORT for LL-HLS
* DEFAULT: 8080
### Example (Generate Test Stream H.265(libx265)/AAC With Timestamp)
```bash
ffmpeg -re \
-f lavfi -i testsrc=700x180:r=30000/1001 \
-f lavfi -i sine=frequency=1000 \
-vf "settb=AVTB,setpts='trunc(PTS/1K)*1K+st(1,trunc(RTCTIME/1K))-1K*trunc(ld(1)/1K)',drawtext=fontsize=60:fontcolor=black:text='%{localtime}.%{eif\:1M*t-1K*trunc(t*1K)\:d\:3}'" \
-c:v libx265 -tune zerolatency -preset ultrafast -r 30 -g 15 -pix_fmt yuv420p \
-c:a aac -ac 1 -ar 48000 \
-f mpegts - | ./fmp4.py -t 1 -p 0.15 -w 10 --port 8080
# watch http://localhost:8080/playlist.m3u8
```
## Special Thanks
* [xtne6f](https://github.com/xtne6f): C++ ReImplementation ([tsmemseg](https://github.com/xtne6f/tsmemseg)) and Report ISOBMFF related misc bugs.
* [tsukumi](https://github.com/tsukumijima): Very helpful advice and implementation to biim's Type Definition.