Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/superkabuki/scte35
threefive continued. SCTE-35 for the People
https://github.com/superkabuki/scte35
0x86 ad-tech adbreak adrianofdoom bestscte35parser dash hls linux mpegts multicast openbsd pypy3 scte-35 scte-35parser scte-marker scte35 superhappyfuntime threefive xml
Last synced: 12 days ago
JSON representation
threefive continued. SCTE-35 for the People
- Host: GitHub
- URL: https://github.com/superkabuki/scte35
- Owner: superkabuki
- License: bsd-2-clause
- Created: 2024-12-03T03:52:08.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-12-21T06:53:47.000Z (13 days ago)
- Last Synced: 2024-12-21T07:28:26.784Z (13 days ago)
- Topics: 0x86, ad-tech, adbreak, adrianofdoom, bestscte35parser, dash, hls, linux, mpegts, multicast, openbsd, pypy3, scte-35, scte-35parser, scte-marker, scte35, superhappyfuntime, threefive, xml
- Language: Python
- Homepage:
- Size: 340 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# threefive
# Yes, I'm the guy who wrote threefive.
> 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 threefive3, why not just threefive?
> Honestly, 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.
# How do I upgrade my code to threefive3?
> Despite making a lot of changes, the api remains. threefive3 is pretty much a drop in replacement for threefive. I used sed to upgrade my code.
```js
sed -e 's/threefive/threefive3/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.
# 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 there is a bug in threefive3, please do report it and if it's valid, I will fix it.
* If you think you have a bug, I need you to prove it. I need the entire error message, the code you're running, and the SCTE-35.
---
# Special Requests
* __I am not here to teach you SCTE-35__.
* 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
```rebol
python3 -mpip install threefive3
```
* pypy3
```rebol
pypy3 -mpip install threefive3
```
* from the git repo
```rebol
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__](#inputs)
* [__SCTE-35 Outputs__](#outputs)
* [__Parse __MPEGTS__ streams for __SCTE-35__](#streams)
* [Parse __SCTE-35__ in __hls__](#hls)
* [Display __MPEGTS__ __iframes__](#iframes)
* [Display raw __SCTE-35 packets__ from __video streams__](#packets)
* [__Repair SCTE-35 streams__ changed to __bin data__ by __ffmpeg__](#sixfix)
### `Inputs`
* the cli can __decode SCTE-35__ from
* [__Base64__](#base64)
* [__Hex,__](#hex)
* [__HLS,__](#hls)
* [__JSON,__](#json)
* [__Xml,__](#xml)
* [__Xml+Bin__](#xmlbin)
* [__MPEGTS Streams__](#streams)
* 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__
#### `Base64`
* parse SCTE-35 encoded in Base64
```rebol
threefive3 '/DAsAAAAAyiYAP/wCgUAAAABf1+ZmQEBABECD0NVRUkAAAAAf4ABADUAAC2XQZU='
```
#### `Hex`
* parse SCTE-35 encoded in Hex
```rebol
threefive3 0xfc302c00000003289800fff00a05000000017f5f999901010011020f43554549000000007f8001003500002d974195
```
#### `HLS`
* parse SCTE-35 from HLS manifests and segments
```rebol
threefive3 hls https://example.com/master.m3u8
```
#### `Json`
```rebol
cat json.json | threefive3
```
#### `Xml`
* you can make a xml.xml file like this:
* redirect 2 (stderr) to the file
```awk
./threefive3 '/DAsAAAAAyiYAP/wCgUAAAABf1+ZmQEBABECD0NVRUkAAAAAf4ABADUAAC2XQZU=' xml 2> xml.xml
```
* pass in
```rebol
threefive3 < xml.xml
```
#### `Xmlbin`
```rebol
threefive3 < xmlbin.xml
```
___
### `Outputs`
* the cli can __encode SCTE-35__ to
* [__Base64__](#base64-1)
* [__Bytes__](#bytes)
* [__Hex,__](#hex-1)
* [__HLS,__](#hls-1)
* [__JSON,__](#json-1)
* [__Xml,__](#xml-1)
* [__Xml+Bin__](#xmlbin-1)
* default output is `json`
#### json
```rebol
threefive3 '/DAsAAAAAyiYAP/wCgUAAAABf1+ZmQEBABECD0NVRUkAAAAAf4ABADUAAC2XQZU='
```
#### `base64`
```rebol
threefive3 '/DAsAAAAAyiYAP/wCgUAAAABf1+ZmQEBABECD0NVRUkAAAAAf4ABADUAAC2XQZU=' base64
```
#### `bytes`
```rebol
threefive3 '/DAsAAAAAyiYAP/wCgUAAAABf1+ZmQEBABECD0NVRUkAAAAAf4ABADUAAC2XQZU=' bytes
```
#### `hex`
```rebol
threefive3 '/DAsAAAAAyiYAP/wCgUAAAABf1+ZmQEBABECD0NVRUkAAAAAf4ABADUAAC2XQZU=' hex
```
#### `int`
```rebol
threefive3 '/DAsAAAAAyiYAP/wCgUAAAABf1+ZmQEBABECD0NVRUkAAAAAf4ABADUAAC2XQZU=' int
```
#### `xml`
```rebol
threefive3 '/DAsAAAAAyiYAP/wCgUAAAABf1+ZmQEBABECD0NVRUkAAAAAf4ABADUAAC2XQZU=' xml
```
#### `xml+bin`
```rebol
threefive3 '/DAsAAAAAyiYAP/wCgUAAAABf1+ZmQEBABECD0NVRUkAAAAAf4ABADUAAC2XQZU=' xmlbin
```
___
## Streams
### `File and Network Protocols`
#### `File`
```rebol
threefive3 video.ts
```
#### `Http(s)`
```rebol
threefive3 https://example.com/master.m3u8
```
#### `Multicast`
```rebol
threefive3 udp://@235.35.3.5:9999
```
#### `stdin`
```rebol
cat video.ts | threefive3
```
#### `Udp Unicast`
```rebol
threefive3 udp://10.0.0.7:5555
```
___
### `hls`
* parse hls manifests and segments for SCTE-35
```rebol
threefive3 hls https://example.com/master.m3u8
```
___
### `Iframes`
* Show iframes PTS in an MPEGTS video
```rebol
threefive3 iframes https://example.com/video.ts
```
___
### `packets`
* Print raw SCTE-35 packets from multicast mpegts video
```rebol
threefive3 packets udp://@235.35.3.5:3535
```
___
### `proxy`
* Parse a https stream and write raw video to stdout
```rebol
threefive3 proxy video.ts
```
___
### `pts`
* Print PTS from mpegts video
```rebol
threefive3 pts video.ts
```
___
### `sidecar`
* Parse a stream, write pts,write SCTE-35 Cues to sidecar.txt
```rebol
threefive3 sidecar video.ts
```
___
### `sixfix`
* Fix SCTE-35 data mangled by ffmpeg
```rebol
threefive3 sixfix video.ts
```
___
### `show`
* Probe mpegts video _( kind of like ffprobe )_
```rebol
threefive3 show video.ts
```
___
### `version`
* Show version
```rebol
threefive3 version
```
___
### `help`
* Help
```rebol
threefive3 help
```
## [iodisco.com/scte35](https://iodisco.com/scte35)
[
](https://iodisco.com/scte35)
___