Voice-powered transcription — local or cloud, always private.

---

Install

Linux (one-click):

curl -fsSL https://raw.githubusercontent.com/theguy000/QuillScribe/main/install.sh | bash

The installer uses the native Linux tarball by default and writes install metadata so QuillScribe can safely perform in-app updates. If the tarball is unavailable, it falls back to the AppImage.

To force a specific Linux package format:

curl -fsSL https://raw.githubusercontent.com/theguy000/QuillScribe/main/install.sh | QUILLSCRIBE_INSTALL_FORMAT=appimage bash
curl -fsSL https://raw.githubusercontent.com/theguy000/QuillScribe/main/install.sh | QUILLSCRIBE_INSTALL_FORMAT=tarball bash

Windows / Manual download: Latest Release

---

Features

• Local & cloud transcription — Whisper models offline, or OpenAI / Groq APIs
• Global hotkey — Record from any application
• Flexible output — Clipboard, auto-type, or both
• Floating overlay — Always-on-top recording timer
• System tray — Background mode with quick-access menu
• History — Browse and search past transcriptions
• 12 themes — 6 light + 6 dark
• Auto-updates — Seamless OTA for installer-managed Linux tarball installs and supported desktop platforms

Tech Stack

Slint · Rust · whisper.cpp · cpal

Development

Prerequisites

• Rust ≥ 1.77.2
• System deps: libxcb-shape0-dev libxcb-xfixes0-dev libxkbcommon-dev libgl1-mesa-dev (Linux)
• CMake & Clang (for whisper.cpp build)

Quick Start

cargo run

Build

cargo build --release

Lint

cargo fmt --check
cargo clippy -- -D warnings

Architecture

Slint UI rendered via FemtoVG, Rust backend for audio, transcription, and system integration. Direct Rust callbacks (no IPC layer).

TODO: If QuillScribe becomes popular enough to justify the maintenance cost, reduce idle memory usage by splitting the always-running background service from the on-demand GUI and lazy-loading heavier audio, transcription, and networking components.

Module	Role
audio.rs	Microphone capture, device enumeration
whisper.rs	Model management, transcription
commands.rs	Command handlers
config.rs	Settings persistence
output.rs	Clipboard & auto-type
tray.rs	System tray
hotkey.rs	Global shortcuts
window.rs	Window & overlay management

License

MIT