Skip to content

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rekord

A Go TUI application for real-time meeting transcription using local speech-to-text. Works with any meeting application by capturing system audio.

Features

  • Captures system audio using PulseAudio/PipeWire monitor sources
  • Works with any meeting application (Zoom, Meet, Teams, Discord, etc.)
  • Fully local transcription using CrispASR with the Parakeet TDT model - no API calls, no data sent anywhere
  • Real-time transcription display with audio level visualization
  • Save transcripts to text files
  • Beautiful TUI interface built with Bubble Tea

Screenshot

Installation

curl -fsSL https://git.marut.network/exler/rekord/raw/branch/main/install.sh | bash

This builds CrispASR and rekord into ~/.rekord. It reports any missing dependencies but never installs them — that is your package manager's job.

Dependencies

Install these before running the script:

# Fedora
sudo dnf install git cmake golang curl pipewire-pulseaudio gcc-c++ make openblas-devel

# Ubuntu/Debian
sudo apt install git cmake golang curl pulseaudio-utils build-essential libopenblas-dev

# Arch Linux
sudo pacman -S git cmake go curl pulseaudio-utils base-devel openblas

openblas is optional, but ggml picks it up at build time and it measurably speeds up Parakeet's encoder — installing it later means rebuilding CrispASR.

The Parakeet model (~400 MB) downloads automatically the first time you run rekord.

Building manually

git clone https://github.com/exler/rekord
cd rekord
go build -o rekord ./cmd/rekord

rekord itself is pure Go, but it needs a crispasr binary at runtime — either on your PATH, at ~/.rekord/bin/crispasr, or pointed at by CRISPASR_PATH.

Usage

# Run with default settings (uses default audio monitor and the Parakeet model)
rekord

# Specify a different model
rekord -model ~/.rekord/models/parakeet-tdt-0.6b-v3-q8_0.gguf

# Specify a specific audio device
# Use `pactl list sources short` to find the correct monitor source for your system
rekord -device alsa_output.pci-0000_00_1f.3.analog-stereo.monitor

Development

go run cmd/rekord/main.go

Configuration

Environment variables:

  • CRISPASR_PATH: Path to the crispasr executable (default: ~/.rekord/bin/crispasr, then PATH)

Command-line flags:

  • -model: Path to the model file (downloaded automatically if missing)
  • -device: Audio device name (use pactl list sources short to list)
  • -output: Output directory for saved transcripts

License

Rekord is under the terms of the MIT License, following all clarifications stated in the license file.

About

🎙️ Local, privacy-focused real-time meeting transcription app

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages