docs

Referencia: config.json, línea de comandos, archivos y puertos

Todo lo que el programa lee y escribe, para cuando la ventana de ajustes no basta: las claves de config.json, las opciones de línea de comandos, los archivos de la carpeta y los puertos en los que escuchan los motores.

Actualizado 9 de septiembre de 2026 · Vitalii Yemets

config.json

Texto plano en la carpeta del programa. Edítalo a mano y pulsa Releer en la sección System, o deja que la ventana lo escriba.

dictation

clavequé hacepor defecto

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

clavequé hacepor defecto

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

clavequé hacepor defecto

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

clavequé hacepor defecto

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

clavequé hacepor defecto

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.

Línea de comandos

Todas las opciones van a holdtotype.exe salvo que se diga lo contrario. Una segunda copia iniciada con una opción habla con la que está en marcha y termina.

A diario

opciónqué hace

-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.

Comprobaciones

opciónqué hace

-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.

El instalador, holdtotype-setup.exe

opciónqué hace

-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.

Archivos y carpetas

Todo vive en la carpeta del programa. La última columna dice qué hace una actualización con cada uno.

archivoqué esal actualizar

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

Puertos y motores

Los motores son servidores HTTP y websocket normales atados a 127.0.0.1. No se alcanzan desde la red, y el programa se niega a arrancar uno en un puerto que otro proceso ya ocupa.

puertomotorprotocolose ejecuta mientras

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

anterior← Historial y exclusiones siguienteCompilarlo tú mismo →