Skip to content

calibratedsoftware/tinman-server-cowork

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 

Repository files navigation

README.md

Claude Cowork Plugin for Tin Man Server

A plugin that connects Tin Man Server to Claude Cowork, giving Claude direct access to professional media tools for film and video production workflows.

Supports Blackmagic RAW • RED RAW • ARRIRAW • Sony RAW • Apple ProRes RAW • Canon RAW • Licensed Apple ProRes and Avid DNx • MOV/MXF/MP4 formats • Image Sequences — and more.

Available for macOS and Windows.

Licensing

The verified copy and create thumbnail tools are currently free to use without a license in Tin Man Server. All other tools operate in demo mode without a Tin Man Server license.

Requirements

Installation

  1. Download the .zip for your platform from Releases.
  2. Add the plugin to Claude Cowork.

Tools

tinman-server:scan — Quick scan of a folder or drive. Returns filename, size, codec, resolution, frame rate, duration, and timecode for every clip.

tinman-server:query_metadata — Full metadata extraction. Camera make/model, serial number, firmware, ISO, white balance, tint, shutter angle, lens model, lens serial, aperture, color space, timecode, slate info, and more.

tinman-server:generate_report — Generate formatted clip reports with thumbnails. Supports PDF, HTML, JSON, CSV, and XLSX. Report types include clip reports and contact sheets. Configurable dark mode, Rec 709 tonemapping, custom fields, thumbnail count, and HTML asset folder export.

tinman-server:thumbnail — Generate JPEG thumbnails from media files. Configurable size, quality, number per clip, and Rec 709 tonemapping.

tinman-server:export — Transcode/convert media using 50+ professional presets. ProRes, DNxHD, DNxHR, H.264, H.265, and more. Custom file naming with tokens. Preset overrides for resolution (half, quarter, eighth, max-width, fixed-size), bitrate (H.264/H.265), output colorspace (Rec 709, Rec 709 with tonemapping), and source resizing. Timecode burn-in and metadata burn-in (JSON config supported). GPU export engine support.

tinman-server:copy — Verified file copy. Every file checksummed after copy to guarantee integrity.

tinman-server:cancel — Gracefully stop a running export or copy.

tinman-server:generate_config — Returns the default report configuration template as JSON for customizing reports.

tinman-server:list_export_presets — Lists all 50+ available transcode presets.

Other MCP Clients

To connect Tin Man Server to any MCP-compatible client (Cursor, VS Code, etc.), add the following entry to your client's MCP configuration file.

Windows:

"tinman-server": {
  "command": "C:\\Program Files\\Calibrated Software\\Tin Man\\python\\python.exe",
  "args": ["C:\\Program Files\\Calibrated Software\\Tin Man\\Server\\tinman_server_mcp.cpython-310.pyc"]
}

macOS:

"tinman-server": {
  "command": "/Applications/Calibrated Tin Man.app/Contents/PlugIns/Frameworks/Python.framework/Versions/3.10/bin/python3",
  "args": ["/Applications/Calibrated Tin Man.app/Contents/Server/tinman_server_mcp.cpython-310.pyc"]
}

General Options

These options apply globally to all commands:

  • --gpu-cuda — Use CUDA instead of OpenCL (Windows/NVIDIA only)
  • --gpu-encode — Enable GPU export engine (default: CPU)
  • --rawLog — Set all RAW files to Log
  • --raw709 — Set all RAW files to Rec.709
  • --raw709tonemap — Set all RAW files to Rec.709 with ToneMapping when available
  • --raw2020 — Set all RAW files to Rec.2020
  • --rawHLG — Set all RAW files to Rec.2020/HLG
  • --rawPQ — Set all RAW files to Rec.2020/PQ
  • --rawACES — Set all RAW files to ACES AP0

Knowledge

The plugin also includes built-in knowledge that helps Claude understand professional media workflows:

tinman-server:camera-formats — Camera brands, RAW formats, codecs, colorspaces, log curves, and LUTs.

tinman-server:video-workflows — DIT workflows, on-set data management, dailies, color management, and editorial handoff.

tinman-server:tinman-server-tools — Best practices for using the Tin Man tools effectively.

Links

Packages

 
 
 

Contributors