ccExtract - Extract or Convert CC

ccExtract is part of ccConvert and included in Net-X-Code Server software. ccExtract is designed to extract caption tracks from MXF, MOV, h.264, MPEG-2, TS, etc. to SCC/MCC, and to convert between standard caption formats like VTT, XML, EBU, SMPTE DCP, YouTube, Apple, Avid, and others. This article contains the command line API for this tool. A RESTful API is also available.

ccExtract

ccExtract converts closed captions from one format to another.  It supports standard formats like SCC and MCC, workflow specific formats like AAF, Grass Valley N0, EBU, and DCP as well as most broadcast, internet and subtitle exchange formats like iTunes, YouTube, Avid, FCP, JSON, SAMI, VTT, CAP and even raw text. It also supports MXF/SMPTE 436M, MOV, TS, MPG and h.264/h.265/HEVC/MPEG-2/ProRes caption extraction to all supported formats for CEA 608, CEA 708 and OP-47. For embedding captions into MXF, MOV and other files, please see ccEmbed.

Basic Conversion MXF to VTT

ccExtract -i <sourcefile>.mxf -t <targetfile> -c 138

Convert From MCC to Text

ccExtract -i <sourcefile>.mcc -t <targetfile>.txt -c 2

Upconvert SCC (608) to AAF (708) for Avid MC

ccExtract -i <sourcefile>.mcc -t <targetfile>.txt -c 1

Downconvert MCC (708) to SCC (608)

ccExtract -i <sourcefile>.mcc -t <targetfile>.scc -c 3

Extract Compatibility Bytes From MCC (708) to SCC (608)

ccExtract -i <sourcefile>.mcc -t <targetfile>.scc -c 3 -C

Cross Convert OP-47 to MCC (708)

ccExtract -i <sourcefile>.mxf -t <targetfile>.mcc -c 0

Extract MXF/MOV to MCC for Adobe Premiere

ccExtract -i <sourcefile>.mov -t <targetfile>.mcc -c 0

Command Line Parameters

Usage: ccExtract -i -t [-qlx -r <01:00:00:00> -R <-00:30:00:00> -j # -k -e # -c # -a # -o -f # -s # -X -t # -n 1 -p # -n # -h # -M # -w -v -m ]
  -i File to be referenced
Optional parameters:
  -t File and path to write to
  -q Quiet mode
  -l Loud mode
  -x Export metadata XMLS
  -r 01:00:00:00 Override time code start
  -R -00:30:00:00 Offset time codes (e.g. subtract half an hour)
  -0 Zero based time code output
  -1 Mark this first time code in file
  -j # Create a JPEG picon from frame #
  -k File name for JPEG picon frame
  -e # Extract a JPEG picon for every # frame
  -h # eMAM source clip ID
  -s Force CC in video stream
  -X Extract CC from line 21 (SD only)
  -M # CC channel to extract (default: 1)
  -C Use 608 compatibility bytes (not 708)
  -c # Convert closed captioning to
      0=MCC, 1=AAF, 2=TEXT, 3=SCC, 4=SCCDF, 5=N0, 6=SCCAUTO,
      100=Avid Caption, 101=Belle Nuit Subtitler,
      102=CapMaker Plus, 103=Cheetah Caption, 104=Csv, 105=Csv2, 106=Csv3,
      107=D-Cine SMPTE 2007, 108=D-Cine SMPTE 2010,
      109=EBU STL, 110=Final Cut Pro Xml,
      111=Final Cut Xml Gap, 112=Final Cut Pro X Xml,
      113=Final Cut Pro XCM, 114=Flash Xml,
      115=iTunes Timed Text, 116=JSON, 117=JSON Type 2,
      118=JSON Type 3, 119=JSON Type 4, 120=QuickTime text,
      121=SAMI, 122=SAMI modern, 123=Scenarist, 124=DVD_SCC,
      125=DVD_SCCDF, 126=SoftNi sub, 127=Sony DVDArchitect,
      128=Sony DVD Exp dur, 129=Sony DVD line/dur,
      130=Sony DVD Tabs, 131=SubRip, 132=SubStation Alpha,
      133=Swift V2, 134=Timed Text 1.0, 135=TT 2006-04 .dfxp,
      136=TT 2006-04 .ttml, 137=TT 2006-04 .xml, 138=WebVTT,
      139=YT Annotations, 140=YouTube sbv,
      141=YouTube Transcript, 142=D-Cinema Interop,
      143=WebVTT-webvtt, 144=SMPTE-TT 2052,
      145=Netflix Timed Text
  -f # Force output frame rate (23, 24, 25, 29, 30)
  -g # Compensate conversion (2324, 2423, 2930, 3029)
  -o CC output directory
  -a # Interpret input file using encoding
      0=Auto, 1=UTF-8, 2=UTF-16, 3=IBM-850, 4=IBM-860, 5=Windows-1252