Configuración

xtop guarda su configuración automáticamente al salir. El fichero es config.json en el directorio de configuración de la plataforma, junto a las carpetas themes/ y layouts/:

~/.config/xtop/config.json                (Linux)
~/Library/Application Support/xtop/       (macOS)
%APPDATA%\xtop\                           (Windows)

En Linux puedes cambiar el directorio base con $XDG_CONFIG_HOME.

Claves

Clave	Tipo	Valor por defecto	Descripción
`theme`	string	`"x"`	Nombre del tema de color seleccionado actualmente (uno de los 12 incluidos o un tema de usuario).
`layout_mode`	string	`"Dashboard"`	Modo de layout integrado. Uno de `Dashboard`, `Vertical`, `Horizontal`, `CpuFocus`, `MemoryFocus`, `NetworkFocus`, `ProcessFocus`. Se ignora mientras `layout_name` nombre un layout personalizado válido.
`layout_name`	string	`""`	Nombre del layout activo cuando es personalizado (no integrado). Cuando no está vacío y se encuentra, tiene prioridad sobre `layout_mode`.
`update_interval_ms`	integer	`1000`	Intervalo de muestreo en milisegundos. Se limita a 100–3.600.000 al cargar.
`history_points`	integer	`100`	Puntos de datos conservados para los gráficos históricos.
`alerts`	object	ver abajo	Umbrales de alerta; consulta Umbrales de alerta.
`keybindings`	object	ver abajo	Keybindings por acción; consulta Keybindings.
`style`	object	ver abajo	Estilo de glifos de los widgets (charset de gráficos, bordes, packs); consulta Estilo.
`effect`	string (opcional)	ausente	Efecto de frame aplicado a cada frame renderizado: `"fade"` activa el fundido de entrada integrado (solo en compilaciones hechas con la feature `effects`). Cualquier otro valor desactiva los efectos.

Ejemplo

{
  "theme": "miami",
  "layout_mode": "Dashboard",
  "layout_name": "",
  "update_interval_ms": 1000,
  "history_points": 100,
  "alerts": {
    "cpu_high": 90.0,
    "mem_high": 90.0,
    "disk_high": 90.0
  },
  "keybindings": {
    "quit": ["q"],
    "help": ["?"],
    "next_theme": ["t"],
    "prev_theme": ["T"],
    "next_layout": ["l"],
    "toggle_fullscreen": ["f"],
    "cycle_fullscreen": ["F"],
    "search": ["/"],
    "command_palette": ["ctrl+p", "ctrl+P"],
    "cancel": ["escape"],
    "kill_process": ["k"],
    "process_up": ["up"],
    "process_down": ["down"],
    "cycle_sort": ["s"]
  },
  "style": {
    "charset": "braille",
    "borders": "native",
    "pack": null,
    "widgets": {}
  }
}

Las claves desconocidas y las claves opcionales ausentes se ignoran; un fichero que no se pueda analizar cae a los valores por defecto de arriba.

Umbrales de alerta

Cuando una métrica supera su umbral configurado, el widget correspondiente cambia a color rojo y muestra un indicador de advertencia en su título.

Clave	Descripción	Valor por defecto
`cpu_high`	Porcentaje de uso de CPU que dispara una advertencia	90.0
`mem_high`	Porcentaje de uso de memoria que dispara una advertencia	90.0
`disk_high`	Porcentaje de uso de disco que dispara una advertencia	90.0

Keybindings

Cada acción acepta una lista de cadenas de tecla; gana la primera coincidencia. Las teclas se escriben como: caracteres simples ("q", "/", "?"), caracteres en mayúscula ("T", "F"), teclas con modificador ("ctrl+p", "alt+x") y teclas con nombre ("escape", "enter", "backspace", "tab", "up", "down", "left", "right", "delete", "home", "end", "pageup", "pagedown").

Clave (acción)	Vinculación por defecto	Acción
`quit`	`["q"]`	Guardar la configuración y salir
`help`	`["?"]`	Alternar la superposición de ayuda
`next_theme`	`["t"]`	Siguiente tema
`prev_theme`	`["T"]`	Tema anterior
`next_layout`	`["l"]`	Siguiente layout
`toggle_fullscreen`	`["f"]`	Alternar la vista de pantalla completa
`cycle_fullscreen`	`["F"]`	Recorrer el widget en pantalla completa
`search`	`["/"]`	Iniciar la búsqueda de procesos
`command_palette`	`["ctrl+p", "ctrl+P"]`	Abrir la paleta de comandos (ctrl+p también funciona como respaldo fijo en el código)
`cancel`	`["escape"]`	Cancelar la búsqueda / cerrar superposiciones
`kill_process`	`["k"]`	Terminar el proceso seleccionado (comprobación de seguridad de mismo usuario)
`process_up`	`["up"]`	Mover la selección de procesos hacia arriba
`process_down`	`["down"]`	Mover la selección de procesos hacia abajo
`cycle_sort`	`["s"]`	Recorrer la columna de ordenación de procesos (CPU% → Memory → PID → Name)

Estilo

El objeto style controla los glifos de los widgets. Los valores son los enums comunes del ecosistema de xtop-widget-api:

charset: braille (por defecto), dot, block, half_block, bar — marcadores de gráfico usados por los gráficos históricos.
borders: native (por defecto, marco clásico de una línea), rounded, double, plain, ascii (plain/ascii dibujan un marco ASCII puro +-|).
pack: pack de widgets usado para cada widget sin anulación por widget ("default" o "blocks" cuando se compila con la feature widget-blocks).
widgets: mapa de anulaciones por nombre de widget, cada una acepta charset, borders y pack.

Consulta customization.md para un ejemplo y la semántica completa por widget.

Temas y layouts personalizados

Para temas y layouts personalizados, consulta la guía de personalización.

Volver al README