Skip to content

Release Notes: v0.8.0

Release Date: 2026-05-02

Highlights

  • CLI Tool: Command-line interface for speech-to-text transcription
  • Canonical Transcript Format: Re-exported from omnivoice-core for unified imports

New Features

CLI Tool

OmniVoice now includes a CLI for transcription without writing code:

# Install
go install github.com/plexusone/omnivoice/cmd/omnivoice@latest

# Basic transcription
export DEEPGRAM_API_KEY="your-api-key"
omnivoice transcribe podcast.mp3

# JSON output with full metadata
omnivoice transcribe -p deepgram --diarize --timestamps -f json -o transcript.json podcast.mp3

# Generate subtitles
omnivoice transcribe -p deepgram -f srt -o subtitles.srt podcast.mp3

Commands

Command Description
transcribe Transcribe audio files to text
providers list List available STT providers

Output Formats

Format Description
text Plain transcript text (default)
json OmniVoice Transcript format with full metadata
srt SubRip subtitles
vtt WebVTT subtitles

See the CLI Guide for full documentation.

Transcript Format

The canonical Transcript format is now available in omnivoice:

import "github.com/plexusone/omnivoice"

// Create transcript from transcription result
transcript := omnivoice.NewTranscript(result, "deepgram", "nova-2", "audio.mp3", config)

// Save to JSON (durations as milliseconds)
err := transcript.SaveJSON("output.transcript.json")

// Load from JSON
loaded, err := omnivoice.LoadTranscript("output.transcript.json")

Type Aliases

Type Description
Transcript Full transcription with metadata
TranscriptSegment Segment with timing
TranscriptWord Word with timing
TranscriptMetadata Provider provenance
TranscriptOptions Transcription options

Schema Package

Embedded JSON Schema for validation:

import "github.com/plexusone/omnivoice/schema"

schemaJSON := schema.TranscriptV1Schema

Dependencies

  • github.com/plexusone/omnivoice-core v0.8.0 → v0.9.0
  • Canonical Transcript format with DurationMilliseconds
  • Embedded JSON Schema

Installation

go get github.com/plexusone/omnivoice@v0.8.0

Migration Guide

From v0.7.1

No breaking changes. New features are additive:

  1. CLI: Install with go install github.com/plexusone/omnivoice/cmd/omnivoice@latest
  2. Transcript types: Import from github.com/plexusone/omnivoice (re-exported from omnivoice-core)
  3. Schema: Import from github.com/plexusone/omnivoice/schema

Full Changelog

See CHANGELOG.md for the complete list of changes.