Skip to content

vaultype/VaulType

Repository files navigation

VaulType Icon

VaulType

Your voice stays private. Text appears at your cursor.

Download Platform Swift License Build


What is VaulType?

VaulType is a privacy-first, macOS-native speech-to-text application that lets you dictate text into any app where your cursor is active — without ever sending your voice to the cloud.

Unlike alternatives that rely on cloud services for full functionality, VaulType runs entirely offline using local AI models:

  • whisper.cpp for speech recognition with Metal GPU acceleration
  • llama.cpp for intelligent text post-processing with local LLMs

The app lives in your macOS menu bar and provides global hotkey-activated dictation with six purpose-built processing modes — from raw transcription to LLM-powered text structuring, grammar correction, and prompt formatting.

Vault = your voice stays locked on your device Type = text appears at your cursor

Key Features

Feature Description
Zero-Network Architecture All speech recognition and LLM processing happens locally. No cloud, no telemetry, no data leaves your Mac.
Dual Local AI Pipeline whisper.cpp (STT) + llama.cpp (LLM) in one app — a unique combination no competitor offers.
Six Processing Modes Raw, Clean, Structure, Prompt, Code, and Custom modes for every use case.
Universal Text Injection Dictate into any macOS app — terminals, browsers, IDEs, Slack, and more.
Voice Commands Launch apps, manage windows, and control your Mac with voice.
App-Aware Context Auto-selects formatting mode based on the active application.
Editable Overlay Review and edit transcribed text in a floating window before injection.
90+ Languages Multilingual support with automatic language detection using Whisper's multilingual models. English-only models available for faster performance.

Tech Stack

Component Technology
UI Framework Swift 5.9+ / SwiftUI / AppKit
Speech Recognition whisper.cpp (C/C++) with Metal acceleration
LLM Inference llama.cpp (C/C++) with Metal acceleration
Audio Capture AVAudioEngine
Text Injection CGEvent API / Clipboard
Local Storage SwiftData
Build System Xcode 15+ / Swift Package Manager / CMake
CI/CD GitHub Actions
Auto-Updates Sparkle
Distribution DMG / Homebrew Cask

Quick Start

Install via Homebrew (recommended)

brew tap vaultype/vaultype
brew install --cask vaultype

Install from GitHub Releases

  1. Download the latest .dmg from GitHub Releases
  2. Open the DMG and drag VaulType to Applications
  3. Launch VaulType from Applications

First Run

  1. Grant Permissions — VaulType will request Accessibility and Microphone permissions
  2. Download a Model — Open Settings and download a Whisper model (recommended: small for balanced speed/accuracy)
  3. Set Your Hotkey — Default is double-tap Fn or hold Right Option
  4. Start Dictating — Press your hotkey, speak, and release. Text appears at your cursor.

💡 For detailed setup instructions, see the Quick Start Guide.

Build from Source

# Clone the repository
git clone https://github.com/vaultype/vaultype.git
cd vaultype

# Build whisper.cpp and llama.cpp
./scripts/build-deps.sh

# Open in Xcode
open VaulType.xcodeproj

# Build and run (⌘R)

See the full Setup Guide for prerequisites and detailed instructions.

Processing Modes

VaulType's dual AI pipeline gives you six modes for different use cases:

Mode What It Does Best For
Raw No LLM processing — inject speech exactly as recognized Quick notes, real-time chat
Clean Fix spelling, grammar, punctuation, capitalization Emails, messages, documents
Structure Format as bullet lists, numbered steps, or tables Meeting notes, outlines
Prompt Reformat speech into clear, well-structured AI prompts Claude, ChatGPT, LLM tools
Code Format as code comments, commit messages, docstrings Development workflows
Custom User-defined prompt templates Anything you need

Project Structure

VaulType/
├── VaulType/                    # Main app target
│   ├── App/                     # App entry point, menu bar
│   ├── Views/                   # SwiftUI views (settings, overlay)
│   ├── Services/                # Core services
│   │   ├── AudioCaptureService  # Microphone + AVAudioEngine
│   │   ├── WhisperService       # whisper.cpp Swift wrapper
│   │   ├── LLMService           # llama.cpp Swift wrapper
│   │   ├── TextInjectionService # CGEvent / clipboard injection
│   │   ├── CommandParser        # Voice command parsing
│   │   └── HotkeyManager       # Global hotkey registration
│   ├── Models/                  # SwiftData models
│   ├── Utilities/               # Helpers, extensions
│   └── Resources/               # Assets, prompt templates
├── WhisperKit/                  # whisper.cpp bridging module
├── LlamaKit/                   # llama.cpp bridging module
├── VaulTypeTests/               # Unit tests
├── VaulTypeUITests/             # UI tests
├── scripts/                     # Build scripts
└── docs/                        # Documentation

Screenshots

Dictation History    Model Management    Menu Bar

How It Compares

Feature VaulType MacWhisper Superwhisper Apple Dictation
Fully Offline Yes Partial Partial Partial
Local LLM Processing Yes No Partial No
Voice Commands Yes No No Limited
Processing Modes 6 1 4+ 1
App-Aware Context Yes No Yes No
Open Source Yes (GPL-3.0) No No No
Price Free $80 $8/mo Free

Documentation

Getting Started

Architecture

Features

Operations

Reference

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

# Fork and clone
git clone https://github.com/YOUR_USERNAME/vaultype.git

# Create a feature branch
git checkout -b feature/your-feature

# Make changes and test
xcodebuild test -scheme VaulType

# Submit a pull request

License

VaulType is licensed under the GNU General Public License v3.0.

Third-party components:

See Legal Compliance for full attribution and licensing details.


VaulType — Privacy-first dictation for macOS.
Your voice. Your Mac. No cloud required.

About

Privacy-first, macOS-native speech-to-text menu bar app. 100% local — whisper.cpp + llama.cpp, no cloud dependencies.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors