speech-to-text

Transcribe audio files locally using whisper-cpp with Metal GPU acceleration.

9|2|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/DavidTeju/shared-skills --skill speech-to-text-davidteju
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speech-to-text
Source: https://github.com/DavidTeju/shared-skills/tree/main/skills/speech-to-text
Command: npx skills add https://github.com/DavidTeju/shared-skills --skill speech-to-text-davidteju

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Transcribes audio files locally into text using whisper-cpp with Metal GPU acceleration, enabling offline transcription without relying on cloud services.

Core Features & Use Cases

  • Local transcription with whisper-cpp using Metal GPU for fast performance.
  • Supports multiple audio formats and automatic conversion to 16kHz WAV when needed.
  • Output options include plain text, subtitles (srt), and structured JSON for downstream processing.
  • Use Case: transcribing podcasts, interviews, or voice memos for searchable transcripts.

Quick Start

Run the wrapper script to transcribe an audio file by calling ./scripts/transcribe.sh /path/to/audio.ogg using the small model by default.

Frequently Asked Questions about speech-to-text

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

FAQPage Schema
How do I transcribe audio files offline locally?

You can transcribe audio offline locally by running the wrapper script, which uses whisper-cpp with Metal GPU acceleration to process files without cloud services. It automatically converts input formats to 16kHz WAV before transcription.

Can I convert speech to subtitles in SRT format locally?

Yes, you can convert speech to subtitles locally by specifying SRT as the output format. The transcription process supports plain text, SRT, and structured JSON outputs for downstream processing.

Does whisper-cpp require ffmpeg to transcribe audio formats like OGG?

Yes, whisper-cpp requires ffmpeg to transcribe non-WAV audio formats like OGG. Ffmpeg handles the automatic format conversion to 16kHz WAV required before the transcription can begin.

What is the best way to transcribe podcasts and voice memos without cloud services?

The best way to transcribe podcasts and voice memos without cloud services is using local whisper-cpp execution with Metal GPU acceleration. This offline approach ensures privacy while providing fast transcription performance.

Do I need a Metal GPU to run offline transcription with whisper-cpp?

Metal GPU acceleration is used for fast performance during offline transcription with whisper-cpp. You also need to ensure whisper-cpp models are placed in the default path to execute the transcription script successfully.