Video Whisper — Local Video/Audio Transcription

Transcribes video and audio to timestamped text and JSON on Apple Silicon Macs via MLX Whisper.

3|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/ylongw/video-whisper --skill video-whisper-local-video-audio-transcription
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Video Whisper — Local Video/Audio Transcription
Source: https://github.com/ylongw/video-whisper/tree/main
Command: npx skills add https://github.com/ylongw/video-whisper --skill video-whisper-local-video-audio-transcription

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yt-dlp, ffmpeg, and includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the hassle of manually transcribing videos and audio by generating accurate local transcripts you can read, search, and summarize without relying on cloud services.

Core Features & Use Cases

  • Local, Apple Silicon-friendly transcription: Uses MLX Whisper to run entirely on-device on M1/M2/M3/M4 Macs.
  • Works for URLs and local media: Extracts audio from local files and supports major sites (YouTube, Bilibili, Xiaohongshu, Douyin) plus podcasts and other yt-dlp supported sources.
  • Timestamped output for downstream analysis: Produces both plain text and JSON containing per-segment timings and detected language to help with indexing, QA, and summarization.

Use case: Convert a long podcast or creator video into a searchable transcript with timestamps so you can quickly find key moments and generate summaries or notes.

Quick Start

Install yt-dlp and ffmpeg via Homebrew, create a Python venv and install mlx-whisper, then run: bash scripts/transcribe.sh "https://www.youtube.com/watch?v=dQw4w9WgXcQ".

Frequently Asked Questions about Video Whisper — Local Video/Audio Transcription

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

FAQPage Schema
How do I transcribe a YouTube video to text locally on my Mac?

To transcribe a YouTube video to text locally on a Mac, this Skill uses yt-dlp to extract audio and MLX Whisper to generate readable text entirely on-device. You just need to run the transcription script with the video URL to get the text output.

Can I extract audio and transcribe podcasts without uploading to cloud services?

Yes, you can extract audio and transcribe podcasts without cloud services by running MLX Whisper locally. This Skill processes media entirely on Apple Silicon hardware, ensuring private transcription without uploading files.

Do I need yt-dlp and ffmpeg installed to transcribe Bilibili or Douyin videos?

Yes, you need yt-dlp and ffmpeg installed via Homebrew to transcribe Bilibili or Douyin videos. This Skill relies on yt-dlp to download audio from these platforms and ffmpeg for media processing before running the local transcription.

Does local video transcription with Whisper generate timestamps for segments?

Yes, local video transcription with Whisper generates timestamps for segments. This Skill outputs both plain text and JSON files containing per-segment timings and detected language to help with indexing and downstream summarization.

What is the best way to get a searchable transcript from a local video file on Apple Silicon?

The best way to get a searchable transcript from a local video file on Apple Silicon is using MLX Whisper. This Skill extracts audio from local media and runs on-device transcription for M1 through M4 Macs, producing text outputs directly in your local environment.

Why does local transcription require a Python environment with mlx-whisper?

Local transcription requires a Python environment with mlx-whisper because it is the machine learning framework optimized for Apple Silicon. This Skill uses mlx-whisper to run the transcription model efficiently on-device without needing cloud APIs.