Features

• Quick recording trigger using the Fn key
• Copied to both clipboard and to the text box (if applicable)
• Uses whisper turbo via mlx
• Automatic insertion of transcribed text
• Fully offline

Prerequisites

• macOS
• Python 3.10+
• Xcode Command Line Tools (for Swift)

xcode-select --install

Installation

1. Clone the repository:

git clone https://github.com/lansmurf/transcribe.git
cd transcribe

2. Install dependencies:

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

3. Make the script executable:

chmod +x start.sh

Usage

1. Start the application and wait until its ready:

./start.sh

2. Once running:

   • Press and hold the Fn key to start recording
   • Speak clearly into your microphone
   • Release the Fn key to stop recording and trigger transcription
   • The transcribed text will automatically be pasted at your cursor position

3. To exit the application, press Ctrl+C in the terminal.

Troubleshooting

• If you get Swift compiler errors, run xcode-select --install