документація

Довідник: config.json, командний рядок, файли й порти

Усе, що програма читає і пише, для випадків, коли вікна налаштувань не досить: ключі в config.json, прапорці командного рядка, файли в теці і порти, які слухають рушії.

Оновлено 9 вересня 2026 р. · Vitalii Yemets

config.json

Простий текст у теці програми. Редагуйте вручну і натисніть «Перечитати» в розділі System, або нехай вікно запише його само.

dictation

ключщо робитьза замовчуванням

hotkey

The combination that starts a dictation.

"ctrl+win"

hotkey_mode

hold or toggle.

"hold"

language

The language you speak. Decides which model is used.

"auto"

lang_models

Which model serves which language, as a map.

{}

min_record_ms

Shorter presses are ignored as accidental.

300

max_record_seconds

A hard stop, so a stuck key cannot record forever.

120

whisper_prompt

The dictionary hint given to Whisper models.

a starter set

insertion

ключщо робитьза замовчуванням

paste_mode

clipboard, or type for character by character.

"clipboard"

restore_clipboard

Put the clipboard back after pasting.

true

auto_enter

Press Enter after inserting.

false

paste_delay_ms

Extra wait before the paste, for slow windows.

replacements

The list of what to fix after recognition.

[]

commands

Voice commands and what each does.

[]

engines

ключщо робитьза замовчуванням

stt_source

local, or remote to send audio to server_url.

"local"

server_url

The address of a recognition server on another machine.

server_exe

Path to whisper-server.

"whisper-server.exe"

server_port

Loopback port for whisper-server.

8910

server_autostart

Start it yourself, or let the program do it.

true

sherpa_port

Loopback port for sherpa-server.

8912

stream_port

Loopback port for the streaming server.

8913

llm_port

Loopback port for llama-server.

8911

threads

CPU threads given to the recogniser.

engine_idle_minutes

Unload an engine after this many idle minutes.

post-processing

ключщо робитьза замовчуванням

post_enabled

Run prompts after recognition.

false

post_source

local or api.

"local"

post_api_url

Your endpoint, when the source is api.

post_api_key

Stored encrypted with Windows DPAPI, never in the log.

profiles

The prompts themselves, in order.

two presets

active_profiles

Which of them run.

[]

llm_model

Path to the GGUF editor model.

history, interface, updates

ключщо робитьза замовчуванням

history

Keep a history of dictations at all.

false

history_keep_min

How long an entry lives, in minutes.

10080

history_max

How many entries at most.

200

history_skip

Programs never recorded from.

ui_language

Interface language, or auto.

"auto"

skin

editor, fluent, studio, soft, paper, neon, terminal.

"editor"

theme

Colour inside the terminal design.

"green"

overlay

Show the plate while recording.

true

overlay_position

bottom, caret, or a saved place.

"bottom"

check_updates

Ask GitHub for a newer version at start.

false

config_version

Written by the program. Used for migrations.

Командний рядок

Усі прапорці приймає holdtotype.exe, якщо не сказано інакше. Друга копія, запущена з прапорцем, говорить із запущеною і завершується.

Щоденні

прапорецьщо робить

-settings [tab]

Open the settings window, optionally on a tab: state, system, mic, history, dictation, models, text, post, help, about, contacts.

-quit

Stop the running copy, engines included.

-wizard

Run the first-run wizard again.

-uninstall

Remove an installed copy. Add -silent for no questions.

Перевірки

прапорецьщо робить

-listmics

Print every capture device with its index.

-miclevel

Print the input level, to see whether the microphone is heard at all.

-modelcheck

Verify every downloaded model against its reference hash.

-routecheck

Print which model would serve which language, and whether it can translate.

-replcheck "phrase"

Run the replacement rules over a phrase and show the result.

-transcribe file.wav

Recognise a file with the current settings and print the text.

-postcheck "text"

Send a sample through the prompt chain.

-testpaste "text"

Insert a string the way a dictation would, to test insertion alone.

-dpi

Print how Windows is scaling each monitor.

Інсталятор, holdtotype-setup.exe

прапорецьщо робить

-silent

Install without a window.

-dir "path"

Where to install.

-model name

Download a model during the install: base, small, medium, turbo, gigaam, or none.

-lang xx

Interface language of the installer itself.

-uninstall

Remove, with -silent if wanted.

Файли й теки

Усе живе в теці програми. Останній стовпчик каже, що оновлення робить із кожним файлом.

файлщо цепри оновленні

holdtotype.exe

The program. Sits in the tray, owns the shortcut.

replaced

whisper-server.exe, sherpa-server.exe, sherpa-online-server.exe, llama-server.exe

The engines.

replaced

config.json

Every setting.

kept

config.json.vN.bak

A copy made once before each migration.

kept

models\

Everything downloaded, several gigabytes typically.

kept

holdtotype.log, holdtotype.log.old

One megabyte each, then it rolls over.

kept

holdtotype-history.json

Only if history is switched on. Text, never audio.

kept

%TEMP%\holdtotype-webview-*

Scratch for the settings window, removed on exit.

temporary

Порти та рушії

Рушії — звичайні HTTP- та websocket-сервери, прив'язані до 127.0.0.1. З мережі вони недоступні, а запускати рушій на порту, який уже тримає інший процес, програма відмовляється.

портрушійпротоколпрацює, поки

8910

whisper-server

HTTP

a Whisper model serves the language

8911

llama-server

HTTP, session key

post-processing is on

8912

sherpa-server

HTTP

a sherpa model serves the language

8913

sherpa-online-server

websocket

a streaming model is chosen

попередня← Історія та винятки наступнаЗібрати самому →