A Fast 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')

JSON Output for MpegTS and Binary Files and Streams

{
        "SCTE35": {
                "Info_Section": {
                        "table_id": "0xfc",
                        "section_syntax_indicator": false,
                        "private": false,
                        "reserved": "0x3",
                        "section_length": 47,
                        "protocol_version": 0,
                        "encrypted_packet": false,
                        "encryption_algorithm": 0,
                        "pts_adjustment": 0.0,
                        "cw_index": "0x0",
                        "tier": "0xfff",
                        "splice_command_length": 20,
                        "splice_command_type": 5,
                        "descriptor_loop_length": 10,
                        "crc": "0x10fa4d9e"
                },
                "Splice_Command": {
                        "name": "Splice Insert",
                        "splice_event_id": 662,
                        "splice_event_cancel_indicator": false,
                        "out_of_network_indicator": true,
                        "program_splice_flag": true,
                        "duration_flag": true,
                        "splice_immediate_flag": false,
                        "time_specified_flag": true,
                        "pts_time": 89742.161689,
                        "break_auto_return": false,
                        "break_duration": 242.0,
                        "unique_program_id": 1,
                        "avail_num": 0,
                        "avail_expected": 0,
                        "splice_command_length": 20
                },
                "Splice_Descriptors": [
                        {
                                "tag": 0,
                                "identifier": "CUEI",
                                "name": "Avail Descriptor",
                                "provider_avail_id": 0,
                                "descriptor_length": 8
                        }
                ]
        }
}


{
        "SCTE35": {
                "Info_Section": {
                        "table_id": "0xfc",
                        "section_syntax_indicator": false,
                        "private": false,
                        "reserved": "0x3",
                        "section_length": 42,
                        "protocol_version": 0,
                        "encrypted_packet": false,
                        "encryption_algorithm": 0,
                        "pts_adjustment": 0.0,
                        "cw_index": "0x0",
                        "tier": "0xfff",
                        "splice_command_length": 15,
                        "splice_command_type": 5,
                        "descriptor_loop_length": 10,
                        "crc": "0x6e33321e"
                },
                "Splice_Command": {
                        "name": "Splice Insert",
                        "splice_event_id": 662,
                        "splice_event_cancel_indicator": false,
                        "out_of_network_indicator": false,
                        "program_splice_flag": true,
                        "duration_flag": false,
                        "splice_immediate_flag": false,
                        "time_specified_flag": true,
                        "pts_time": 89984.161689,
                        "unique_program_id": 1,
                        "avail_num": 0,
                        "avail_expected": 0,
                        "splice_command_length": 15
                },
                "Splice_Descriptors": [
                        {
                                "tag": 0,
                                "identifier": "CUEI",
                                "name": "Avail Descriptor",
                                "provider_avail_id": 0,
                                "descriptor_length": 8
                        }
                ]
        }
}

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": {
                        "table_id": "0xfc",
                        "section_syntax_indicator": false,
                        "private": false,
                        "reserved": "0x3",
                        "section_length": 47,
                        "protocol_version": 0,
                        "encrypted_packet": false,
                        "encryption_algorithm": 0,
                        "pts_adjustment": 0.0,
                        "cw_index": "0xff",
                        "tier": "0xfff",
                        "splice_command_length": 20,
                        "splice_command_type": 5,
                        "descriptor_loop_length": 10,
                        "crc": "0x62dba30a"
                },
                "Splice_Command": {
                        "name": "Splice Insert",
                        "splice_event_id": 1207959695,
                        "splice_event_cancel_indicator": false,
                        "out_of_network_indicator": true,
                        "program_splice_flag": true,
                        "duration_flag": true,
                        "splice_immediate_flag": false,
                        "time_specified_flag": true,
                        "pts_time": 21514.559089,
                        "break_auto_return": true,
                        "break_duration": 60.293567,
                        "unique_program_id": 0,
                        "avail_num": 0,
                        "avail_expected": 0,
                        "splice_command_length": 20
                },
                "Splice_Descriptors": [
                        {
                                "tag": 0,
                                "identifier": "CUEI",
                                "name": "Avail Descriptor",
                                "provider_avail_id": 309,
                                "descriptor_length": 8
                        }
                ]
        }
}

🡡 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)

JSON Pretty Print SCTE 35 Message

scte35.show()

Return SCTE 35 Message

scte35.get()

JSON Pretty Print Splice Info Section

scte35.show_info_section()

Return Splice Info Section

scte35.get_info_section()

JSON Pretty Print Splice Command

scte35.show_command()

Return Splice Command

scte35.get_command()

JSON 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": {
                        "table_id": "0xfc",
                        "section_syntax_indicator": false,
                        "private": false,
                        "reserved": "0x3",
                        "section_length": 47,
                        "protocol_version": 0,
                        "encrypted_packet": false,
                        "encryption_algorithm": 0,
                        "pts_adjustment": 0.0,
                        "cw_index": "0x0",
                        "tier": "0xfff",
                        "splice_command_length": 20,
                        "splice_command_type": 5,
                        "descriptor_loop_length": 10,
                        "crc": "0x10fa4d9e"
                },
                "Splice_Command": {
                        "name": "Splice Insert",
                        "splice_event_id": 662,
                        "splice_event_cancel_indicator": false,
                        "out_of_network_indicator": true,
                        "program_splice_flag": true,
                        "duration_flag": true,
                        "splice_immediate_flag": false,
                        "time_specified_flag": true,
                        "pts_time": 89742.161689,
                        "break_auto_return": false,
                        "break_duration": 242.0,
                        "unique_program_id": 1,
                        "avail_num": 0,
                        "avail_expected": 0,
                        "splice_command_length": 20
                },
                "Splice_Descriptors": [
                        {
                                "tag": 0,
                                "identifier": "CUEI",
                                "name": "Avail Descriptor",
                                "provider_avail_id": 0,
                                "descriptor_length": 8
                        }
                ]
        }
}

🡡 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 PID and 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": {
                        "table_id": "0xfc",
                        "section_syntax_indicator": false,
                        "private": false,
                        "reserved": "0x3",
                        "section_length": 47,
                        "protocol_version": 0,
                        "encrypted_packet": false,
                        "encryption_algorithm": 0,
                        "pts_adjustment": 0.0,
                        "cw_index": "0x0",
                        "tier": "0xfff",
                        "splice_command_length": 20,
                        "splice_command_type": 5,
                        "descriptor_loop_length": 10,
                        "crc": "0x10fa4d9e"
                },
                "Splice_Command": {
                        "name": "Splice Insert",
                        "splice_event_id": 662,
                        "splice_event_cancel_indicator": false,
                        "out_of_network_indicator": true,
                        "program_splice_flag": true,
                        "duration_flag": true,
                        "splice_immediate_flag": false,
                        "time_specified_flag": true,
                        "pts_time": 89742.161689,
                        "break_auto_return": false,
                        "break_duration": 242.0,
                        "unique_program_id": 1,
                        "avail_num": 0,
                        "avail_expected": 0,
                        "splice_command_length": 20
                },
                "Splice_Descriptors": [
                        {
                                "tag": 0,
                                "identifier": "CUEI",
                                "name": "Avail Descriptor",
                                "provider_avail_id": 0,
                                "descriptor_length": 8
                        }
                ],
                "Packet_Data": {
                        "pid": "0x135",       <--- Packet PID
                        "pts": 89730.289522   <---- Packet PTS
                }
        }
}

🡡 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

This version

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

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.19.tar.gz (15.0 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.19-py3-none-any.whl (14.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: threefive-2.1.19.tar.gz
  • Upload date:
  • Size: 15.0 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.19.tar.gz
Algorithm Hash digest
SHA256 b4d716f2d8745ceb5f15a6b8bee367233cdd4a5553e78de32fd2456729eda0b1
MD5 5c6b9757413114976e9246f7ecaf4888
BLAKE2b-256 0a0f47c0e64ed38fd33aa4943a7214d0d2cd47c02d68682e4150f4e4ca111dac

See more details on using hashes here.

File details

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

File metadata

  • Download URL: threefive-2.1.19-py3-none-any.whl
  • Upload date:
  • Size: 14.7 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.19-py3-none-any.whl
Algorithm Hash digest
SHA256 ad8ffd394b663ac4f3cdcb70d7f90a5750bd88c4e937ad9186dc4dd715917f95
MD5 723102048409075f85a7aaa36891c0bc
BLAKE2b-256 3395345490162c115a09968aed6dead977188ce258b918569187075390f32ce2

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