MOTK Media Tools / Guide

Universal VideoCutter, from first marker to finished clips.

The first module has two execution paths. Browser mode is the shortest path for normal media. Companion mode is for large or production-root media. They share the same marker timing and output rules.

Universal VideoCutter showing two synthetic marker ranges and Companion path settings

BROWSER MODE

Cut without uploading the source

  1. Choose a source video. It remains a local browser File; MOTK does not receive it.
  2. Choose or paste markers. Accepted headers include Name/Marker/Description, In/Start/Source In, and Out/End/Source Out.
  3. Confirm the frame rate. Numeric seconds need no conversion; HH:MM:SS:FF uses this value.
  4. Check markers. Invalid ranges stop before processing. Overlapping ranges are reported and preserved intentionally.
  5. Cut locally and save ZIP. Accurate mode re-encodes boundaries; Fast mode may start at the nearest keyframe.

Browser mode currently limits a source to 1.5 GB and a batch to 200 markers to avoid an unsafe memory spike.

COMPANION MODE

Use the same job for large local media

  1. Place the source below the production root configured in MOTK Companion.
  2. Open Large file? Prepare a MOTK Companion job.
  3. Enter the source and output as relative paths, for example incoming/reference.mov and deliveries/clips.
  4. Save the Media Job JSON and run node cap-media-cut.mjs --job cut_x.media-job.json --config companion.json.

Companion rejects absolute paths and parent traversal, refuses general writes below raw and MOTK_ORIGINALS, never overwrites a file, records progress, resumes completed markers, and calculates SHA-256 for every output.

MARKER EXAMPLE

Marker Name,In,Out
shot_010,00:00:00:00,00:00:02:00
shot_020,00:00:02:00,00:00:03:12

At 24 fps this creates a 2-second clip and a 1.5-second clip. Duplicate or filesystem-unsafe names are normalized, and collisions receive a numbered suffix.

Desktop download remains available

The original downloadable VideoCutter is still provided for compatibility. New development starts in MOTK Media Tools because its shared Media Job contract can grow into review, comparison, conversion, QC, and handoff modules without duplicating the safety layer.