youtube-clip-crop

name	youtube-clip-crop
description	Downloads YouTube audio and crops one or more timestamp ranges to m4a files only — no transcription, normalisation, or articles. Use when the user gives a YouTube URL with start/end times, asks to crop clips, extract audio segments, or says they only want cropped audio.

YouTube clip crop (audio only)

Run every step on the user's Mac. Do not stop at instructions.

Scope: download + crop + deliver m4a files. Do not transcribe, extract text, normalise volume, merge clips, or create articles unless the user explicitly asks.

For the full pipeline (normalise → transcribe → pack), use youtube-clip-transcribe.

Prerequisites

Tool	Check
ffmpeg / ffprobe	ffmpeg -version
yt-dlp	conda python3 -m yt_dlp (homebrew yt-dlp often returns 403)
Output dir	~/praisonai-audio-editor

Parse user input

1. YouTube URL → extract {VIDEO_ID} from watch?v= or youtu.be/
2. One or more ranges — each START → END pair (accept M:SS, H:MM:SS, 1:8:53 = 1:08:53)
3. -to is absolute on the full video timeline (not relative duration)