A SCTE 35 Decoder for Mpeg-TS video, and Hex or Base64 messages
Project description
threefive
I welcome all feedback and ideas.
SCTE35 Decoder
- Parse SCTE 35 messages from Mpeg Transport Streams and Binary files.
- Parse SCTE 35 messages encoded in Base64, Binary, or Hex.
Fast Start Directions.
2019 Specification
Splice Commands
- Splice Null
- Splice Schedule (lightly tested)
- Splice Insert
- Time Signal
- Bandwidth Reservation (lightly tested)
Splice Descriptors
- DTMF Descriptor
- Segmentation Descriptor
- Segmentation UPID (partially implemented)
- Segmentation Types and Messages
- Time Descriptor
- Audio Descriptor (lightly tested)
Dependencies
- Python 3
- bitn
Install
pip install threefive
Collecting threefive
Downloading threefive-2.0.69-py3-none-any.whl (12 kB)
Collecting bitn>=0.0.21
Downloading bitn-0.0.21-py3-none-any.whl (3.0 kB)
Installing collected packages: bitn, threefive
Successfully installed bitn-0.0.21 threefive-2.0.69
Using threefive
Call threefive.decode.
- mpegts files
- binary files
- base64 encoded strings
- hex encoded strings
- binary byte strings
Parse Mpegts Files
>>> import threefive
>>> threefive.decode('/path/to/mpegwithscte35.ts')
Parse Binary Encoded Messages From a File
>>> import threefive
>>> stuff=threefive.decode('/mnt/build/file.bin')
Parse Base64 Encoded Messages
>>> import threefive
>>> mesg='/DBhAAAAAAAA///wBQb+qM1E7QBLAhdDVUVJSAAArX+fCAgAAAAALLLXnTUCAAIXQ1VFSUg/nwgIAAAAACyy150RAAACF0NVRUlIAAAnf58ICAAAAAAsstezEAAAihiGnw=='
>>> t=threefive.decode(mesg)
Parse Hex Encoded Messages
>>> import threefive
>>> u=threefive.decode('0xFC302F000000000000FFFFF014054800008F7FEFFE7369C02EFE0052CCF500000000000A0008435545490000013562DBA30A')
Parse Binary Byte String Messages
>>> import threefive
>>> f=open('/mnt/build/file.bin','rb').read()
>>> scte35=threefive.decode(f)
Output for Base64 and Hex Strings
- SCTE 35 Info Section
- SCTE 35 Command
- SCTE 35 Descriptors
{ 'SCTE35': { 'Info_Section': { 'crc': '0x9ac9d17e',
'cw_index': '0xff',
'descriptor_loop_length': 30,
'encrypted_packet': False,
'encryption_algorithm': 0,
'private': False,
'protocol_version': 0,
'pts_adjustment': 0.0,
'reserved': 3,
'section_length': 52,
'section_syntax_indicator': False,
'splice_command_length': 5,
'splice_command_type': 6,
'table_id': '0xfc',
'tier': '0xfff'},
'Splice_Command': { 'name': 'Time '
'Signal',
'pts_time': 21388.766756,
'time_specified_flag': True},
'Splice_Descriptors': [ { 'archive_allowed_flag': True,
'delivery_not_restricted_flag': False,
'descriptor_length': 28,
'device_restrictions': '0x3',
'identifier': 'CUEI',
'name': 'Segmentation '
'Descriptor',
'no_regional_blackout_flag': True,
'program_segmentation_flag': True,
'segment_num': 2,
'segmentation_duration': 307.0,
'segmentation_duration_flag': True,
'segmentation_event_cancel_indicator': False,
'segmentation_event_id': '0x4800008e',
'segmentation_message': 'Provider '
'Placement '
'Opportunity '
'Start',
'segmentation_type_id': 52,
'segmentation_upid_length': 8,
'segmentation_upid_type': 8,
'segments_expected': 0,
'splice_descriptor_tag': 2,
'turner_identifier': '0x2ca0a18a',
'web_delivery_allowed_flag': False}]}}
Output for Mpegts streams and Files
- Packet Pid
- Packet PTS
- SCTE 35 Info Section
- SCTE 35 Command
- SCTE 35 Descriptors
{ 'Packet': { 'pid': '0x135',
'pts': 89730.289522},
'SCTE35': { 'Info_Section': { 'crc': '0x10fa4d9e',
'cw_index': '0x0',
'descriptor_loop_length': 10,
'encrypted_packet': False,
'encryption_algorithm': 0,
'private': False,
'protocol_version': 0,
'pts_adjustment': 0.0,
'reserved': 3,
'section_length': 47,
'section_syntax_indicator': False,
'splice_command_length': 4095,
'splice_command_type': 5,
'table_id': '0xfc',
'tier': '0xfff'},
'Splice_Command': { 'avail_expected': 0,
'avail_num': 0,
'break_auto_return': False,
'break_duration': 242.0,
'duration_flag': True,
'name': 'Splice '
'Insert',
'out_of_network_indicator': True,
'program_splice_flag': True,
'pts_time': 89742.161689,
'splice_event_cancel_indicator': False,
'splice_event_id': 662,
'splice_immediate_flag': False,
'time_specified_flag': True,
'unique_program_id': 1},
'Splice_Descriptors': [ { 'descriptor_length': 8,
'identifier': 'CUEI',
'name': 'Avail '
'Descriptor',
'provider_avail_id': 0,
'splice_descriptor_tag': 0}]}}
{ 'Packet': { 'pid': '0x135',
'pts': 89977.249522},
'SCTE35': { 'Info_Section': { 'crc': '0x6e33321e',
'cw_index': '0x0',
'descriptor_loop_length': 10,
'encrypted_packet': False,
'encryption_algorithm': 0,
'private': False,
'protocol_version': 0,
'pts_adjustment': 0.0,
'reserved': 3,
'section_length': 42,
'section_syntax_indicator': False,
'splice_command_length': 4095,
'splice_command_type': 5,
'table_id': '0xfc',
'tier': '0xfff'},
'Splice_Command': { 'avail_expected': 0,
'avail_num': 0,
'duration_flag': False,
'name': 'Splice '
'Insert',
'out_of_network_indicator': False,
'program_splice_flag': True,
'pts_time': 89984.161689,
'splice_event_cancel_indicator': False,
'splice_event_id': 662,
'splice_immediate_flag': False,
'time_specified_flag': True,
'unique_program_id': 1},
'Splice_Descriptors': [ { 'descriptor_length': 8,
'identifier': 'CUEI',
'name': 'Avail '
'Descriptor',
'provider_avail_id': 0,
'splice_descriptor_tag': 0}]}}
threefive.Splice.show()
Shows all data
>>> import threefive
>>> mesg='/DBIAAAAAAAA///wBQb+ky44CwAyAhdDVUVJSAAACn+fCAgAAAAALKCh4xgAAAIX
Q1VFSUgAAAl/nwgIAAAAACygoYoRAAC0IX6w')
>>> fu=threefive.Splice(mesg)
>>> fu.show()
Read individual values
>>> import threefive
>>> mesg='/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo='
>>> scte_data=threefive.Splice(mesg)
>>> scte_data.command.name
'Splice Insert'
>>> scte_data.command.splice_immediate_flag
False
>>> scte_data.command.pts_time
'21514.559089'
>>> scte_data.command.break_duration
'60.293567'
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
threefive-2.0.81.tar.gz
(11.6 kB
view hashes)
Built Distribution
threefive-2.0.81-py3-none-any.whl
(11.6 kB
view hashes)
Close
Hashes for threefive-2.0.81-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0fcfa919072e0493413fa2ede9ef89e8132a008c3969a4db8f439fe0ef7c2fbb |
|
| MD5 | 4b750e7c00a495a45582dfce355d03a7 |
|
| BLAKE2b-256 | 643a56df8dd8cfc98a4ca2e72f42bdb41cc2f781da49aceb793e0f84108ff7f4 |
