# finnvoor/yap

🗣️ A CLI for on-device speech transcription using Speech.framework on macOS 26

Repository: https://github.com/finnvoor/yap
Canonical: https://ross.abutalabs.com/products/yap
Language: Swift
License: CC0-1.0
License Family: permissive
Last push: 2026-07-20T09:01:40+00:00

## Health v2 (maintenance only)
Score: 81/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 93, release rhythm 93, longevity 31
- inputs: {"age_days": 444, "days_push": 44, "days_rel": 44, "gap_med": 5, "n_releases_24m": 10}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1586, forks 65 (observed 2026-08-28T04:05:07.703386+00:00)

## What it is
yap is a Swift CLI for on-device speech transcription of audio and video files using Apple's Speech.framework on macOS 26. It also supports live transcription of system audio and outputs plain text, SRT, WebVTT, or JSON with word-level timestamps.

## Use cases
- transcribe audio files to text from the command line
- generate srt captions for a video
- create webvtt subtitles
- transcribe a youtube video after downloading with yt-dlp
- transcribe system audio live
- export transcripts as json with word-level timestamps
- pipe a transcript into an llm for summarization

## When to choose
- you're on macOS 26 and want private, on-device transcription without cloud APIs
- you need subtitle/caption files (SRT/VTT) generated quickly from media files
- you want a scriptable CLI that pipes transcripts into other tools

## When to avoid
- you're on Linux or Windows - it depends on Apple's Speech.framework
- you need speaker diarization or advanced cloud-model accuracy
- you need a GUI transcription tool

## Facets
- artifact type: cli-tool
- maturity: active
- function: speech-recognition, cli, audio-processing, video-processing
- domain: speech-processing, developer-tools, media
- platform: cli
- tags: transcription, subtitles, captions, on-device, speech-framework, apple-intelligence, srt, webvtt, live-transcription, command-line, macos, swift

## Member repositories
- finnvoor/yap (main) score 81

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:07.703386+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:55:28.536191+00:00, confidence not recorded.
  - readme: https://github.com/finnvoor/yap (fetched 2026-08-28T04:05:07.703386+00:00, sha eec905eb3e63)
- Data as of 2026-08-30T08:39:29.467469+00:00.