# Install yap with Homebrew, MacPorts, Nix On-device audio transcription using Speech.framework. Version 1.2.0 via Homebrew; verified 2026-05-12. ## Install ```sh sudo av install brew:yap ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install yap ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install yap ``` Evidence: MacPorts ports tree: lang/yap/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Nix (92%): ```sh nix profile install nixpkgs#yap ``` Evidence: nixpkgs package indexes: pkgs/by-name/ya/yap/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:yap - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.2.0 - **Source summary:** On-device audio transcription using Speech.framework - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** CC0-1.0 - **Source archive:** - **Last updated:** 2026-05-12T09:42:20+01:00 - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - yap (cli) - yap (alias) ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_tahoe ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.2.0 - Package-manager updated: 2026-05-12 - Local data: ok - Upstream repository: https://github.com/finnvoor/yap - Upstream latest detected: 1.2.0 (current) ## Project history and usage yap is a small macOS command-line transcription tool built around Apple's Speech.framework. It turns local audio, video, microphone input, or live system audio into text, subtitle formats, or JSON without sending the core speech-recognition work to a hosted service. ### Project history The public repository was created on 2025-06-15, the same day the first GitHub release, 1.0.0, was published. Its README frames the project around macOS 26 and Apple's on-device Speech.framework, which places it in the wave of local-first media and AI-adjacent command-line tools that appeared as operating systems exposed better speech APIs. By early 2026 the project had added real-time workflows beyond one-shot file transcription: the README documents `listen` for system audio, `dictate` for microphone input, and `listen-and-dictate` for mixed meeting-style transcription. ### Adoption history yap's adoption story is still young and mostly package-manager/toolbox adoption rather than platform adoption. Its upstream README lists Homebrew and Mint installation, and the GitHub repository had more than a thousand stars by July 2026, enough signal for a niche macOS CLI but not enough history for a long institutional narrative. ### How it is used Users run `yap transcribe` or the shorter `yap ` style workflows to convert audio or video to text, SRT, WebVTT, or JSON. The README also shows package-nerd-friendly pipelines: downloading audio with yt-dlp, piping transcripts into an LLM, or producing caption files for video. The live modes make it useful as a terminal-native dictation and meeting transcription tool, with macOS Screen Recording and Microphone permissions as the practical trust boundary. ### Why package nerds care yap is significant as a thin, scriptable wrapper over a native macOS speech-recognition stack. For package nerds, the interesting part is not a new speech model but the packaging of platform speech APIs into composable Unix-style commands and text/subtitle outputs. ### Timeline - 2025-06-15: GitHub repository is created and release 1.0.0 is published. - 2026-02-15: Release 1.2.0 is published. - 2026: README documents file transcription, live system audio transcription, microphone dictation, and combined listen-and-dictate workflows. ### Related projects - Apple Speech.framework is the native macOS speech-recognition API used by yap. - yt-dlp and llm appear in upstream examples as common pipeline companions. ### Sources - - - - ## Security Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** yap - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Requirements:** macos, xcode - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - yap: normalized package name match | nixpkgs package indexes: pkgs/by-name/ya/yap/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - MacPorts - yap: normalized package name match | MacPorts ports tree: lang/yap/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [waon](https://www.automicvault.com/pkg/brew/waon/) - Shares av.db curated category or tags: audio, cli, media, transcription. - [openai-whisper](https://www.automicvault.com/pkg/brew/openai-whisper/) - Shares av.db curated category or tags: audio, cli, media, speech-recognition, transcription. - [cmu-pocketsphinx](https://www.automicvault.com/pkg/brew/cmu-pocketsphinx/) - Shares av.db curated category or tags: audio, cli, media, speech-recognition. - [distill-cli](https://www.automicvault.com/pkg/brew/distill-cli/) - Shares av.db curated category or tags: audio, cli, media, transcription. - [julius](https://www.automicvault.com/pkg/brew/julius/) - Shares av.db curated category or tags: audio, cli, media, speech-recognition. - [a52dec](https://www.automicvault.com/pkg/brew/a52dec/) - Shares av.db curated category or tags: audio, cli, media. - [abcde](https://www.automicvault.com/pkg/brew/abcde/) - Shares av.db curated category or tags: audio, cli, media. - [adplay](https://www.automicvault.com/pkg/brew/adplay/) - Shares av.db curated category or tags: audio, cli, media. - [whisperkit-cli](https://www.automicvault.com/pkg/brew/whisperkit-cli/) - Local package facts share a topical domain. Shared terms: cli, device, media, on-device, recognition. ## Combined YAML source View the package source record on GitHub. [combined/yap.yml](https://github.com/automic-vault/db/blob/main/combined/yap.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph