showcues 1.0.11

showcues displays HLS CUE-IN and CUE-OUT tags with wallclock time

showcues

Display HLS CUE-OUT and CUE-IN tags with wall clock times.

Latest Version is 1.0.11

Install

• Use pip to install

python3 -mpip install showcues 
# and / or 
pypy3 -mpip install showcues

Upgrade

• Use pip to upgrade

python3 -mpip install --upgrade showcues 
# and / or 
pypy3 -mpip install  --upgrade showcues

Run

• showcues takes a master m3u8 OR variant m3u8 (new with v.1.0.5) as input.
• showcues displays where the SCTE-35 cues are based on the SCTE-35 data.
• showcues follows the rules we will be applying to SCTE-35 in HLS.
  • Cues that are completely wrong are dropped.
  • Missing CUE-INs from break auto-returns are automatically added.

showcues https://nmxtunein.akamaized.net/hls/live/2020471/Live_1/index.m3u8
# OR
showcues https://nmxtunein.akamaized.net/hls/live/2020471/Live_1/index_1.m3u8

• A CUE-OUT is shown with:
  • duration
  • wall clock time
  • The segment URI

2023-08-03T23:45:15.16Z  OUT 
			 Duration: 150.0
			 Media: pri-aac_adts96-1691106276-5479-7257.aac

• A CUE-IN is shown with
  • wall clock time
  • The diff of when the CUE-IN should be and when it actually occurs.
  • The segment URI

2023-08-03T23:48:13.06Z  IN 
			 Diff: 0.017
			 Media: pri-aac_adts96-1691106456-5479-7290.aac

• An AUTO CUE-IN such as with a Break Auto Return, includes the word AUTO

2023-06-19T03:03:47 AUTO #EXT-X-CUE-IN  Diff: 5.539 
Media: index_375_00039.ts

• A Sidecar file, sidecar.txt is generated containing a list of ( pts,cue ) pairs.

a@debian:~/tunein/showcues$ tail -f sidecar.txt 
58363.607489,/DBFAAH/7S+YAP/wFAUAAAABf+//ORY3wv4AzgQwmZkBAQAgAh5DVUVJAAAAAH/AAADN/mABCDEwMTAwMDAwNAAAAADgrVWi
59305.014622,/DBFAAH/7S+YAP/wFAUAAAABf+//PiMLNP4ApMbEmZkBAQAgAh5DVUVJAAAAAH/AAACky4ABCDEwMTAwMDAwNAAAAAClR6us
59595.771756,/DBFAAH/7S+YAP/wFAUAAAABf+//P7JWgv4Azey6mZkBAQAgAh5DVUVJAAAAAH/AAADN/mABCDEwMTAwMDAwNAAAAAC+xYYV