1
0
Fork
You've already forked vosk-tui
0
A simple TUI for vosk
  • Python 99.8%
  • Makefile 0.2%
2026年02月01日 20:21:52 +08:00
tests Improved exit, audio logic 2026年01月29日 08:21:10 +08:00
vosk_tui Moved to package structure 2026年02月01日 20:21:52 +08:00
.gitignore Added timestamp and export 2026年01月28日 21:44:48 +08:00
.python-version WIP code 2026年01月27日 23:58:43 +08:00
LICENSE Added system audio toggle 2026年01月28日 02:12:33 +08:00
Makefile Moved to package structure 2026年02月01日 20:21:52 +08:00
preview.png Added timestamp and export 2026年01月28日 21:44:48 +08:00
pyproject.toml Moved to package structure 2026年02月01日 20:21:52 +08:00
README.md Moved to package structure 2026年02月01日 20:21:52 +08:00
uv.lock Added uv tool install 2026年01月28日 22:21:34 +08:00

bladeacer's vosk tui

Preview Image

A TUI for speech recognition/transcription using Vosk.

Unofficial, not affiliated with VOSK.

Features

  • Download your own model(s), select the one you wish to use
  • Downsampling to 16 kHz for Vosk
  • Timestamped Transcription Logs (max 100 characters per entry)
  • Live preview of text about to be committed to logs
  • Toggle between system audio and microphone. Defaults to microphone.
  • Export current session as log file (appends)

Known issues

  • System audio is currently hard-coded to regex for speaker.
  • No configuration file
  • config.json and transcript.log outputs in CWD you are running it from

Setup

Install with uv

uv tool install git+https://codeberg.org/bladeacer/vosk-tui.git
vosk-tui

The executable will be built as vosk-tui.

Clone repo

Alternatively, you can clone this repository then cd into it.

git clone https://codeberg.org/bladeacer/vosk-tui.git
cd vosk-tui

Running in cloned repo

After cloning, you can chose any of the following for running the TUI.

  1. Use uv sync and uv tool install . or call make install

The Makefile flags are just helpers to perform the same action.

If you are using the script directly, remember to set file permissions if you are not on Windows

Running uv sync and run uv run app.py or calling make run is deprecated

Download Models

Load your model directory directly e.g. vosk-model-en-us-0.22 instead of its parent directory.

Find models to download at https://alphacephei.com/vosk/models/model-list.json.

Avoid models labelled with obsolete: "true"

Small models work better on limited hardware.

Usage

Ctrl Q to quit the app. Textual has the usual niceties.

Tested on Wayland/EndeavourOS, may or may not work on Windows.

Disclaimer

Created with the assistance of an LLM, human in the loop.

Vosk models are optimised for speech, might not work so well on stuff like music.

Contributions

Contributions of any kind are welcome. Do open an issue first before starting work on a pull request.

Credits

Audio Transcript recording taken from Harvard CS50.

License

Unlicense, see LICENSE.