apple-compressor

Controls Apple Compressor encoding jobs through its official CLI via a typed Swift MCP.

Updated Oct 15, 2019
One-click install
npx skills add https://github.com/kkkaoru/dotfiles --skill apple-compressor-kkkaoru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-compressor
Source: https://github.com/kkkaoru/dotfiles/tree/main/.agents/skills-stroage/apple-compressor
Command: npx skills add https://github.com/kkkaoru/dotfiles --skill apple-compressor-kkkaoru

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Automating Apple Compressor batch encoding normally requires fragile GUI scripting or unsafe shell command strings. This Skill submits, monitors, and controls Compressor jobs through Executor's Swift MCP using the official compressor CLI with validated argument arrays, eliminating arbitrary shell execution and GUI automation. ## Core Features & Use Cases - Job Submission: Submit encoding jobs with a trusted .cmprstng preset or Apple-bundled .setting, absolute source/output paths, and optional bounded trim ranges (0–86399s start, 1–600s duration). - Status Monitoring & Control: Poll job or batch status via compressor_status (-monitor -once) and explicitly pause, resume, or cancel an exact job/batch ID with compressor_control. - Output Verification: Confirm real encode completion with media_verify_video, audio_measure, and video_frame_measure instead of trusting exit codes or returned IDs. - Use Case: Transcode a ProRes master to H.264 using an approved preset, run a 5-second smoke test first, monitor the batch to native completion, then verify the exported file's duration, frames, and audio levels before delivery. ## Quick Start Submit the video at /Users/me/Movies/source.mov to Compressor using my trusted preset at /Users/me/Presets/h264.cmprstng, output to /Users/me/Movies/Apple-Pro-Apps-Verification, then monitor the job and verify the exported file.

Frequently Asked Questions about apple-compressor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I submit a Compressor encoding job from the command line?

Use compressor_submit with an absolute source path, a trusted .cmprstng preset or Apple-bundled .setting, an existing output directory, and a batch name. The server reserves a unique private output directory and returns the job or batch ID for tracking.

How do I check Compressor job status and progress?

Call compressor_status with the exact job or batch ID, passing job: true for a single job or false for a batch. It uses the CLI's -monitor -once flags with bounded timeouts; schedule follow-up checks only when useful rather than tight polling.

Can I pause, resume, or cancel a Compressor batch job?

Yes, compressor_control supports explicit pause, resume, or cancel of an exact job or batch ID. Cancellation can lose processing work, and there is no cancel-all, reset, repair, or network-sharing tool.

Does a zero exit code mean the Compressor encode finished?

No. Exit zero only means submission succeeded; the response reports completionVerified: false. Confirm native completion status and verify the actual output file's duration, decoded frames, and audio levels before reporting success.

What are the limitations of the Compressor CLI MCP?

It covers one source and one preset per submission and does not expose image-sequence URLs, multi-computer distribution, relabel-in-place, or job-action XML. Preset authoring and UI-only features require the separate apple-pro-apps-ui skill.