Skip to content

Waybar

Waybar usa JSON/JSONC para su configuración, combinado con CSS para estilos:


1️⃣ Configuración (config o config.json)

Section titled “1️⃣ Configuración (config o config.json)”
  • Es JSON estándar, con la extensión .json o .jsonc (JSON con comentarios).
  • Define qué módulos usar, su posición y comportamiento.
  • Sintaxis JSON = pares clave-valor:
{
"modules-left": ["workspaces", "sway/mode"],
"modules-right": ["network", "battery"]
}
  • Si usas .jsonc puedes poner comentarios con // o /* */ para explicar cosas.

  • Es CSS estándar.
  • Permite definir fuentes, colores, bordes, sombras, padding de los módulos:
#clock {
color: #ffffff;
font-family: "FiraCode Nerd Font";
}
.bar {
background-color: #1c1c1c;
border-bottom: 1px solid #333;
}

  • Waybar tiene módulos predefinidos (clock, battery, network, etc.) y módulos personalizados (custom/).

  • Los módulos se configuran en JSON con propiedades como:

    • "format" → cómo mostrar la salida.
    • "exec" → comando a ejecutar para módulos personalizados.
    • "interval" → frecuencia de actualización en segundos.
  • Puedes usar iconos de Nerd Fonts dentro de "format".


Por defecto, se guardan en:

~/.config/waybar/

Y ahí tienes principalmente:

  • config → define la estructura y módulos de la barra (qué aparece, en qué orden).
  • style.css → define el estilo visual (colores, fuentes, tamaños, márgenes, etc).

Si no existen, puedes copiarlos desde los ejemplos predeterminados:

Terminal window
mkdir -p ~/.config/waybar
cp /etc/xdg/waybar/config ~/.config/waybar/
cp /etc/xdg/waybar/style.css ~/.config/waybar/

Ejemplo mínimo para que Waybar funcione:

{
"layer": "top",
"position": "top",
"modules-left": ["hyprland/workspaces"],
"modules-center": ["clock"],
"modules-right": ["pulseaudio", "network", "battery"],
"clock": {
"format": "{:%H:%M}"
}
}

📝 Puedes añadir más módulos (CPU, RAM, temperatura, etc). Cada módulo tiene sus propias opciones.


* {
font-family: JetBrainsMono, monospace;
font-size: 12px;
color: #ffffff;
}
window#waybar {
background: rgba(30, 30, 30, 0.8);
border-bottom: 2px solid #5e81ac;
}
#clock {
padding: 0 10px;
}

Cuando edites los archivos:

Terminal window
pkill waybar && waybar &

Así se reinicia sin cerrar la sesión.