MediaReactor Usage Tips

mediareactor logo smallMediaReactor and MediaReactor Workstation integrate tightly with installed operating systems and applications.  This section has tips and tricks on getting the most out of MediaReactor and/or MediaReactor Workstation.

Mac OS-X

 


 

Enabling legacy codecs for more output choices in QuickTime 7.4 and greater

(the original Apple article link is dead:  http://support.apple.com/kb/TS1149?viewlocale=en_US&locale=en_US)

Symptoms

With QuickTime 7.4 or later installed, some older encoders (codecs) may appear to be missing export options in applications that export QuickTime files, such as Final Cut Pro or Compressor or from the export options in QuickTime Player Pro.

Resolution

Take the following steps to enable additional encoders:

  • Choose Apple menu > System Preferences.
  • Choose View > QuickTime.
  • Click the Advanced button.
  • Select the checkbox next to Show legacy encoders.

 


 

Using MediaReactor Workstation as a source reader for your own (or other) programs (OS-X)

MediaReactor Workstation provides a number of different ways to read supported file and compression types into your own programs.  Here are a list of publicly available interfaces:

  • QuickTime Interface - MRWS provides an series of components to QuickTime including file readers, compressors, decompressors and low level data handlers that allow any program to read all the available formats through QuickTime as though they were normal MOV files
  • DTMediaRead Interface - This interface is a direct reader that requires an OEM agreement with Drastic.  See the DTMediaRead SDK page for more information.
  • MkRefMov - MRWS includes a command line program called MkRefMov (Make Reference Movie).  This program can make a reference movie (a small pointer only movie) for most supported files that can be read by any program supporting QuickTime MOV files.  This includes new programs like Final Cut Pro X that don't normally support formats like MXF variants from Omneon, Pinnacle, Grass Valley and Avid.

 


 

Clear Avid MediaComposer Cache

  • Close MediaComposer
  • Navigate to HD/Users/Shared/AvidMediaComposer/AMA Management.
  • Delete the contents of the "AMA Metadata Folders" folder. The folder will be rebuilt once the software is relaunched.
  • Rename or delete "Managed AMA Media Folders.xml".
  • Reopen MediaComposer. Delete the file from its current bin and re-link.

 


 

Windows

 


 

Using MediaReactor Workstation as a source reader for your own (or other) programs (Windows)

MediaReactor Workstation provides a number of different ways to read supported file and compression types into your own programs.  Here are a list of publicly available interfaces:

  • DirectShow - MRWS installs a DirectShow Filter called 'Drastic MediaReactor File Source'.  This can be opened with any supported file to provide audio and video to a DirectShow filter graph
  • QuickTime Interface - MRWS provides a series of components for QuickTime including file readers, compressors, decompressors and low level data handlers that allow any program to read all the available formats through QuickTime as though they were normal MOV files
  • DTMediaRead Interface - This interface is a direct reader that requires an OEM agreement with Drastic.  See the DTMediaRead SDK page for more information.
  • MkRefMov - MRWS includes a command line program called MkRefMov (Make Reference Movie).  This program can make a reference movie (a small pointer only movie) for most supported files that can be read by any program supporting QuickTime MOV files.  This includes new programs like Final Cut Pro X that don't normally support formats like MXF variants from Omneon, Pinnacle, Grass Valley and Avid.

 


 

Clear Avid MediaComposer Cache

  • Close MediaComposer
  • Navigate to C:\Users\Public\Public Documents\Avid Media Composer.
  • Delete the contents of the "AMA Metadata Folders" folder. The folder will be rebuilt once the software is relaunched.
  • Rename or delete "Managed AMA Media Folders.xml".
  • Reopen MediaComposer. Delete the file from its current bin and re-link.

 


 

OS Independent

 


ccExtract 6 - ccConvert Closed Caption Extraction Command Line Interface

ccExtract- Extract metadata information from GXF, MXF, AVI, etc, by Drastic Technologies (www.drastictech.com)
Build: 49
(c)opyright 1995-2016 Drastic Technologies Ltd. All rights reserved.
Usage: ccExtract -i <sourcefile> -t <targetfile> -qlx -r <01:00:00:00> -j # -k <picon.jpg> -e # -c -a -o <outputdir> -f # -s # -t # -n 1 -w <output.wav> -v <outputvideo.raw> -m <
reference.mov>
  -i <sourcefile> File to be referenced
Optional paramaters:
  -t <targetfile> File and path to write to
  -q Quiet mode.
  -l Loud mode.
  -x Export metadata XMLS
  -r 01:00:00:00 Override timecode start
  -R -00:30:00:00 Ofset timecodes (eg. subtract half an hour)
  -j # Create a JPEG picon from frame #
  -k <picon.jpg> Filename for JPEG picon frame
  -e # Extract a JPEG picon for every # frame
  -s Force CC in video stream
  -X Extract CC from line 21 (SD only)
  -c # Convert closed captioning to
    0=MCC, 1=AAF, 2=TEXT, 3=SCC, 4=SCCDF, 5=N0
    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=Sub Station 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,
  -f # Force frame rate (23, 24, 25, 29, 30)
  -o <out-dir> CC output directory
  -p # Detect scene changes, # = threshold
  -d # Scene change output type, 0-XML, 1-ALE, 2-EDL
  -n # First channel of source audio for the wave file (0,2,4)
  -w <output.wav> Extract audio to a wave file
  -w <outputvideo.raw>Extract video to raw stream file
  -a # Interpret input file using encoding
    0=Auto, 1=UTF-8, 2=UTF-16, 3=IBM-850, 4=IBM-860, 5=Windows-1252


ccEmbed 6 - ccConvert Closed Caption Embedding Command Line Interface

 

ccEmbed -s <sourcefile> -t <targetfile> [-a <ackfile>] -p <profile> [-in <00:01:00:00> -out <00:02:00:00> -fg]

  -s <sourcefile> -- The source file name and path
  -t <targetfile> -- The target file name and path
  -a <ackfile> -- The ACK file name and path. This is the XML acknowledgement file made after a copy
  -p <profile> -- Profile to use. Current profiles include
    • copy – copy the whole file
    • wrap – re wrap file or part of a file
    • index – create an RTIndex for a file
    • mov-YCbCr8Bit – QuickTime MOV 8 bit uncompressed YcbCr file
    • mov-dvcprohd - QuickTime MOV DVHD 100
    • mp4-h264 - MP4 with h264, original size
    • mxf-xdcam-720p - MXF Sony XDCam 720p
    • mxf-dvcprohd-720p - MXF DVHD 720p
    • mxf-xdcam-1080i - MXF Sony XDCam 1080i
    • mxf-dvcprohd-1080i - MXF DVHD 1080i
    • mxf-OP1a-MPEG - MXF OP1a MPEG (XDCam like, 16 audio channels)
    • mxf-op1a-h264 - MXF h.264
    • mxf-OP1a-HDF - MXF MPEG HDF
    • mxf-as-11-sd-dpp - MXF DPP SD IMX
    • mxf-as-11-hd-dpp - MXF DPP HD AVCi
    • mov-proreshq - QuickTime MOV ProRes HQ
    • mov-prores422 - QuickTime MOV ProRes 422
    • scaledown2000k - MP4 264 960x540, 2mbs
    • scaledown500k - MP4 264 480x272, 0.5mbs
  -type mxf-op1a -- the exact file type to write, otherwise auto
  -in <00:01:00:00> -- the starting point for the output file in time code or absolute position
  -out <00:02:00:00> -- the ending point for the output file in time code or absolute position
  -tcoffset <00:01:00:00> -- offset the timecode during translation
  -tc <01:00:00:00> -- replace timecode during translation
  -absin <200> -- the absolute (zero based) start time for the output file (overrides -in)
  -absout <400> -- the absolute (zero based) end time, exclusive, for the output file (overrides -out)
  -copy -- make a copy of the file section we need, instead of reading directly
  -dest <folder> -- folder or folder and file name for the temp file when using copy
  -cc <mcc/scc file> -- replacement closed caption file>
  -afile <path-audio-file> -- replacement source audio track<s>
  -v <path-video-file> -- replacement source video track
  -fg -- force the GUI on
  -fc -- force command line
NOTE: the parameters in [square brackets] are optional.

 


mrcmd - Drastic MediaReactor Command Line Interface

mrcmd - MediaReactor Command Line Utility, by Drastic Technologies (www.drastic.tv)
(c)opyright 1995-2017 Drastic Technologies Ltd. All rights reserved.
Usage: mrcmd
-I <inputname> = Input file path/name (required)
-O <outputname> = Input file path/name (required)
-s # = Start frame (def: 0)
-e # = End frame (def: length of input)
-S <00:00:00:00> = Start timecode (def: first timecode in file)
-E <01:00:00:00> = End timecode (def: last timecode in file plus one)
-t = Allow transcode stream (def: convert stream)
-T = Trascode to matched stream
-x # = Horizontal size >1 (def: same as input)
-y # = Vertical size >1 (def: same as input)
-b # = Bit depth 8/16/24/32 (def: optimal)
-q # = Video quality 0..10000 (def: highest)
-d # = Video data rate >=0 (def: highest)
-k # = Key frame distance (def: 15)
-M = Separate audio files (def: internal)
-m = Dual mono audio files (def: stereo, requires -s)
-r # = Audio frequency/rate (def: same as input)
-a # = Audio sample size 8/16 (def: same as input)
-c # = Audio channels 1/2/4/5/6/8 (def: same as input)
-p # = Audio quality 0..10000 (def: highest)
-i # = Output video file ID (from codeclist.txt)
-f <filetype> = Output video file type - AVI/MOV/OMF (def: auto sense)
-F <filetype> = Output audio file type - WAV/AIF/AU (def: auto sense, requires -s)
-v <codec> = Output video codec (text) - MMES/2yuv/DVSD (def: RGB uncompressed)
-n # = Output video codec (numeric hex) - 88000001/1/a/f
-A = Disable audio output (def: depends on input)
-V = Disable video output (def: depends on input)
-P <profile> = MediaReactor profile file path/name (optional)

 

To get a list of all the file type available in the file codeclist.txt, use
   mrcmd -all
To get a list of the codecs for a file type, use
   mrcmd #

 

MkRefMov - Make Reference Movie

Usage: ./mkrefmov -i <sourcefile> [-o <targetfile>]

  • -i <sourcefile> File to be referenced.
  • -o [targetfile] Optional, reference file name, otherwise it will use the source name with an mov extension

NOTE:  Due to limitations in QuickTime, MkRefMov will not work properly with a series of still images.  If you supply one, a full MOV will be created instead.

 


AddTcMov - Add Time Code To An Existing QuickTime MOV

Usage: addtcmov -i <moviefile> -s <tcframe> -t <tctype> -r [reelname]

  • -i <moviefile> QuickTime MOV to add tc track to
  • -s <tcframe> Integer time code frame number of first frame in movie file.
  • -t <tctype> Time code type
    • 24 = 1
    • NonDropFrame = 2
    • DropFrame = 4
    • Pal = 8
    • 50 = 16
    • 59.94 = 32
    • 59 special = 34 (not recommended)
    • 60 = 64
    • 23.98 = 128
    • 23.98 true = 132 (not recommended)
    • hundredths = 68
  • -r <reelname> Reel name for file

mkRtIndex - Make An rtin (Real Time Index) File

Usage: mkRtIndex <sourcefile> [-v]

NOTE: parameters must be in order

  • <sourcefile> File to be indexed.
  • -v Optional, verify rtIndex instead of create.

 


MRMetaData - Extract a File's Metadata Information

 

mrmetadata - Extract metadata information from GXF, MXF, AVI, etc, by Drastic Technologies (www.drastic.tv)
Build: 24
(c)opyright 1995-2017 Drastic Technologies Ltd. All rights reserved.
Usage: mrmetadata.exe -i <sourcefile> -t <targetfile> -qlx -r <01:00:00:00> -j # -k <picon.jpg> -e # -c -a -o <outputdir> -f # -s # -t # -n 1 -w <output.wav> -v <outputvideo.raw>
-m <reference.mov>
-i <sourcefile> File to be referenced
Optional paramaters:
-t <targetefile> 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
-j # Create a JPEG picon from frame #
-k <picon.jpg> Filename for JPEG picon frame
-e # Extract a JPEG picon for every # frame
-s Force CC in video stream
-c # Convert closed captioning to
0=MCC, 1=AAF, 2=TEXT, 3=SCC, 4=SCCDF, 5=N0
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=Sub Station 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,
-f # Force frame rate (23, 24, 25, 29, 30)
-o <out-dir> CC output directory
-p # Detect scene changes, # = threshold
-d # Scene change output type, 0-XML, 1-ALE, 2-EDL
-n # First channel of source audio for the wave file (0,2,4)
-w <output.wav> Extract audio to a wave file
-w <outputvideo.raw>Extract video to raw stream file
-a # Interpret input file using encoding
0=Auto, 1=UTF-8, 2=UTF-16, 3=IBM-850, 4=IBM-860, 5=Windows-1252
-m <reference.mov> Create a quicktime reference file

 


MRAnalyze - Use Standard PSNR/(MS)SSIM to Compare an Original and Converted File

mranalyze - Video/Audio analysis tool (www.drastic.tv)

Usage:  mranalyze -a <source a> -b <source b> -q -p # -s # -m # -g # -f # -l # -x # -n # [-o <targetfile>]

  • -a <source a>  Original file.
  • -b <source b>  Compressed file.
  • -q  Quiet (no output) must be first argument.
  • -p #  PSNR type
  • -s #  SSIM type (0-Square, 1=Guassian)
  • -m #  MS-SSIM type
  • -g #  Global checks (0-none, 1-basic, 2-advanced)
  • -f #  First frame to check
  • -l #  Last frame to check
  • -x #  B source first frame to check
  • -n #  Next frame distance (def 1 = every frame)
  • -o [targetfile]  Optional, csv output name (or '-o i' to generate the file name)

 

Application Specific

 


 

Adobe Premiere CS5/6

To bring a file into Premiere for editing, right click in the Project area and select Import, or select the menu File | Import. Adding files via the Media Browser area is also supported.
To export a file from Premiere, select the menu File | Export ? Media. Select the Format drop down to select the type. Set the settings and click the Export button.

Apple Final Cut Pro (Suite 3/7)

To bring a file into FCP for editing, right click on the bin and select Import->File. Browse to the file and select it. The Import->File is also available in the File menu.
To export a file from FCP, click on the sequence you want to export. Select the File menu, then Export->Using QuickTime Conversions... Open the Format list box and select the output type you want, then click the Options button to set the options. Set the name and add the correct extension (FCP will not do this for you). Click Save to export the sequence.

Assimilate Scratch/Lab

To bring a file into Assimilate Scratch/Lab, from the Timeline | Media area select Load Shot. The file browser will contain all the compatible types. For types that are supported in Scratch and MediaReactor Workstation (e.g. Arri, MXF), select the "Drastic Many" file filter to force the MediaReactor Workstation plugin to be used.
To export a file, from the Output area, add a single node. Press the Play button (the circle with a triangle) to go to the output page. Click the Insert... button, and select the output type from the Drastic SPA Plug Ins. Adjust the parameters, and click the Process Range button to export.

Avid Media Composer 6 (Symphony, NewsCutter)

To bring a file into the editor, right click on the bin and select the Link To AMA Files… menu and select the file. This menu is also available under the File menu. If your source files are on a network drive, you need enable this in Media Composer. Open a Console window (menu Tools | Console) and type 'alldrives' without the quotes and hit Return. This only needs to be done once.

Compressor

To convert from an MRWS file, create an output profile and drag the source file on top of the output profile and drop it.

Motion

To use an MRWS file in Motion, simply use the built in browser to find and select the file. Supported files will appear as a picture of one of the frames in the browser.

Adobe Media Encoder

To add an MRWS file, use the menu File | Add, or drop the file on the application.
To convert to a supported output file, once the input file is chosen an entry will appear for it in the interface. Click on the Format or Preset column link to change the output type.

QuickTime Player

To open a file in QuickTime Player (free or full version), select the File | Open File menu. In Windows you have to set the file filter to all (*.*) to see non mov/avi files.
To export a file from QuickTime Player (requires full version), select the menu File | Export... In the export dialog, select the output type and options. Type in the file name and extension to save to.

Windows Media Player

To open a file in Windows Media Player, select the File | Open menu, or drag and drop the file on the Player.