sctefu 3.0.5

Fumatic SCTE-35 Encoder/ Decoder for MPEGTS, HLS , DASH and everything else...

I wrote threefive because I couldn't find any SCTE-35 tools. There were a few libraries, but SCTE-35 wasn't their focus, and they required writing several hundred lines of code to do anything. I think a library should save you time.

Why sctefu, why not just threefive?

• Answer #1 Github F2A'ed out of my account, and I have no idea where I put the recovery codes. I have more than one Internet account, where I am supposed to keep all this data? Should I store in some company's cloud so they can read it or give it away to Eastern European script kiddies? F2A is complete nonsense. It doesn't matter how secure it is, if a security measure prevents me from accessing my account, that's not secure, that's locked out.
• Answer #2 Two repos with the same name, would be confusing.
• Answer #3 I wanted to rethink everything. After going through the code, I kept about 75% of it. I completely rewrote the Xml parser,I did a lot of work with the Cue class, HLS, and really tuned up the cli. The cli is amazing and super easy to use.
• Answer #4 I came up with a really cool name, but it wasn't available on pypi.org for a package name.
• Answer #5 Really, I was just getting a little bored with the whole thing, I just wanted to shake things up a little, keep it fun.
• Answer #6 Have you seen chewy Tic Tacs? They're just mini jelly beans.
• Answer #7 I'll tell you the truth, everything is a lie.
• Answer #8 Obama is a lizard. I'm not sure about his wife.

How do I upgrade my code to sctefu?

Despite making a lot of changes, the api remains. sctefu is pretty much a drop in replacement for threefive. I used sed to upgrade my code.

sed -e 's/threefive/sctefu/g'

One thing to note, calling load or decode is no longer necessary for the Cue class, however, the methods are there in case you do call them.

Is sctefu faster than threefive?

threefive vs. sctefu vs. sctefu next release

• testing was done on a beatup chrome book reporting 5GB of RAM running Debian Sid and PyPy 7.3.11

---

Now with Super Advanced Error Detection and Stuff.

• This is super cool.
• Does not generate Fatal errors, it won't break your process.
• Displays what is in error and how to correct it.
• Works in the cli
• Works in code.

Issues and Bugs.

• If you think you have a bug, I'll quickly fix it, but first I need you to prove it to me. Show me the entire error message, the code you're running, and the SCTE-35.

---

Special Requests

• If need some work done, this is what I do for a living, you can hire me.
• If you want to discuss your project open an issue and I'll send you my contact info.

---

Install

• python3 via pip

python3 -mpip install sctefu

• pypy3

pypy3 -mpip install sctefu

• from the git repo

git clone https://github.com/superkabuki/scte35.git
cd scte35
make install

---

The Cli tool

The cli audetects data being available on stdin and that allows it to autodetect the SCTE-35 format as well as MPEGTS steams. Now every SCTE-35 data format, except hls, is autodetected on the commandline, as well as stdin.HLS requires the hls ketyword.

The cli tool installs automatically with pip or the Makefile.

• SCTE-35 Inputs
• SCTE-35 Outputs
• Parse MPEGTS streams for SCTE-35
• Parse SCTE-35 in hls
• Display MPEGTS iframes
• Display raw SCTE-35 packets from video streams
• Repair SCTE-35 streams changed to bin data by ffmpeg

Inputs

• Most inputs are auto-detected.
• stdin is auto selected and auto detected.
• SCTE-35 data is printed to stderr
• stdout is used when piping video

Input Type	Cli Example
Base64	sctefu '/DAsAAAAAyiYAP/wCgUAAAABf1+ZmQEBABECD0NVRUkAAAAAf4ABADUAAC2XQZU='
Hex	sctefu 0xfc301600000000000000fff00506fed605225b0000b0b65f3b
HLS	sctefu hls https://example.com/master.m3u8
JSON	sctefu < json.json
Xml	sctefu < xml.xml
Xmlbin	sctefu < xmlbin.xml

Streams

Protocol	Cli Example
File	sctefu video.ts
Http(s)	sctefu https://example.com/video.ts
Stdin	sctefu < video.ts
UDP Multicast	sctefu udp://@235.35.3.5:9999
UDP Unicast	sctefu udp://10.0.0.7:5555
HLS	sctefu hls https://example.com/master.m3u8

Outputs

• output type is determined by the key words base64, bytes, hex, int, json, xml, and xmlbin.
• json is the default.
• Any input (except HLS,) can be returned as any output
  • examples Base64 to Hex, or Mpegts to Xml, etc...)

Output Type	Cli Example
Base 64	sctefu 0xfc301600000000000000fff00506fed605225b0000b0b65f3b base64
Bytes	sctefu 0xfc301600000000000000fff00506fed605225b0000b0b65f3b bytes
Hex	sctefu '/DAsAAAAAyiYAP/wCgUAAAABf1+ZmQEBABECD0NVRUkAAAAAf4ABADUAAC2XQZU=' hex
Integer	sctefu '/DAsAAAAAyiYAP/wCgUAAAABf1+ZmQEBABECD0NVRUkAAAAAf4ABADUAAC2XQZU=' int
JSON	sctefu 0xfc301600000000000000fff00506fed605225b0000b0b65f3b json
Xml	sctefu '/DAsAAAAAyiYAP/wCgUAAAABf1+ZmQEBABECD0NVRUkAAAAAf4ABADUAAC2XQZU=' xml `
Xml+bin	sctefu 0xfc301600000000000000fff00506fed605225b0000b0b65f3b xmlbin

hls

• parse hls manifests and segments for SCTE-35

sctefu hls https://example.com/master.m3u8

---

Iframes

• Show iframes PTS in an MPEGTS video

sctefu iframes https://example.com/video.ts

---

packets

• Print raw SCTE-35 packets from multicast mpegts video

sctefu packets udp://@235.35.3.5:3535

---

proxy

• Parse a https stream and write raw video to stdout

sctefu proxy video.ts

---

pts

• Print PTS from mpegts video

 sctefu pts video.ts

---

sidecar

• Parse a stream, write pts,write SCTE-35 Cues to sidecar.txt

  sctefu sidecar video.ts

---

sixfix

• Fix SCTE-35 data mangled by ffmpeg

 sctefu sixfix video.ts

---

show

• Probe mpegts video ( kind of like ffprobe )

 sctefu show video.ts

---

version

• Show version

 sctefu version

---

help

• Help

 sctefu help

iodisco.com/scte35

---