sona-ui-client

Features:

• Start recording on click
• End recording on click/keypress
• Transcribe using local whisper model (to IPA or any Whisper-supported Language)
• Automatically copy transcribed text to clipboard

usage

First install sona from sona repo. Run sona with:

./sona serve model.bin

It will print the port:

{"commit":"dev","port":41911,"status":"ready","version":"dev"}
2026/02/27 20:37:24 listening on 0.0.0.0:41911

Then run this tool with the same port:

./sona-ui-client --port 41911

Installation

linux

go build

automatic hotkey setup

./sona-ui-client --setup --hotkey <Ctrl><Alt>R

manual hotkey setup

1. top right corner
2. settings
3. keyboard
4. keyboard shortcuts
5. custom shortcuts
6. add new
7. name: sona command: /path/to/sona-ui-client --once shortcut: set any key you like for sona

macos

CGO_ENABLED=1 GOOS=darwin go build

automatic hotkey setup

On macos automatic hotkey setup is unsupported. Patches to implement this welcome.

windows

For cross-compilation to Windows on Linux, install the MinGW-w64 compiler:

sudo apt-get install gcc-mingw-w64

Then build:

export GOOS=windows; export GOARCH=amd64; export CGO_ENABLED=1; export CXX=x86_64-w64-mingw32-g++; export CC=x86_64-w64-mingw32-gcc ; go build

automatic hotkey setup

./sona-ui-client.exe --setup --hotkey CTRL+ALT+R