- Home
- Skills
- Workflow Automation
- RetroConvert: Safe Batch Video to CRT-Ready SD MP4
RetroConvert: Safe Batch Video to CRT-Ready SD MP4
Safely batch-convert video folders into 640x480 CRT-ready MP4s with verification and 4:3 cropping.
$3
Works with the AI Agents you already use
RetroConvert: Safe Batch Video to CRT-Ready SD MP4
Example session with this skill installed
Convert everything on my SD card at /Volumes/RETROTV so it plays on the CRT. The card is almost full.
- Read your context and instructions
- Compiled the retroconvert
Summary
Dry run done on /Volumes/RETROTV. Nothing has been changed yet. 144 files need converting, 375 are already SD and will be left alone, and 2 are broken.
Dry run
| Files | Notes | |
|---|---|---|
| To convert | 144 | 61.2 GB of sources |
| Already SD | 375 | 640x480 or smaller, left alone (no quality loss) |
| Broken | 2 | Unreadable, not deleted. Listed in skipped.txt |
Broken files
Season 02/S02E07.avi(0 bytes)Promos/fall-2004-lineup.mp4(truncated)
Your call before I start
The card is nearly full, so I recommend
in-place: each file is replaced as soon as its new version passes every check (duration within 2%, at most 640x480, no upscale), which frees space as it goes. The alternative, --out ~/Desktop/done --keep-sources, keeps every original but needs about twice the space.
Reply "in place" or "keep originals". I won't touch a file until you do.
Then
- I'll run it in the background with the default job count (your Mac looks idle) and keep it awake.
- I'll report from
runs/<timestamp>/status.tsvwhen it finishes: OK and FAIL counts, space freed, and why anything failed (failures keep their originals). - Re-copy the 2 broken files from wherever they came from; they can't be converted as they are.
Connects securely to your tools. The creator never sees your data.
About this skill
Bulk-converting high-definition video for vintage hardware often results in failed playback or accidental data loss. This skill manages the RetroConvert bash script to safely transcode video folders into CRT-compatible 640x480 MP4 files while protecting your source media.
What it does
- Safety-first transcoding: Executes dry runs to verify file counts and readability before touching a single bit of data.
- Smart cropping: Scales widescreen content to fill 4:3 tubes without letterboxing, while padding extreme aspect ratios to prevent distortion.
- Verification gate: Only deletes source files after confirming the output matches duration, dimensions, and playback standards.
- System optimization: Manages CPU load with background job control and prevents system sleep during long encode queues.
- Resumable workflows: Safely handles interruptions, skipping completed files on restart to save time and compute.
How it works
- Initial Audit: Runs a dry run on the target directory to categorize files as convertible, already SD, or unreadable.
- Strategy Selection: Prompts for a choice between in-place replacement (space-saving) or separate output directory with original retention.
- Queue Management: Configures job counts and priority levels based on current system usage.
- Log Analysis: Parses
status.tsvandfailed.txtpost-run to report successes, specific failures, and recovered disk space.
Frameworks & tools
Requires macOS with ffmpeg and ffprobe installed via Homebrew. Built to interface with the RetroConvert bash script for FieldStation42, Raspberry Pi composite output, and CRT television setups.
Why this beats prompting it yourself
Writing ffmpeg flags for 4:3 cropping and verification is error-prone and often leads to broken aspect ratios or lost files. This skill automates the validation logic that ensures every output file actually plays on vintage hardware before the source is removed.
Use cases
- SD Card Prep: Formatting a full microSD card for a FieldStation42 or Raspberry Pi media box.
- Library Compression: Shrinking high-res archives into low-bitrate SD versions for local playback on old hardware.
- Failure Recovery: Diagnosing unreadable files or ffmpeg errors by analyzing run logs and build artifacts.
- Space Management: Safely replacing large HD files with SD equivalents on storage-constrained devices.
Known limitations
Requires macOS. Does not support hardware acceleration via VideoToolbox to maintain compatibility. High-res sources must be accessible via the local filesystem.
macOS only (bash 3.2, caffeinate). Needs ffmpeg and ffprobe. Software encoding only: VideoToolbox gave no speed gain and broke concurrent jobs. Output is fixed at 640x480 H.264 MP4 for CRTs; it isn't a general-purpose converter.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 5 days ago
Requires