Requires | Install | Usage | Output | SCTE-35 | AES Decrypt | Super Kabuki
M3uFu
The Most Advanced M3U8 Parser Available.
Latest Version v0.0.97
Features:
- All HLS Tags are Supported.
- Private / Custom Tags are Supported.
- Master Playlists are Supported.
- HTTP(S), Multicast,UDP, and File Source URIs are Supported.
- Full 2023r1 SCTE-35 Support.
- Base64, Bytes, and Hex formated SCTE-35 Cues are Supported.
- Automatic Decryption of AES Encrypted Segments.
- Desegmentation. Playlist Segments can be Reassembled into a Single Mpegts File.
Requires:
- python3.6+ or pypy3
Install:
python3 -mpip install m3ufu
# and/or
pypy3 -mpip install m3ufu
Usage:
usage: m3ufu [-h] [-i INPUT] [-o OUTFILE] [-v] [-d]
optional arguments:
-h, --help show this help message and exit
-i INPUT, --input INPUT
Input source, like "/home/a/vid.ts" or
"udp://@235.35.3.5:3535" or "https://futzu.com/xaa.ts"
-o OUTFILE, --outfile OUTFILE
download and reassemble segments and write to outfile.
SCTE35 cues are written to sidecar.txt
-v, --version Show version
-d, --debug Enable debug output.
Automatic AES Decryption
- When m3ufu detects AES-128, it automatically decrypts the segment
- This is used:
- to read PTS from the segment
- desegmenting a playlist and combining them into a single mpegts file
- This is used:
Output:
- Returns JSON
{
"headers": {
"#EXTM3U": "",
"#EXT-X-VERSION": "3",
"#EXT-X-TARGETDURATION": "12",
"#EXT-X-MEDIA-SEQUENCE": "1",
"#EXT-X-PLAYLIST-TYPE": "VOD"
},
"media": [
{
"media": "file_60p_1_00001.ts",
"end": 10.0,
"duration": 10.0,
"tags": {
"#EXTINF": 10.0
}
},
SCTE-35
- SCTE-35 Cues are parsed and the data is included
{
"media": "seg70.ts",
"start": 147.157,
"end": 148.058,
"duration": 0.901,
"cue": "/DAlAAAAAAAAAAAAFAUAAABXf+//iNg15n4Ae97wAAECAQAAtBIorQ==",
"cue_data": {
"info_section": {
"table_id": "0xfc",
"section_syntax_indicator": false,
"private": false,
"sap_type": "0x3",
"sap_details": "No Sap Type",
"section_length": 37,
"protocol_version": 0,
"encrypted_packet": false,
"encryption_algorithm": 0,
"pts_adjustment_ticks": 0,
"pts_adjustment": 0.0,
"cw_index": "0x0",
"tier": "0x0",
"splice_command_length": 20,
"splice_command_type": 5,
"descriptor_loop_length": 0,
"crc": "0xb41228ad"
},
"command": {
"command_length": 20,
"command_type": 5,
"name": "Splice Insert",
"time_specified_flag": true,
"pts_time": 73231.536067,
"pts_time_ticks": 6590838246,
"break_auto_return": false,
"break_duration": 90.2,
"break_duration_ticks": 8118000,
"splice_event_id": 87,
"splice_event_cancel_indicator": false,
"out_of_network_indicator": true,
"program_splice_flag": true,
"duration_flag": true,
"splice_immediate_flag": false,
"unique_program_id": 1,
"avail_num": 2,
"avail_expected": 1
},
"descriptors": []
},
"tags": {
"#EXT-X-SCTE35": {
"CUE-OUT": "YES",
"CUE": "/DAlAAAAAAAAAAAAFAUAAABXf+//iNg15n4Ae97wAAECAQAAtBIorQ=="
},
"#EXTINF": 0.901
}
},
....
Master Playlists are also Supported
a@fumatica:~/m3u8fu$ pypy3 m3ufu.py ../threefive/master.m3u8
{
"headers": {
"#EXTM3U": "",
"#EXT-X-INDEPENDENT-SEGMENTS": "",
"#EXT-X-VERSION": "7"
},
"media": [
{
"media": "media-4/stream.m3u8",
"tags": {
"#EXT-X-MEDIA": {
"AUTOSELECT": "YES",
"DEFAULT": "YES",
"LANGUAGE": "en",
"NAME": "CC1",
"GROUP-ID": "text",
"INSTREAM-ID": "CC1",
"TYPE": "CLOSED-CAPTIONS"
},
"#EXT-X-STREAM-INF": {
"CLOSED-CAPTIONS": "text",
"RESOLUTION": "768x432",
"CODECS": "avc1.4D401F,mp4a.40.2",
"BANDWIDTH": 2127786,
"AVERAGE-BANDWIDTH": 2030321
}
}
},
{
"media": "media-1/stream.m3u8",
"tags": {
"#EXT-X-STREAM-INF": {
"CLOSED-CAPTIONS": "text",
"RESOLUTION": "416x234",
"CODECS": "avc1.4D400D,mp4a.40.2",
"BANDWIDTH": 410181,
"AVERAGE-BANDWIDTH": 393177
}
}
},
{
"media": "media-2/stream.m3u8",
"tags": {
"#EXT-X-STREAM-INF": {
"CLOSED-CAPTIONS": "text",
"RESOLUTION": "416x234",
"CODECS": "avc1.4D400D,mp4a.40.2",
"BANDWIDTH": 727459,
"AVERAGE-BANDWIDTH": 698361
}
}
},
{
"media": "media-3/stream.m3u8",
"tags": {
"#EXT-X-STREAM-INF": {
"CLOSED-CAPTIONS": "text",
"RESOLUTION": "640x360",
"CODECS": "avc1.4D401E,mp4a.40.2",
"BANDWIDTH": 1263349,
"AVERAGE-BANDWIDTH": 1210676
}
}
},
- Even Master Playlists of iframe Playlists are Supported.
{
"media": "media-1/iframes.m3u8",
"tags": {
"#EXT-X-I-FRAME-STREAM-INF": {
"URI": "media-1/iframes.m3u8",
"RESOLUTION": "416x234",
"CODECS": "avc1.4D400D",
"BANDWIDTH": 360599,
"AVERAGE-BANDWIDTH": 64059
}
}
},
{
"media": "media-2/iframes.m3u8",
"tags": {
"#EXT-X-I-FRAME-STREAM-INF": {
"URI": "media-2/iframes.m3u8",
"RESOLUTION": "416x234",
"CODECS": "avc1.4D400D",
"BANDWIDTH": 631048,
"AVERAGE-BANDWIDTH": 121087
}
}
},
{
"media": "media-3/iframes.m3u8",
"tags": {
"#EXT-X-I-FRAME-STREAM-INF": {
"URI": "media-3/iframes.m3u8",
"RESOLUTION": "640x360",
"CODECS": "avc1.4D401E",
"BANDWIDTH": 1171948,
"AVERAGE-BANDWIDTH": 223837
}
}
},
{
"media": "media-4/iframes.m3u8",
"tags": {
"#EXT-X-I-FRAME-STREAM-INF": {
"URI": "media-4/iframes.m3u8",
"RESOLUTION": "768x432",
"CODECS": "avc1.4D401F",
"BANDWIDTH": 1752287,
"AVERAGE-BANDWIDTH": 354946
}
}
},
{
"media": "media-5/iframes.m3u8",
"tags": {
"#EXT-X-I-FRAME-STREAM-INF": {
"URI": "media-5/iframes.m3u8",
"RESOLUTION": "960x540",
"CODECS": "avc1.4D401F",
"BANDWIDTH": 2343896,
"AVERAGE-BANDWIDTH": 440896
}
}
},
Metadata
Release files for m3ufu 0.0.97
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| m3ufu-0.0.97.tar.gz | 8.5 kB | Without provenance | Details for m3ufu-0.0.97.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| m3ufu-0.0.97-py3-none-any.whl | Python 3 | none | any | Details for m3ufu-0.0.97-py3-none-any.whl |
Total release size: 17.1 kB
Release files / m3ufu-0.0.97.tar.gz
| Download URL | m3ufu-0.0.97.tar.gz |
|---|---|
| Size | 8.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
24b496198c9397fdc5960adbe8b12a9a549ee33397d3e5cefbddc66858a3514b
|
|
BLAKE2b-256 checksum How to use checksums |
b13ff095a3231f969743e9ab2522a451f1100020d82314e904cbbbe82213b12a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.2
|
Release files / m3ufu-0.0.97-py3-none-any.whl
| Download URL | m3ufu-0.0.97-py3-none-any.whl |
|---|---|
| Size | 8.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0abb6db10f423e8449a90408c414037f54b4334cc939733687d1046c5e77c12e
|
|
BLAKE2b-256 checksum How to use checksums |
d5d33a4507e3ae541f640eeccb77f2c48548ab34638dc9d60c3706bce070ebc9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.2
|
Security for m3ufu 0.0.97
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.