Skip to main content
Glama

taktcut

Clean-room OpenTimelineIO interchange, ASC CDL / .cube color pipeline, deterministic FFmpeg/NVENC rendering, and broadcast QA toolkit with local Web Studio GUI, CLI, and MCP server.

taktcut inspects .drp, .drt, .fcpxml, and .otio/.otioz exports, bakes ASC CDL grades into .cube 3D LUTs, renders Rec.709 deliverables via FFmpeg/NVENC, and runs an EBU R128 + faststart QA gate from the Web Studio GUI, CLI, or MCP without opening a desktop NLE.

taktcut Web Studio GUI

Why taktcut

Workflow

Proprietary paywalls

taktcut (MIT)

Headless & visual timeline inspection

DaVinci Resolve Studio ($295) requires an active desktop GUI session for scripting

Clean-room .drp, .drt, .fcpxml, and .otio/.otioz parser with exact RationalTime frame math & Web Studio viewer

Color look baking & Rec.709 delivery

Desktop NLE lock-in (Premiere Pro $22.99/mo, Resolve Studio $295)

ASC CDL v1.2 studio & XML parser, 33-point .cube 3D LUT baker, and FFmpeg lut3d Rec.709 render plans

Broadcast loudness & streaming QA

Manual NLE export checks or paid QC suites

Automated ffprobe CFR/faststart check, ebur128 loudness audit, and start/mid/end frame verification

CI & agent integration

Closed desktop plugins

Scriptable CLI, loopback Web Studio (taktcut ui), and stdio JSON-RPC MCP server

Related MCP server: free-video-edit-mcp

Clean-Room & Security Guarantee

  • Zero binary inspection, decompilation, or symbol extraction from proprietary NLE executables.

  • Zero DRM or license bypasses.

  • Operates strictly on user-exported project/timeline/color files and open standards (ZIP, defusedxml XML parsing, ASWF OpenTimelineIO, ASC CDL, Adobe .cube LUTs, FFmpeg, EBU R128).

  • taktcut ui binds strictly to loopback (127.0.0.1), enforces strict Content-Security-Policy, and confines every workspace path via realpath.

Requirements

  • Python 3.10+

  • ffmpeg and ffprobe on PATH (for rendering and Broadcast QA Gate)

Installation

git clone https://github.com/eldertek/taktcut.git
cd taktcut
pip install -e ".[dev]"

Quickstart: Web Studio GUI

Launch the local dark studio interface (EN/FR toggle included) confined to your project directory:

taktcut ui --workspace-dir /path/to/your/project
# or standalone command:
taktcut-ui --workspace-dir /path/to/your/project

Inside the browser (http://127.0.0.1:8741/):

  1. Timeline & OTIO: Load a .drp, .drt, .fcpxml, .otio/.otioz file or click Load Sample Timeline, inspect rational frames & validation issues on the multi-track canvas, and export .otio/.otioz.

  2. Color & CDL LUT: Adjust Slope/Offset/Power/Saturation with live Rec.709 before/after split preview & vectorscope, then bake and download 3D .cube LUTs.

  3. Render & FFmpeg: Probe NVENC/CPU encoders, build deterministic Rec.709 commands (--dry-run or execute), and apply active studio LUTs & LUFS normalization.

  4. Broadcast QA Gate: Run ffprobe CFR/faststart, EBU R128 loudness, and start/mid/end frame luminance verification with instant pass/fail gauges.

See the full visual walkthrough in Web Studio GUI Guide (EN) | Guide Interface Graphique (FR).

Quickstart: CLI

Inspect, validate, and convert a .drp / .drt, .fcpxml, or .otio timeline:

taktcut inspect timeline.drt
taktcut validate timeline.fcpxml
taktcut convert timeline.drt --out sequence.otio

Bake an ASC CDL grade into a 33-point .cube 3D LUT and build a Rec.709 render plan:

taktcut bake-lut --out look.cube --slope 1.05 1.0 0.96 --power 0.98 0.98 1.0 --sat 1.12
taktcut render input.mov --out delivery.mp4 --profile web_h264 --lut look.cube --lufs -14 --dry-run

Run the broadcast QA gate (ffprobe + ebur128 + moov-before-mdat faststart + start/mid/end frame verification):

taktcut qa delivery.mp4 --lufs -14 --max-tp -1.0

Quickstart: MCP Server (stdio)

Start the MCP server over stdio:

taktcut mcp

Exposed MCP tools:

  • drp_inspect: Parse .drp, .drt, .fcpxml, or .otio/.otioz timelines and metadata.

  • drp_to_otio: Convert .drp, .drt, or .fcpxml timelines into OpenTimelineIO (.otio or .otioz).

  • timeline_validate: Check integer-frame continuity, gaps, overlaps, and framerate parity.

  • lut_bake_cdl: Bake ASC CDL parameters (slope, offset, power, saturation) into a 3D .cube LUT.

  • grade_apply_lut: Render a graded clip using a .cube LUT or ASC CDL with Rec.709 tags.

  • render_plan: Build (and optionally execute) a deterministic FFmpeg/NVENC/libx264/prores_ks render plan.

  • qa_probe_loudness: Measure EBU R128 integrated loudness (LUFS), LRA, and true peak (dBTP).

  • qa_verify_media: Run the full ffprobe + ebur128 + faststart + multi-timestamp frame QA gate.

Documentation

v0.1 Scope and Known Limitations

  • .drp / .drt XML inspection targets timeline tracks, clip timing, framerates, and metadata; proprietary Fusion node graphs, Fairlight DSP plugins, and third-party OFX effects are not rendered.

  • Color pipeline covers ASC CDL and 1D/3D .cube LUTs in Rec.709; full OpenColorIO ACES config graphs are not bundled in v0.1.

  • Hardware encoding (h264_nvenc / hevc_nvenc) requires an NVIDIA GPU and an NVENC-enabled FFmpeg build; otherwise taktcut falls back to libx264 (--no-hw forces CPU encoding).

Development & Tests

ruff check src tests
mypy
pytest -v

Commercial Support & Custom Pipelines

Need custom post-production automation, CI media pipelines, or dedicated maintenance? See Eclipse Technology Open Source Pro.

License

MIT License. See LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables agents to drive a local explanatory-video lab over stdio: inspecting and patching declarative scenes and a multilayer timeline (clips, titles, captions, voice, music), querying media and frames, rendering previews, running recoverable jobs, and exporting bundles. It also handles Kdenlive round-trip sync plus checkpoints, undo and restore, all offline with JSON responses.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to perform deterministic FFmpeg video edits—silence removal, vertical reframing, 3D LUT grading, and metadata/audio extraction—and generate native CapCut Desktop drafts, with a local web studio for previewing and batch processing.
      5
      1
      MIT