# Stt

> Transcribes audio files to text using OpenAI Whisper, optimized for Brazilian Portuguese, with support for common audio formats and timestamped output.

- Skill: `dvcrn/stt` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add dvcrn/stt`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/stt/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML, Coding & Dev Tools, Speech & Audio
- Tags: Audio Transcription, M4a, Mp3, Ogg, Portuguese, Speech To Text, Wav, Whisper
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/dvcrn/stt

---


# Speech-to-Text (STT) Skill

Transcreve arquivos de áudio para texto usando OpenAI Whisper, otimizado para
 português (Brasil).

## When to use

- Converter mensagens de voz ou áudios para texto
- Transcrever áudios do WhatsApp, Telegram, etc.
- Processar formatos: OGG, WAV, MP3, M4A, FLAC, AAC, OPUS
- Obter transcrições com timestamps
- Processar conteúdo em português brasileiro

## Tools

- stt_transcribe: Transcreve um arquivo de áudio específico
- stt_watch: Inicia monitoramento contínuo da pasta inbound
- stt_batch: Processa todos os áudios pendentes de uma vez

## Setup

1. **Instalar dependências:**
```bash
pip install -r requirements.txt
 ```

 2. Instalar FFmpeg (necessário pelo Whisper):
  - Windows: execute install_ffmpeg.cmd ou winget install "Gyan.FFmpeg"
  - macOS: brew install ffmpeg
  - Linux: sudo apt install ffmpeg
 3. Criar pasta de entrada:
```bash
  mkdir -p ../../../media/inbound
```

## Usage

### Transcrever arquivo específico

 ```bash
python stt_processor.py --file /caminho/para/audio.ogg
 ```

### Transcrever todos os áudios pendentes

 ```bash
python stt_processor.py