[solrevdev]

Refs #3, covering the first four items under "Features" in its suggested plan. It is stacked on #11.

Changes

• --format md|txt|srt|vtt writes only the transcript.
  • txt puts one caption per line.
  • SRT and WebVTT keep millisecond cue times from the caption offset and duration.
  • In WebVTT, a literal --> in the text is written as -> so it can't break a cue.
  • With no transcript, stdout is empty and stderr says why. Exit codes match JSON mode.
• --segments adds segments: [{start, end, text}] to the JSON, with times in seconds rounded to the millisecond. Without the flag the field is null, so every document keeps the same keys. The field is opt-in because long videos are already large: transcript is about 2.9× the size of transcriptRaw.
• --list-languages writes {videoId, tracks: [{code, name, isAutoGenerated}]} and exits.
• --proxy <url> accepts http, https, socks4, socks4a and socks5 URLs. Without it, HttpClient's default proxy is kept, which reads HTTPS_PROXY, HTTP_PROXY and NO_PROXY and falls back to the system proxy. This is now documented.
• Conflicting options are usage errors (exit 2). Examples are --format srt --metadata-only and --list-languages --segments.

Verification

• 118 tests pass on net8.0. They cover SRT and VTT golden strings (including 100+ hour cues and --> escaping), segment rounding, blank-caption skipping, track listing, option parsing and conflicts, and a segments array in the golden JSON.
• Live checks:
  • --list-languages on iG9CE55wbtY lists every track.
  • -f srt, -f vtt, -f txt and -f md all produce well-formed output.
  • --segments returns 427 segments.
  • --proxy http://127.0.0.1:9 and HTTPS_PROXY=http://127.0.0.1:9 both fail with "Connection refused", which shows that requests go through the proxy.

Not included

• Richer metadata (chapters, thumbnails). YoutubeExplode doesn't expose chapters, and the 1.1.0 schema already adds channel, date, duration, views and keywords.
• ytx mcp. The plan in Blog post notes: reviewing ytx, NativeAOT and v1.0.8 #7 puts this after an AOT spike, which is feat: NativeAOT builds, benchmarks and packaging #6.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FPou7f8nRjX78T2qR7hTjb