← Volver al listado de tecnologías ← Índice de Ghostty

Capitulo 2: Configuracion Basica

17 de febrero de 2026 Por: SiempreListo

ghosttyterminalconfiguracionfuentescolorescursor

Capitulo 2: Configuracion Basica

Ghostty usa un archivo de texto plano con sintaxis clave = valor. No necesita JSON, YAML ni TOML. Es minimalista y directo.

Anterior: Instalacion | Siguiente: Atajos de teclado

Ubicacion del archivo de configuracion

~/.config/ghostty/config

En macOS tambien funciona:

~/Library/Application Support/com.mitchellh.ghostty/config

Sintaxis del archivo

Cada linea es una opcion con formato clave = valor. Los comentarios usan #:

# Esto es un comentario
font-family = JetBrains Mono
font-size = 14

No se necesitan comillas para los valores de texto, a menos que contengan caracteres especiales.

Fuentes

Familia de fuente

font-family = JetBrains Mono

Puedes definir familias especificas para cada estilo:

font-family = JetBrains Mono
font-family-bold = JetBrains Mono Bold
font-family-italic = JetBrains Mono Italic
font-family-bold-italic = JetBrains Mono Bold Italic

Tamano

font-size = 14

Acepta valores decimales como 13.5.

Estilos sinteticos

Si tu fuente no tiene variantes bold o italic, Ghostty puede sintetizarlas:

font-synthetic-style = true

Ligaduras y features tipograficas

# Activar ligaduras
font-feature = liga
font-feature = calt

# Desactivar ligaduras
font-feature = -liga

Colores

Fondo y primer plano

background = 1e1e2e
foreground = cdd6f4

Los colores se especifican en hexadecimal (sin #) o con nombres X11.

Paleta de 16 colores

# Colores normales (0-7)
palette = 0=#45475a
palette = 1=#f38ba8
palette = 2=#a6e3a1
palette = 3=#f9e2af
palette = 4=#89b4fa
palette = 5=#f5c2e7
palette = 6=#94e2d5
palette = 7=#bac2de

# Colores brillantes (8-15)
palette = 8=#585b70
palette = 9=#f38ba8
palette = 10=#a6e3a1
palette = 11=#f9e2af
palette = 12=#89b4fa
palette = 13=#f5c2e7
palette = 14=#94e2d5
palette = 15=#a6adc8

Color de seleccion

selection-foreground = 1e1e2e
selection-background = f5e0dc

Cursor

Estilo del cursor

# Opciones: block, bar, underline, block_hollow
cursor-style = bar

Parpadeo

# Desactivar parpadeo del cursor
cursor-style-blink = false

Color del cursor

cursor-color = f5e0dc
cursor-text = 1e1e2e

Opacidad del cursor

# Valor entre 0.0 y 1.0
cursor-opacity = 0.8

Transparencia y fondo

Opacidad de la ventana

# 0.0 (totalmente transparente) a 1.0 (opaco)
background-opacity = 0.95

Desenfoque de fondo

# Activar desenfoque (funciona con compositors compatibles)
background-blur = true

En Linux requiere un compositor que soporte blur (como KWin o Hyprland).

Padding

Espaciado interno

# Padding horizontal (en puntos)
window-padding-x = 10

# Padding vertical (en puntos)
window-padding-y = 8

Balance automatico

Distribuye el padding restante equitativamente alrededor del contenido:

window-padding-balance = true

Ventana

Dimensiones iniciales

Los valores representan columnas y filas de celdas:

window-width = 120
window-height = 35

Decoraciones de ventana

# Opciones: auto, none, client, server
window-decoration = auto

auto: Usa el valor por defecto del sistema
none: Sin bordes ni barra de titulo
client: Decoraciones dibujadas por la app
server: Decoraciones del gestor de ventanas

Tema de ventana

# Opciones: auto, system, light, dark, ghostty
window-theme = auto

Iniciar maximizado

maximize = true

Titulo de ventana

title = Mi Terminal

Scrollback

# Cantidad de lineas en el buffer de scroll (default: 10000)
scrollback-limit = 50000

Recargar configuracion

Despues de editar el archivo de configuracion, puedes recargar sin reiniciar:

macOS: Cmd + Shift + , o desde el menu
Linux: La accion reload_config (configurable via keybind)

Tambien puedes abrir el config directamente desde Ghostty con la accion open_config.

Configuracion de ejemplo completa

# Fuente
font-family = JetBrains Mono
font-size = 14
font-feature = liga
font-feature = calt

# Cursor
cursor-style = bar
cursor-style-blink = false

# Ventana
window-padding-x = 10
window-padding-y = 8
window-padding-balance = true
background-opacity = 0.95

# Scroll
scrollback-limit = 50000

# Shell integration
shell-integration = detect

Ver configuracion activa

Para inspeccionar todos los valores activos de Ghostty:

ghostty +show-config

Para ver solo una opcion especifica:

ghostty +show-config | grep font-size

Anterior: Instalacion | Siguiente: Atajos de teclado