// docs / configuración

Configuración

LiveAudio escribe un config.json con valores por defecto sensatos en la primera ejecución. Cambia todo desde la GUI o edita el archivo directamente. Esta página es la referencia completa de claves.

Ubicación del archivo

Dónde vive config.json depende de si ejecutas la build del instalador o un checkout del código.

Build del instalador	Ruta
Windows	`%LOCALAPPDATA%\LiveAudio\data`
Linux	`~/.local/share/liveaudio/data`

Código / dev	Ruta
Windows	`%APPDATA%\LiveAudio`
Linux	`~/.config/liveaudio`

Con el launcher, el home de datos es <root>/data salvo que apuntes LIVEAUDIO_HOME a otro lugar. Cuando la app corre sin el launcher (un checkout de desarrollo), usa por defecto %APPDATA%\LiveAudio / ~/.config/liveaudio, y un config.json heredado que haya quedado en el directorio de trabajo se migra automáticamente en la primera carga.

Modo portable: crea un archivo portable.marker vacío junto al launcher y la raíz pasa a ser <launcher dir>/data, de modo que configuración, sesiones y modelos quedan al lado de la app en vez de en las ubicaciones por usuario de arriba. En este modo también se redirige HF_HOME dentro de la carpeta portable, así los modelos de Whisper descargados viven en el mismo disco — ideal para un pendrive.

Opciones

Clave	Tipo	Descripción
`output_dir`	string	Ruta a la carpeta de sesiones.
`device`	string	"cuda" o "cpu".
`cpu_threads`	number	Número de hilos de CPU para inferencia.
`model_size`	string	"tiny", "base", "small" o "turbo".
`blacklist`	string	Palabras de filtro separadas por coma (ver la blacklist en primeros-pasos).
`continuous_session`	boolean	Mantiene la misma sesión entre reinicios.
`subtitle_style`	string	default, karaoke, neon, minimal, bold, rgb, typewriter.
`subtitle_backlog_policy`	string	"auto", "live_only" o "send_all".
`subtitle_max_live_delay_sec`	number	Atraso máximo antes de que OBS oculte el backlog.
`subtitle_catchup_interval_sec`	number	Pacing entre ítems de backlog.
`silence_timeout`	number	Segundos de silencio antes de cortar un segmento.
`max_chunk_duration`	number	Segundos máximos antes de forzar el corte.
`audio_device`	string \| null	Dispositivo seleccionado, o null para el default del sistema.
`selected_profile_id`	string	"fast", "balanced", "quality" o "stable".
`profile_mode`	string	"preset" o "custom" — pasa a "custom" automáticamente cuando editas un perfil integrado.
`ws_port`	number	Puerto del servidor WebSocket (default: 8765).
`obs_enabled`	boolean	Habilita o deshabilita el envío de subtítulos a OBS.
`whisper_context_prompt_en`	string	Contexto de prompt inicial opcional pasado a Whisper para inglés (p. ej. nombres o jerga recurrentes). Vacío por defecto.
`whisper_context_prompt_es`	string	Lo mismo, para español. Vacío por defecto.
`asr_language`	string	Código de idioma para Whisper (ej. "en", "es").
`settings_navigation_mode`	string	Layout de la UI de ajustes — "tabs".
`diagnostics_enabled`	boolean	Activa la instrumentación de diagnóstico local.

Ejemplo de config.json

config.json

{
    "output_dir": "E:\\streams\\sessions",
    "device": "cuda",
    "cpu_threads": 8,
    "model_size": "small",
    "blacklist": "amara.org, subtítulos por, gracias por ver",
    "continuous_session": true,
    "subtitle_style": "default",
    "subtitle_backlog_policy": "auto",
    "subtitle_max_live_delay_sec": 10.0,
    "subtitle_catchup_interval_sec": 1.5,
    "silence_timeout": 0.8,
    "max_chunk_duration": 5.0,
    "audio_device": null,
    "selected_profile_id": "balanced",
    "profile_mode": "preset",
    "ws_port": 8765,
    "obs_enabled": true,
    "whisper_context_prompt_en": "",
    "whisper_context_prompt_es": "",
    "asr_language": "es",
    "settings_navigation_mode": "tabs",
    "diagnostics_enabled": false
}