Skip to content

TF-2022/hablan

Repository files navigation

Hablan

Dictate text, it appears at your cursor. Open-source desktop voice dictation app with local transcription via Whisper.

Features

  • Global shortcut - Ctrl+Shift+H from any app
  • Local transcription - 100% offline via whisper.cpp, no data sent anywhere
  • Auto-paste - Text appears directly at your cursor position
  • Multi-language - French, English, Spanish, German + auto-detection
  • System tray - Runs in background, always available

Download

Platform Download
Windows Hablan Setup
macOS (Apple Silicon) Hablan.dmg
macOS (Intel) Hablan.dmg

Development

Prerequisites

  • Node.js 20+
  • npm 10+

Setup

git clone https://github.com/TF-2022/hablan.git
cd hablan
npm install
npm run setup    # Downloads whisper.cpp + ffmpeg
npm run dev      # Starts the app in dev mode

Build

npm run dist:win   # Windows NSIS installer
npm run dist:mac   # macOS DMG
npm run dist:all   # Both

Tech stack

  • Electron - Cross-platform desktop framework
  • React + TypeScript - UI
  • Tailwind CSS - Styling
  • whisper.cpp - Local transcription (OpenBLAS, multi-thread)
  • ffmpeg - Audio conversion
  • electron-vite - Build tooling

How it works

  1. Press Ctrl+Shift+H (customizable)
  2. Speak into your mic
  3. Press again to stop
  4. Transcribed text is pasted at your cursor automatically

The Whisper model runs locally. No internet connection required.

License

AGPL-3.0

About

Voice dictation app — speak, transcribe locally with Whisper, paste at cursor. 100% offline, cross-platform.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors