apx-transcribe

Transcribe audio and video files to text via the APX daemon's speech-to-text engine.

6|1|Updated May 8, 2026
One-click install
npx skills add https://github.com/agentprojectcontext/apx --skill apx-transcribe-agentprojectcontext
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apx-transcribe
Source: https://github.com/agentprojectcontext/apx/tree/main/src/core/runtime-skills/apx-transcribe
Command: npx skills add https://github.com/agentprojectcontext/apx --skill apx-transcribe-agentprojectcontext

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning voice notes, audio clips, and video recordings into text usually means spinning up a separate Whisper process or writing custom HTTP calls. This Skill exposes the APX daemon's preloaded speech-to-text engine through a single CLI command, so transcription is fast, scriptable, and consistent. ## Core Features & Use Cases - File and folder transcription: Transcribe single files, multiple files, or entire folders of audio (webm, ogg, opus, m4a, aac, mp3, wav, flac) and video (mp4, mov, mkv, avi, and more), with ffmpeg extracting audio tracks automatically. - Provider routing: Choose between the local embedded Whisper (MLX on Apple Silicon, faster-whisper on NVIDIA, CPU otherwise), OpenAI's cloud Whisper, or any OpenAI-compatible custom STT endpoint via the --provider flag. - Scriptable output: Get clean transcripts on stdout for piping, or structured JSON with language, backend, and model fields via --json. - Use Case: You receive a folder of Spanish voice notes from a meeting. Run a bulk transcription with the language pinned to Spanish and pipe the JSON output into your notes pipeline. ## Quick Start Ask the agent to transcribe the file 'nota.oga' into text using the apx transcribe command.

Frequently Asked Questions about apx-transcribe

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

FAQPage Schema
How do I transcribe an audio file to text from the command line?▼

Run apx transcribe followed by the file path, such as apx transcribe nota.oga, and the transcript prints to stdout. You can pass multiple files or a whole folder, and add --json for machine-readable output.

Can I transcribe a video file directly without extracting audio first?▼

Yes, pass the video file directly to apx transcribe. The daemon uses ffmpeg to probe the container and extract the audio track automatically, so formats like mp4, mov, mkv, and avi work without pre-processing.

What audio formats does Whisper transcription support?▼

Supported audio formats include webm, ogg/oga, opus, m4a, aac, mp3, wav, and flac. Because ffmpeg probes the actual bytes, even a mislabelled file extension still transcribes correctly.

Local Whisper vs OpenAI cloud transcription, which should I use?▼

The local provider runs embedded Whisper on MLX (Apple Silicon), faster-whisper (NVIDIA), or CPU with no API key needed. The openai provider uses cloud whisper-1 and requires OPENAI_API_KEY. The default auto routing tries local first and falls back to OpenAI.

Is there a length limit for transcribing long recordings?▼

Yes, each request accepts media up to 20 minutes long. Bulk runs process files sequentially because the local model is single-instance, and the run continues past failed files while exiting non-zero if any failed.