whisper-transcribe

Transcribe Korean audio lectures to text using Whisper on Colab GPU or local CPU.

Updated Jun 15, 2026
One-click install
npx skills add https://github.com/kmjy98-sketch/khulaw --skill whisper-transcribe-kmjy98-sketch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: whisper-transcribe
Source: https://github.com/kmjy98-sketch/khulaw/tree/main/.agent/skills/whisper-transcribe
Command: npx skills add https://github.com/kmjy98-sketch/khulaw --skill whisper-transcribe-kmjy98-sketch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Converting recorded lectures and audio files into searchable Korean text is slow and error-prone when done manually, and local CPU transcription of long recordings can take hours. This Skill automates speech-to-text transcription and the entire post-processing pipeline so transcripts become split, indexed, and progress-tracked study material. ## Core Features & Use Cases - Colab GPU Transcription: Runs faster-whisper large-v3 on a free T4 GPU via a Colab notebook, transcribing a 1.5-hour lecture in about 5 minutes. - Local Transcription: Uses whisper.cpp (ggml-small model) through transcribe.bat for single files or transcribe_batch.bat for whole folders, producing .txt output next to the source audio. - Automated Post-Processing: post_transcribe.py detects new transcripts, splits them into parts, re-indexes the qmd law-notes vector collection, updates study progress, and archives processed files with a JSON transcription log. - NotebookLM Extraction: extract_notebooklm.py pulls the main Korean transcript text out of saved NotebookLM HTML files. - Use Case: Upload a recorded civil law lecture to the inbox folder, run the Colab notebook, then execute the post-processing script to get a split, vector-indexed transcript with progress tracking updated automatically. ## Quick Start Upload your audio file to the 녹음 inbox folder and ask the assistant to transcribe the lecture and run the post-processing pipeline.

Frequently Asked Questions about whisper-transcribe

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

FAQPage Schema
How do I transcribe Korean lecture audio with Whisper?▼

Upload the recording to the designated inbox folder and run the provided Colab notebook with a GPU runtime, which uses faster-whisper large-v3. Alternatively, run transcribe.bat locally with the whisper.cpp ggml-small model for CPU-based transcription.

What audio formats does Whisper transcription support?▼

The local batch scripts support mp3, wav, m4a, mp4, webm, and wma files. Output is written as a .txt transcript file in the same folder as the source audio.

Colab GPU vs local CPU Whisper transcription, which is faster?▼

Colab with faster-whisper large-v3 on a free T4 GPU transcribes a 1.5-hour lecture in about 5 minutes with higher Korean accuracy. Local whisper.cpp with the small model takes roughly 30 minutes per hour of audio on CPU.

How do I extract a transcript from a saved NotebookLM HTML file?▼

Run extract_notebooklm.py on the HTML file or its folder. The script strips tags, finds the longest Korean text block over 500 characters, and saves it as a formatted _transcript.txt file.

Why is my transcript not being processed by the post-processing script?▼

post_transcribe.py skips files already recorded in transcription_log.json, including canonical name variants, to avoid duplicates. Check the log file or use --dry-run to see which transcripts are detected as new.

Can I run the transcription pipeline without a GPU?▼

Yes, the local path uses whisper.cpp with the ggml-small model on CPU via transcribe.bat or transcribe_batch.bat. It is slower and less accurate than the Colab large-v3 option but requires no cloud access.