A SCTE 35 Decoder for Mpeg-TS video, and Base64 or Hex encoded messages

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for fu-corp from gravatar.com fu-corp

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License
  • Author: fu-corp
  • Requires: Python >=3.6
Classifiers

Project description

threefive

SCTE35 Decoder

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)

Fast Start Directions.

Dependencies

Install

pip install threefive
Collecting threefive
  Downloading threefive-2.0.99-py3-none-any.whl (12 kB)
Collecting bitn>=0.0.27
  Downloading bitn-0.0.27-py3-none-any.whl (3.0 kB)
Installing collected packages: bitn, threefive
Successfully installed bitn-0.0.27 threefive-2.0.99

Easy threefive

The decode Function

import threefive

MpegTS Files

threefive.decode('/path/to/mpegwithscte35.ts')

Binary Files

threefive.decode('/mnt/build/file.bin')

Output for MpegTS and Binary Files and Streams

{ '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': '0x3',
                                'section_length': 47,
                                'section_syntax_indicator': False,
                                'splice_command_length': 4095,
                                'splice_command_type': 5,
                                'table_id': '0xfc',
                                'tier': '0xfff'},
              'Packet': { 'pid': '0x135'},
              '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}]}}

Base64 Encoded Strings

mesg='/DBhAAAAAAAA///wBQb+qM1E7QBLAhdDVUVJSAAArX+fCAgAAAAALLLXnTUCAAIXQ1VFSUg/nwgIAAAAACyy150RAAACF0NVRUlIAAAnf58ICAAAAAAsstezEAAAihiGnw=='
threefive.decode(mesg)

Hex Encoded Strings

hexed='0xFC302F000000000000FFFFF014054800008F7FEFFE7369C02EFE0052CCF500000000000A0008435545490000013562DBA30A'
threefive.decode(hexed)

Output for Base64 and Hex Strings

{ 'SCTE35': { 'Info_Section': { 'crc': '0x62dba30a',
                                'cw_index': '0xff',
                                'descriptor_loop_length': 10,
                                'encrypted_packet': False,
                                'encryption_algorithm': 0,
                                'private': False,
                                'protocol_version': 0,
                                'pts_adjustment': 0.0,
                                'reserved': '0x3',
                                'section_length': 47,
                                'section_syntax_indicator': False,
                                'splice_command_length': 20,
                                'splice_command_type': 5,
                                'table_id': '0xfc',
                                'tier': '0xfff'},
              'Splice_Command': { 'avail_expected': 0,
                                  'avail_num': 0,
                                  'break_auto_return': True,
                                  'break_duration': 60.293567,
                                  'duration_flag': True,
                                  'name': 'Splice '
                                          'Insert',
                                  'out_of_network_indicator': True,
                                  'program_splice_flag': True,
                                  'pts_time': 21514.559089,
                                  'splice_event_cancel_indicator': False,
                                  'splice_event_id': 1207959695,
                                  'splice_immediate_flag': False,
                                  'time_specified_flag': True,
                                  'unique_program_id': 0},
              'Splice_Descriptors': [ { 'descriptor_length': 8,
                                        'identifier': 'CUEI',
                                        'name': 'Avail '
                                                'Descriptor',
                                        'provider_avail_id': 309,
                                        'splice_descriptor_tag': 0}]}}

Advanced threefive

Using The Splice Class

The threefive.Splice class can be used to decode a SCTE35 message.

threefive.Splice provides several methods to access the parsed data.

from threefive import Splice

b64 = "/DBIAAAAAAAA///wBQb+ek2ItgAyAhdDVUVJSAAAGH+fCAgAAAAALMvDRBEAAAIXQ1VFSUgAABl/nwgIAAAAACyk26AQAACZcuND"

scte35 = Splice(b64)

Pretty Print SCTE 35 Message

scte35.show()

Return SCTE 35 Message

scte35.get()

Pretty Print Splice Info Section

scte35.show_info_section()

Return Splice Info Section

scte35.get_info_section()

Pretty print Splice Command.

scte35.show_command()

{ 'name': 'Time Signal',
  'pts_time': 22798.906911,
  'time_specified_flag': True}

Return Splice Command

scte35.get_command()

Pretty Print Splice Descriptors

scte35.show_descriptors()

Return Splice Descriptors

scte35.get_descriptors()

Using The Stream Class

  threefive.Stream(tsdata, show_null = False)
  • tsdata is an open file handle or sys.stdin.buffer to read 'piped' in data.
  • show_null if set to True, enables showing SCTE 35 null commands.

Parse a Local File with a Stream Instance

import sys
from threefive import Stream
'''

if __name__ =='__main__':
   with open(sys.argv[1],'rb') as tsdata:
       Stream(tsdata)

Pipe a Video to Stream

curl -s https://futzu.com/xaa.ts -o -  \
  | python3 -c 'import sys;import threefive; threefive.Stream(sys.stdin.buffer)' 

{ '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': '0x3',
                                'section_length': 47,
                                'section_syntax_indicator': False,
                                'splice_command_length': 4095,
                                'splice_command_type': 5,
                                'table_id': '0xfc',
                                'tier': '0xfff'},
              'Packet': { 'pid': '0x135'},
              '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}]}}

Using The StreamPlus Class

  threefive.StreamPlus(tsdata, show_null = False)

  • tsdata is an open file handle or sys.stdin.buffer to read 'piped' in data.

  • show_null if set to True, enables showing SCTE 35 null commands.

  • threefive.StreamPlus adds the PTS timestamp for each SCTE 35 packet.

Parse a Local File with a StreamPlus Instance

import sys
from threefive import StreamPlus
'''

if __name__ =='__main__':
   with open(sys.argv[1],'rb') as tsdata:
       StreamPlus(tsdata)

Pipe a Video to StreamPlus

curl -s https://futzu.com/xaa.ts -o - \
| python3 -c 'import sys;import threefive; threefive.StreamPlus(sys.stdin.buffer)'

{ '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': '0x3',
                                'section_length': 47,
                                'section_syntax_indicator': False,
                                'splice_command_length': 4095,
                                'splice_command_type': 5,
                                'table_id': '0xfc',
                                'tier': '0xfff'},

              'Packet': { 'pid': '0x135',              <-- Pid of the SCTE 35 Packet
                          'pts': 89730.289522},        <-- PTS of the SCTE 35 Packet

              '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}]}}

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for fu-corp from gravatar.com fu-corp

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License
  • Author: fu-corp
  • Requires: Python >=3.6
Classifiers

Release history Release notifications | RSS feed

2.4.69

2.4.67

2.4.65

2.4.63

2.4.61

2.4.59

2.4.57

2.4.55

2.4.53

2.4.51

2.4.49

2.4.47

2.4.45

2.4.43

2.4.41

2.4.39

2.4.37

2.4.35

2.4.33

2.4.31

2.4.29

2.4.27

2.4.25

2.4.23

2.4.21

2.4.19

2.4.17

2.4.15

2.4.13

2.4.11

2.4.9

2.4.7

2.4.5

2.4.3

2.4.1

2.3.99

2.3.97

2.3.95

2.3.93

2.3.91

2.3.89

2.3.87

2.3.85

2.3.83

2.3.81

2.3.79

2.3.77 yanked

Reason this release was yanked:

bad setup.py

2.3.75

2.3.73

2.3.71

2.3.69

2.3.67

2.3.65

2.3.63

2.3.61

2.3.59

2.3.57

2.3.55

2.3.53

2.3.51

2.3.49

2.3.47

2.3.45

2.3.43

2.3.41

2.3.39

2.3.37

2.3.35

2.3.33

2.3.31

2.3.29

2.3.27

2.3.25

2.3.23

2.3.21

2.3.19

2.3.17

2.3.15

2.3.13

2.3.11

2.3.9

2.3.7

2.3.5

2.3.3

2.3.1

2.2.99

2.2.97

2.2.95

2.2.93

2.2.91

2.2.89

2.2.87

2.2.85

2.2.83

2.2.81

2.2.79

2.2.77

2.2.75

2.2.73

2.2.71

2.2.69

2.2.67

2.2.65

2.2.63

2.2.61

2.2.59

2.2.57

2.2.55

2.2.53

2.2.51

2.2.49

2.2.47

2.2.45

2.2.43

2.2.41

2.2.39

2.2.37

2.2.35

2.2.33

2.2.31

2.2.29

2.2.27

2.2.25

2.2.23

2.2.21

2.2.19

2.2.17

2.2.15

2.2.13

2.2.11

2.2.9

2.2.7

2.2.5

2.2.3

2.2.1

2.1.99

2.1.97

2.1.93

2.1.91

2.1.89

2.1.87

2.1.85

2.1.83

2.1.81

2.1.79

2.1.77

2.1.75

2.1.73

2.1.71

2.1.69

2.1.67

2.1.65

2.1.63

2.1.61

2.1.59

2.1.57

2.1.55

2.1.53

2.1.51

2.1.49

2.1.47

2.1.45

2.1.43

2.1.41

2.1.39

2.1.37

2.1.35

2.1.33

2.1.31

2.1.29

2.1.27

2.1.25

2.1.23

2.1.21

2.1.19

2.1.17

2.1.15

2.1.13

2.1.11

2.1.9

2.1.7

2.1.5

2.1.3

2.1.1

This version

2.0.99

2.0.97

2.0.95

2.0.93

2.0.91

2.0.89

2.0.87

2.0.87b0 pre-release

2.0.85

2.0.83

2.0.81

2.0.79

2.0.77

2.0.75

2.0.73

2.0.71

2.0.69

2.0.67

2.0.63

2.0.61

2.0.59

2.0.57

2.0.55

2.0.53

2.0.51

2.0.49

2.0.47

2.0.45

2.0.43

2.0.41

2.0.39

2.0.37

2.0.35

2.0.33

2.0.31

2.0.29

2.0.27

2.0.25

2.0.23

2.0.21

2.0.19

2.0.17

2.0.15

2.0.13

2.0.11

2.0.9

2.0.7

2.0.5

2.0.3

2.0.1

1.1.99

1.1.97

1.1.95

1.1.93

1.1.91

1.1.89

1.1.87

1.1.85

1.1.83

1.1.81

1.1.79

1.1.77

1.1.71

1.1.69

1.1.67

1.1.63

1.1.61

1.1.59

1.1.57

1.1.55

1.1.53

1.1.51

1.1.49

1.1.47

1.1.45

1.1.43

1.1.41

1.1.39

1.1.37

1.1.35

1.1.33

1.1.29

1.1.27

1.1.25

1.1.23

1.1.21

1.1.19

1.1.17

1.1.15

1.1.13

1.1.11

1.1.9

1.1.7

1.1.5

1.1.3

1.1.1

1.0.99

1.0.93

1.0.91

1.0.9

1.0.7

1.0.5

1.0.3

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.99.tar.gz (13.5 kB view hashes)

Uploaded Source

Built Distribution

threefive-2.0.99-py3-none-any.whl (13.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page