local-audio-transcriber

Transcribe local audio and video files into Markdown transcripts and SRT subtitles using Whisper.

733|99|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/chujianyun/skills --skill local-audio-transcriber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: local-audio-transcriber
Source: https://github.com/chujianyun/skills/tree/main/skills/media/local-audio-transcriber
Command: npx skills add https://github.com/chujianyun/skills --skill local-audio-transcriber

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mlx-whisper, faster-whisper, and includes scripts (resource) components.

What problem does it solve?

Converting existing recordings, podcasts, meetings, or videos into text usually requires uploading files to cloud services or manually configuring Whisper environments. This Skill transcribes local audio and video files entirely on-device, producing ready-to-use Markdown transcripts and SRT subtitle files.

Core Features & Use Cases

  • Local Whisper Transcription: Runs mlx-whisper on Apple Silicon (Apple GPU via MLX) or faster-whisper on CPU/CUDA machines, with automatic engine and model selection.
  • Markdown and SRT Output: Generates only .md transcripts and .srt subtitles, with language detection, duration, and model metadata included.
  • Batch and Long-Recording Handling: Supports multiple files, output directories, VAD silence filtering, and repetition-loop prevention for long Chinese recordings.
  • Use Case: A user drops a two-hour Chinese meeting recording (meeting.m4a) and asks for the text; the Skill transcribes it locally with whisper-large-v3-turbo-q4 and returns the transcript plus saved Markdown and SRT files.

Quick Start

Use the local-audio-transcriber skill to transcribe my recording.m4a file into Chinese text with Markdown and SRT output.

Frequently Asked Questions about local-audio-transcriber

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

FAQPage Schema
How do I transcribe an audio file to text locally with Whisper?

Run the transcribe.py script with your audio file path, for example with --language zh for Chinese and --print-text to see the output. It produces a Markdown transcript and an SRT subtitle file next to the input by default.

What is the difference between mlx-whisper and faster-whisper?

mlx-whisper runs on Apple Silicon using the Apple GPU via MLX and defaults to whisper-large-v3-turbo-q4, while faster-whisper runs on CPU or CUDA using CTranslate2 with int8 or float16. The script auto-selects MLX on Apple Silicon when available.

Which audio and video formats are supported for transcription?

Supported formats include m4a, mp3, wav, aac, flac, ogg, opus, aiff, wma, webm, mp4, mov, and mkv. If decoding fails, installing or updating ffmpeg usually resolves the issue.

Why does my Chinese transcription repeat the same sentence endlessly?

Repetition loops happen when condition_on_previous_text is enabled on long Chinese recordings. Rerun without that flag (it is disabled by default) and consider using the whisper-large-v3-turbo-q4 model for better accuracy.

Can this transcribe audio without uploading files to the cloud?

Yes, all transcription runs locally on your machine using either MLX on Apple GPU or faster-whisper on CPU/CUDA. No audio is sent to cloud speech recognition services, which keeps sensitive recordings private.

Why is transcription slow on my Mac with OpenAI Whisper?

OpenAI Whisper with --device mps can be extremely slow on M1 machines. Use the MLX engine instead, which runs on the Apple GPU through Metal and is significantly faster on Apple Silicon.