# Tin Man Server Complete command reference for Tin Man Server CLI operations. ### Command Structure ```bash tinman-server [general-options] [command-options] ``` **Note:** Press `Ctrl+C` to cancel any running operation. ### General Options These options must come **before** your input files: | Option | Description | | -------------------- | ------------------------------------------------------ | | `--threads N` | Number of concurrent threads (1-5, default: 1) | | `--progress=no-json` | Output progress as human-readable text instead of JSON | | `--no-recursive` | Don't scan subfolders (default: recursive) | | `--help` | Show help message | | `--version` | Show version information | ### Input Methods | Method | Example | Description | | -------------- | ---------------------------------------------------- | ------------------------------------------------------------ | | Single file | `tinman-server /path/file.R3D ...` | Process one file | | Multiple files | `tinman-server /path/file1.R3D /path/file2.braw ...` | Process multiple files | | Folder | `tinman-server /path/footage/ ...` | Process all supported files in folder (recursive by default) | | File list | `tinman-server @filelist.txt ...` | Text file containing list of files/folders to process | ### Commands #### generate-config Generate a default report configuration file that can be customized and reused. **Options:** * `--output FILE` - Output config file path (required) **Example:** ```bash tinman-server generate-config --output my-config.json ``` *** #### metadata Extract metadata from media files and generate reports in multiple formats. **Options:** | Option | Description | | ------------------- | ------------------------------------------------------------------------------------------- | | `--config FILE` | Filepath to JSON file for report options | | `--output-dir DIR` | Output directory for report files | | `--name REPORTNAME` | Name to use for the report | | `--format FORMAT` | Output format: json, pdf, html, csv, xlsx (default: pdf). Multiple formats can be specified | | `--rec709` | Convert PDF thumbnails to Rec. 709 colorspace | | `--rec709tonemap` | Convert PDF thumbnails to Rec. 709 colorspace with tone mapping when needed | **Examples:** ```bash # PDF report (default) tinman-server /path/footage/ metadata --output-dir /path/reports/ # CSV report tinman-server /path/footage/ metadata --output-dir /path/reports/ --format csv # Multiple formats at once tinman-server /path/footage/ metadata --output-dir /path/reports/ --format csv pdf xlsx # Using custom config file tinman-server /path/footage/ metadata --config my-config.json --output-dir /path/reports/ # With threading tinman-server --threads 3 /path/footage/ metadata --output-dir /path/reports/ --format csv ``` *** #### export Export and transcode media files using system presets or custom preset files. **Options:** | Option | Description | | -------------------- | ---------------------------------------------------------------------------------------------- | | `--list-presets` | List all available system export presets | | `--preset FILE` | Export preset (system preset name or path to custom JSON file) | | `--output-dir DIR` | Output directory for exported files | | `--naming PATTERN` | Naming pattern with tokens: `{source}`, `{date}`, `{timecode}`, `{reel}` (default: `{source}`) | | `--index-prefix STR` | Character before frame number for sequences: `.`, `-`, `_` (default: none) | | `--index-min-size N` | Frame padding 4-12 for sequences (default: auto) | | `--index-offset VAL` | Starting frame: `0`, `1`, `offset`, `tc` (default: 0) | **Examples:** ```bash # List all available presets tinman-server export --list-presets # Export using system preset tinman-server /path/footage/ export --preset mov_prores422_hq --output-dir /path/exports/ # Export using custom preset JSON file tinman-server /path/footage/ export --preset /path/my-preset.json --output-dir /path/exports/ # Export with custom naming pattern tinman-server /path/footage/ export --preset mp4_h264_10mbps --output-dir /path/exports/ \ --naming "{date}_{source}_{timecode}" # Export image sequence with custom frame numbering tinman-server /path/file.R3D export --preset imageseq_dpx_10bit_rgb_be \ --output-dir /path/exports/ --index-prefix "." --index-min-size 6 --index-offset 1 # Export with threading tinman-server --threads 3 /path/footage/ export --preset mov_prores422_hq --output-dir /path/exports/ ``` **System Export Presets** **Image Sequences:** * `imageseq_dpx_10bit_rgb_be` - DPX 10-bit RGB Big Endian * `imageseq_tiff_16bit_rgb` - TIFF 16-bit RGB **MOV - Apple ProRes:** * `mov_prores422_proxy` - ProRes 422 Proxy * `mov_prores422_lt` - ProRes 422 LT * `mov_prores422` - ProRes 422 * `mov_prores422_hq` - ProRes 422 HQ * `mov_prores4444_yuv` - ProRes 4444 YUV * `mov_prores4444_rgb` - ProRes 4444 RGB * `mov_prores4444_xq_yuv` - ProRes 4444 XQ YUV * `mov_prores4444_xq_rgb` - ProRes 4444 XQ RGB **MOV - Avid DNxHR:** * `mov_dnx_lb` - DNxHR LB * `mov_dnx_sq` - DNxHR SQ * `mov_dnx_hq` - DNxHR HQ * `mov_dnx_hqx` - DNxHR HQX * `mov_dnx_444` - DNxHR 444 **MOV - Samsung OpenAPV:** * `mov_apv422_10_sq` - Samsung OpenAPV 422 10-bit SQ * `mov_apv422_10_lq` - Samsung OpenAPV 422 10-bit LQ * `mov_apv422_10_hq` - Samsung OpenAPV 422 10-bit HQ * `mov_apv422_12_sq` - Samsung OpenAPV 422 12-bit SQ * `mov_apv422_12_lq` - Samsung OpenAPV 422 12-bit LQ * `mov_apv422_12_hq` - Samsung OpenAPV 422 12-bit HQ * `mov_apv444_10_uq` - Samsung OpenAPV 4444 10-bit UQ * `mov_apv444_12_uq` - Samsung OpenAPV 4444 12-bit UQ **MOV - Passthrough:** * `mov_passthru` - MOV Passthrough (rewrap without transcoding) **MP4 - H.264:** * `mp4_h264_10mbps` - H.264 10 Mbps * `mp4_h264_20mbps` - H.264 20 Mbps **MP4 - H.265 (HEVC):** * `mp4_h265_main_10mbps` - H.265 Main Profile 10 Mbps * `mp4_h265_main_20mbps` - H.265 Main Profile 20 Mbps * `mp4_h265_main10_10mbps` - H.265 Main10 Profile 10 Mbps * `mp4_h265_main10_20mbps` - H.265 Main10 Profile 20 Mbps **MP4 - H.265 Main 4:2:2 (macOS only):** * `mp4_h265_main422_8bit_10mbps` - H.265 Main 4:2:2 8-bit 10 Mbps * `mp4_h265_main422_8bit_20mbps` - H.265 Main 4:2:2 8-bit 20 Mbps * `mp4_h265_main422_10bit_10mbps` - H.265 Main 4:2:2 10-bit 10 Mbps * `mp4_h265_main422_10bit_20mbps` - H.265 Main 4:2:2 10-bit 20 Mbps **MXF OP-Atom - Avid DNxHR:** * `mxf_opatom_dnx_lb` - MXF OP-Atom DNxHR LB * `mxf_opatom_dnx_sq` - MXF OP-Atom DNxHR SQ * `mxf_opatom_dnx_hq` - MXF OP-Atom DNxHR HQ * `mxf_opatom_dnx_hqx` - MXF OP-Atom DNxHR HQX * `mxf_opatom_dnx_444` - MXF OP-Atom DNxHR 444 **MXF OP-Atom - Passthrough:** * `mxf_opatom_passthru` - MXF OP-Atom Passthrough **MXF OP1a - Apple ProRes:** * `mxf_op1a_prores422_proxy` - MXF OP1a ProRes 422 Proxy * `mxf_op1a_prores422_lt` - MXF OP1a ProRes 422 LT * `mxf_op1a_prores422` - MXF OP1a ProRes 422 * `mxf_op1a_prores422_hq` - MXF OP1a ProRes 422 HQ * `mxf_op1a_prores4444_yuv` - MXF OP1a ProRes 4444 YUV * `mxf_op1a_prores4444_rgb` - MXF OP1a ProRes 4444 RGB * `mxf_op1a_prores4444_xq_yuv` - MXF OP1a ProRes 4444 XQ YUV * `mxf_op1a_prores4444_xq_rgb` - MXF OP1a ProRes 4444 XQ RGB **MXF OP1a - Avid DNxHR:** * `mxf_op1a_dnx_lb` - MXF OP1a DNxHR LB * `mxf_op1a_dnx_sq` - MXF OP1a DNxHR SQ * `mxf_op1a_dnx_hq` - MXF OP1a DNxHR HQ * `mxf_op1a_dnx_hqx` - MXF OP1a DNxHR HQX * `mxf_op1a_dnx_444` - MXF OP1a DNxHR 444 **MXF OP1a - Sony XAVC (Windows only):** * `mxf_op1a_xavchd_intra_interlaced_class100cbg` - XAVC HD Intra Interlaced Class 100 * `mxf_op1a_xavchd_intra_progressive_class100cbg` - XAVC HD Intra Progressive Class 100 * `mxf_op1a_xavc2k_intra_class100cbg` - XAVC 2K Intra Class 100 * `mxf_op1a_xavcqfhd_intra_class300cbg` - XAVC QFHD Intra Class 300 * `mxf_op1a_xavcqfhd_intra_class480cbg` - XAVC QFHD Intra Class 480 * `mxf_op1a_xavc4k_intra_class300cbg` - XAVC 4K Intra Class 300 * `mxf_op1a_xavc4k_intra_class480cbg` - XAVC 4K Intra Class 480 **MXF OP1a - Passthrough:** * `mxf_op1a_passthru` - MXF OP1a Passthrough *** #### thumbnail Generate thumbnail JPEG images with extensive control over size, quality, timing, and naming. **This command is currently free** **Options:** | Option | Description | | ------------------------- | ------------------------------------------------------------------------------- | | `--output-dir DIR` | Output directory for thumbnails (required, created if needed) | | `--size WIDTH` | Max width in pixels, height maintains aspect (120-1024, default: 320) | | `--quality N` | JPEG quality 1-100 (default: 85) | | `--startframe FRAME` | Starting frame number (default: 0, overrides --starttimecode) | | `--starttimecode TC` | Starting timecode (default: first frame) | | `--time-interval SECONDS` | Generate thumbnail every N seconds (default: single frame) | | `--time-count N` | Max number of thumbnails per file (default: 1) | | `--position-count N` | Generate N evenly distributed thumbnails (min: 2, overrides time-based options) | | `--rec709` | Convert thumbnails to Rec. 709 colorspace | | `--rec709tonemap` | Convert thumbnails to Rec. 709 colorspace with tone mapping when needed | | `--usesubdirs` | Create subdirectory per source file (batch mode only) | | `--fileoverwrite` | Overwrite existing thumbnail files (default: skip with error) | | `--nameprefix NAME` | Prefix to add before source filename (default: none) | | `--nameseparator SEP` | Separator: `none`, `dash`, `dot`, `underscore` (default: underscore) | | `--nameindex TYPE` | Index type: `frame`, `timecode`, `sequence` (default: sequence) | **Position-based generation examples:** * `--position-count 3` = 0%, 50%, 100% (start, middle, end) * `--position-count 6` = 0%, 20%, 40%, 60%, 80%, 100% **Examples:** ```bash # Single thumbnail per file at default size (320px) tinman-server /path/footage/ thumbnail --output-dir /path/thumbs/ # Three evenly distributed thumbnails (start/middle/end) tinman-server /path/footage/ thumbnail --output-dir /path/thumbs/ --position-count 3 # Six evenly distributed thumbnails tinman-server /path/footage/ thumbnail --output-dir /path/thumbs/ --position-count 6 # Five thumbnails with 1 second intervals, organized in subdirectories tinman-server /path/footage/ thumbnail --output-dir /path/thumbs/ \ --time-count 5 --time-interval 1.0 --usesubdirs # Custom naming with prefix and timecode index tinman-server /path/file.R3D thumbnail --output-dir /path/thumbs/ \ --nameprefix Dailies --nameindex timecode # High resolution with Rec. 709 Tone-Mapping conversion tinman-server /path/file.braw thumbnail --output-dir /path/thumbs/ \ --startframe 100 --size 1024 --quality 95 --rec709tonemap ``` *** #### copy Copy files with checksum verification. **This command is currently free** **Options:** | Option | Description | | ------------------ | ---------------------------------------- | | `--output-dir DIR` | Destination directory (required) | | `--overwrite` | Overwrite existing files (default: skip) | **Examples:** ```bash # Copy single file with verification tinman-server /path/input.R3D copy --output-dir /path/backup/ # Copy folder preserving structure tinman-server /path/footage/day1/ copy --output-dir /path/backup/day1/ # Copy with threading for speed tinman-server --threads 5 /path/footage/ copy --output-dir /path/backup/ # Overwrite existing files tinman-server /path/footage/ copy --output-dir /path/backup/ --overwrite ``` *** ### Command Chaining Multiple commands can be executed in a single invocation: ```bash # Generate both metadata report and thumbnails tinman-server /path/input.R3D metadata --output-dir /path/reports/ thumbnail --output-dir /path/thumbs/ ``` ### Progress Output By default, Tin Man Server outputs JSON-formatted progress for automation: ```bash # JSON progress (default) tinman-server /path/footage/ metadata --output-dir /path/reports/ # Human-readable progress tinman-server --progress=no-json /path/footage/ metadata --output-dir /path/reports/ ``` The JSON progress output includes file processing status, progress percentage, errors and warnings, operation results, and timing metrics. Progress updates are throttled to 10% increments for batch operations to reduce output volume. ### **Claude Cowork** Tin Man Server also includes a Claude Cowork plugin that exposes all commands through natural language in Claude AI. See the [GitHub repository](https://github.com/calibratedsoftware/tinman-server-cowork) for installation. ### Tips * Press `Ctrl+C` to cancel any running operation * Use `--threads` to process multiple files concurrently (max 5) * The `copy` command is currently free * The `thumbnail` command is currently free * File inputs are processed recursively by default; use `--no-recursive` to process only top-level files