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
Report project as malware

Project description

threefive

SCTE35 Decoder

Splice Commands

  • source splice_commands.py
  • Splice Null
  • Splice Schedule (lightly tested)
  • Splice Insert
  • Time Signal
  • Bandwidth Reservation (lightly tested)

Splice Descriptors

  • source descriptors.py
  • DTMF Descriptor
  • Segmentation Descriptor
  • Segmentation UPID (partially implemented)
  • Segmentation Types and Messages
  • Time Descriptor
  • Audio Descriptor (lightly tested)

🡡 top

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

🡡 top

Easy threefive

The decode Function

  • source decode.py
  • threefive.decode is an all purpose function to decode SCTE 35 messages from a file or string.
import threefive

MpegTS

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

Binary

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

🡡 top

Advanced threefive

Splice Class

  • source splice.py

  • The threefive.Splice class decodes a SCTE35 binary, base64, or hex encoded string.

  • 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()

🡡 top

Stream Class

  • source stream.py

  • The threefive.Stream class parses SCTE35 messages from a file or stream.

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

🡡 top

StreamPlus Class

  • source streamplus.py
  • threefive.StreamPlus is a sub class of threefive.Stream
  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}]}}

🡡 top

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

3.0.73

3.0.71

3.0.69

3.0.67

3.0.65

3.0.63

3.0.61

3.0.59

3.0.57

3.0.55

3.0.53

3.0.51

3.0.49

3.0.47

3.0.45

2.5.9

2.5.5

2.5.3

2.5.1

2.4.99

2.4.97

2.4.95

2.4.93

2.4.91

2.4.90

2.4.89

2.4.87

2.4.85

2.4.83

2.4.81

2.4.79

2.4.77

2.4.75

2.4.73

2.4.71

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

This version

2.1.1

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.1.1.tar.gz (14.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

threefive-2.1.1-py3-none-any.whl (15.1 kB view details)

Uploaded Python 3

File details

Details for the file threefive-2.1.1.tar.gz.

File metadata

  • Download URL: threefive-2.1.1.tar.gz
  • Upload date:
  • Size: 14.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.23.0 setuptools/44.0.0 requests-toolbelt/0.8.0 tqdm/4.43.0 CPython/3.8.2

File hashes

Hashes for threefive-2.1.1.tar.gz
Algorithm Hash digest
SHA256 3c9a65d721b0b4bee0d99e5a3c0eadf2c8a02a1926e7be2455fa166e0de262a6
MD5 4147c5c16700cbf4669f4cf751382b36
BLAKE2b-256 bfffcfad39c62d51223478bb50dc687bb9473823bc9cdce7d25f1004ae713b94

See more details on using hashes here.

File details

Details for the file threefive-2.1.1-py3-none-any.whl.

File metadata

  • Download URL: threefive-2.1.1-py3-none-any.whl
  • Upload date:
  • Size: 15.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.23.0 setuptools/44.0.0 requests-toolbelt/0.8.0 tqdm/4.43.0 CPython/3.8.2

File hashes

Hashes for threefive-2.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 44225385419058f6f81436d2744c2304201f775f84bfda1a0ac30e96e71aeebc
MD5 6dfb2e65717fce26be5b55a7f8843f75
BLAKE2b-256 bae29bc2b0475351c125d257df3473bda816fee791387066505d8df74beaf87d

See more details on using hashes here.

Supported by

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