A small macOS and Windows dictation app with global hotkeys, ASR transcription, and optional LLM cleanup.
中文 README · Latest Release · Features · Quick Start
BoltScribe is a desktop voice input app for macOS and Windows. Press a global hotkey to record, press it again to stop, and BoltScribe transcribes your speech, optionally cleans it up with an OpenAI-compatible model, and inserts the result into the active app.
It runs as a lightweight tray/menu bar app, keeps data on your machine, and provides history, logs, and input statistics for reviewing past dictation.
- Hotkey dictation: start and stop voice input from anywhere on macOS or Windows.
- ASR plus correction: transcribe speech with Volcengine ASR and optionally refine the text with an LLM.
- Flexible model setup: use OpenAI-compatible providers, save model presets, and run multi-model race mode.
- Local history: review previous recordings, transcripts, corrected text, logs, and input statistics.
- Tray workflow: keep BoltScribe in the background, start/stop voice input from the tray menu, and optionally use single-click recording on Windows.
- Reliable microphone selection: blacklist unusable devices, rank preferred microphones, and automatically fall back when a candidate cannot capture valid audio.
- Configurable local data: keep the default local data folder or migrate history, stats, and recordings to a custom empty directory from Settings.
- Responsive capsule overlay: the recording capsule is positioned without slow focused-element queries on macOS.
- Bilingual interface: switch between Chinese and English.
BoltScribe is built with Tauri, React, TypeScript, and Rust. The React frontend lives in src; the Tauri backend lives in src-tauri/src.
The latest public release is BoltScribe v1.3.0.
Available artifact:
- macOS Apple Silicon:
BoltScribe_1.3.0_aarch64.dmg - Windows x64:
BoltScribe_1.3.0_x64-setup.exe
- Supported platforms: macOS 11 or later, or Windows 10/11.
- Node.js and npm.
- Rust toolchain.
- Tauri build prerequisites for your platform.
- Windows builds require WebView2 Runtime and Visual Studio 2022 Build Tools with the C++ workload.
- Volcengine ASR credentials.
- An OpenAI-compatible LLM endpoint and API key if LLM correction is enabled.
npm installnpm run tauri devnpm run tauri buildRelease bundles are generated under:
src-tauri/target/release/bundle/
Before packaging a public build, run:
npm run version:checkBoltScribe stores user configuration in:
~/.boltscribe/config.json
The repository includes starter configuration files:
config.default.json
config.example.json
Configuration covers ASR, LLM providers, correction templates, language, audio input device selection, overlay position, history retention, and system integration.
Mouse-button shortcuts are available on Windows. On macOS, use keyboard global shortcuts.
BoltScribe needs Microphone permission to record speech. On macOS, it also needs Accessibility permission to insert text into the active app. On Windows, text insertion uses the clipboard and a synthetic paste shortcut.
Runtime data stays on the local machine:
~/Library/Application Support/BoltScribe/history.jsonl
~/Library/Application Support/BoltScribe/input_stats.jsonl
~/Library/Application Support/BoltScribe/recordings/
%APPDATA%\BoltScribe\history.jsonl
%APPDATA%\BoltScribe\input_stats.jsonl
%APPDATA%\BoltScribe\recordings\
You can move the data directory from Settings. BoltScribe migrates existing history, input stats, and recordings into the selected empty directory and stores the custom directory pointer in:
~/.boltscribe/data_dir.txt
History retention defaults to:
- at most 500 records;
- at most 2 GB of recorded audio/history storage.
Common checks:
npm run build
cargo test --manifest-path src-tauri/Cargo.toml
cargo clippy --manifest-path src-tauri/Cargo.toml -- -D warnings
cargo fmt --manifest-path src-tauri/Cargo.toml -- --checkBoltScribe is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License. Commercial use is not permitted.