Skip to content

Latest commit

 

History

History
133 lines (127 loc) · 4.34 KB

latest-cli.md

File metadata and controls

133 lines (127 loc) · 4.34 KB
Raw

threefive

the cli

  • default Basic threefive cli usage. (start here)
  • hls HLS SCTE-35 Decoding and Encoding.
  • xml Xml output for SCTE-35.
  • inject Inject SCTE-35 packets into mpegts streams.
  • packets Output raw SCTE-35 packets from mpegts.
  • proxy Parse SCTE-35 from mpegts and copy video stream to stdout.
  • pts Show PTS in realtime from live streams.
  • sidecar Parse MPEGTS and generate a SCTE-35 sidecar file.
  • sixfix ffmpeg mangles SCTE-35, sixfix is how to fix it.
  • show Display stream information for mpegts.
  • version Print threefive version.
  • help Show threefive help.

default

  • The default action of the threefive cli is to take an input and make it a SCTE-35 output.

  • SCTE-35 inputs are auto-detected.

  • SCTE-35 output default to json, other types must be specified.

    • These inputs are supported.

      • mpegts , base64, hex, json, xml, xmlbin

    • These outputs are supported.

      • base64, bytes, hex, json, xml, xmlbin

    Example usage

Input Output Command
mpegts base64 threefive https://example.com/video.ts base64
xml bytes threefive bytes < xml.xml
base64 hex threefive '/DAWAAAAAAAAAP/wBQb+AKmKxwAACzuu2Q==' hex
xmlbin int threefive int < xml.xml
mpegts json threefive video.ts
json xml threefive < json.json xml
hex xmlbin threefive 0xfc301600000000000000fff00506fe00a98ac700000b3baed9 xmlbin 
                                                 |

hls

  • SCTE-35 Decoding and Encoding for HLS

  • HLS SCTE-35 Decoding:

      threefive hls https://example.com/master.m3u8
  • read the help for advanced HLS SCTE-35 decoding.
      threefive hls help
  • HLS SCTE-35 Encoding:
      threefive hls  -i https://example.com/master.m3u8 -s sidecar.txt -o output_dir
  • read the help for advanced HLS SCTE-35 encoding.
      threefive hls encode help

xml

  • Xml output:

  • Base64

    • xml splice info section format
      threefive xml '/DAsAAAAAAAAAP/wBQb+7YaD1QAWAhRDVUVJAADc8X+/DAVPVkxZSSIAAJ6Gk2Q='
  • xml+bin format
      threefive xmlbin '/DAsAAAAAAAAAP/wBQb+7YaD1QAWAhRDVUVJAADc8X+/DAVPVkxZSSIAAJ6Gk2Q='
  • MPEGTS
    • xml splice info section format
      threefive xml https://example.com/video.ts
  • xml+bin format
      threefive xmlbin https://example.com/video.ts

inject

  • Inject an mpegts stream with a SCTE-35 sidecar file at pid:
      threefive inject video.ts with sidecar.txt at 333

packets

  • Print raw SCTE-35 packets from multicast mpegts video:
        threefive packets https://example.com/video.ts

proxy

  • Parse a https stream and write raw video to stdout:
      threefive proxy https://example.com/video.ts

pts

  • Print PTS from mpegts video:
      threefive pts video.ts

sidecar

  • Parse a stream, write pts,write SCTE-35 Cues to sidecar.txt:
      threefive sidecar https://example.com/video.ts

sixfix

  • Fix SCTE-35 data mangled by ffmpeg:
      threefive sixfix video.ts

show

  • Probe mpegts video:
      threefive show video.ts

version

      threefive version

help

      threefive help