Skip to content

Releases: jdmonaco/vidflow

v0.2.1

03 Mar 01:39
@jdmonaco jdmonaco
v0.2.1
390cf7b

Choose a tag to compare

View all tags
v0.2.1 Latest
Latest

vidflow v0.2.1

Video frame capture and AI transcription pipeline for markdown notes.

Single-package install replaces the separate ytcapture, vidscribe, and vidflow tools.

What's new

  • One install, four commands — uv tool install vidflow provides vidflow, ytcapture, vidcapture, and vidscribe. No more coordinating versions across three repos.

  • Bare video ID input — Pass YouTube video IDs directly (e.g., ytcapture dQw4w9WgXcQ) alongside full URLs.

  • Transcript-aware transcription — YouTube auto-captions are preserved and passed to Claude as context. The model enhances and corrects existing text using visual frame analysis rather than transcribing from scratch.

  • End-to-end pipeline — vidflow youtube URL --transcribe chains frame capture and AI transcription in one step. Works for local files too: vidflow local recording.mp4 --transcribe.

  • Multi-input merge — Capture or transcribe multiple videos into a single output with --merge.

  • XDG config path — Config moved to ~/.config/vidflow/config.yml. Legacy ~/.ytcapture.yml still works with a deprecation notice.

Commands

vidflow youtube <url|id>...    YouTube frame capture
vidflow local <file>...        Local video frame capture
vidflow transcribe <md>...     AI transcription of captured frames
ytcapture                      Standalone YouTube capture
vidcapture                     Standalone local capture
vidscribe                      Standalone transcription

Breaking changes

  • ytcapture CLI converted from Click to argparse. Flag names and behavior are preserved, but programmatic use of Click-specific features (e.g., click.Context) will not work.
  • Import paths changed: from vidscribe import ... → from vidflow.transcribe import ..., from ytcapture import ... → from vidflow.capture import ....

Requirements

  • Python 3.10+
  • ffmpeg, yt-dlp (for capture)
  • ImageMagick (for transcription image resizing)
  • ANTHROPIC_API_KEY (for transcription)

Migration

# Remove old standalone tools
uv tool uninstall ytcapture vidscribe 2>/dev/null

# Install vidflow (provides all commands)
uv tool install vidflow
Assets 2
Loading