Referencia de Widgets

Esta página documenta cada widget disponible en Tsumiki, sus opciones de configuración, valores predeterminados y comportamiento.

Los widgets se configuran bajo [widgets.<nombre>] en config.toml y se colocan en la barra mediante las secciones de layout.

---

Widgets de Información del Sistema

CPU

Muestra el uso de la CPU con múltiples modos de visualización.

[widgets.cpu]
show_icon = true
icon = ""
tooltip = true
round = true
temperature_unit = "celsius"
show_unit = true
sensor = "acpitz"
mode = "graph"          # "label" | "graph" | "circular"
graph_length = 4

• mode: Estilo de visualización — label muestra texto de porcentaje, graph muestra un minigráfico, circular muestra un anillo de progreso circular.
• graph_length: Número de puntos de datos para el minigráfico.
• sensor: Ruta del sensor de zona térmica (ej. acpitz, k10temp). Déjalo vacío para detección automática.

Memoria

Muestra el uso de memoria con múltiples modos de visualización.

[widgets.memory]
show_icon = true
icon = ""
tooltip = true
mode = "label"          # "label" | "graph" | "circular"
graph_length = 4
unit = "gb"             # Unidad de visualización para valores de memoria

GPU

Muestra el uso de la GPU (soporta AMD via amdgpu y NVIDIA via nvidia-smi).

[widgets.gpu]
show_icon = true
icon = ""
tooltip = true
mode = "circular"       # "label" | "graph" | "circular"
graph_length = 4

Almacenamiento

Muestra el uso del disco para una ruta dada.

[widgets.storage]
path = "/"
show_icon = true
icon = "󰋊"
mode = "label"          # "label" | "graph" | "circular"
tooltip = true
graph_length = 4
unit = "gb"

Uso de Red

Monitorea velocidades de subida/bajada de red en tiempo real.

[widgets.network_usage]
tooltip = true
label_format = "{upload}   {download} "
upload_threshold = 1024
download_threshold = 1024
kb_digits = 0
mb_digits = 2
interval = 2000         # Intervalo de sondeo en milisegundos

Variables disponibles en label_format: {upload}, {download}.

Actualizaciones

Verifica actualizaciones de paquetes del sistema (Arch Linux, Flatpak, Snap, Homebrew).

[widgets.updates]
show_icon = true
available_icon = "󰏗"
no_updates_icon = "󰏖"
os = "arch"
hover_reveal = true
reveal_duration = 500
interval = 3600         # Intervalo de actualización en segundos
tooltip = true
terminal = "kitty"
pad_zero = false
label = true
auto_hide = false
flatpak = true
snap = false
brew = false

• interval: Intervalo de sondeo en segundos (predeterminado: 3600 = 1 hora).
• os: Distribución para verificación de paquetes nativos (soporta arch, fedora, ubuntu).
• flatpak/snap/brew: Activar verificación para estos formatos de paquetes.

---

Widgets de Hardware y Energía

Batería

Muestra el nivel de batería con iconos y notificaciones personalizables.

[widgets.battery]
full_battery_level = 100
hide_percent_when_full = true
hide_when_missing = true
icons = ["", "", "", "", ""]
tooltip = true
label_format = "{icon} {percent}"

[widgets.battery.notifications]
low_threshold = 10
full_battery = false
low_battery = false
charging = false

Variables disponibles en label_format: {icon}, {percent}, {time_remaining}.

La sección de notificaciones controla qué eventos de batería activan notificaciones de escritorio.

Volumen

Controla el volumen de salida de audio del sistema.

[widgets.volume]
tooltip = true
step_size = 5

Haz clic para silenciar/activar sonido, desplázate para ajustar el volumen.

Brillo

Controla el brillo de la pantalla y el teclado.

[widgets.brightness]
tooltip = true
step_size = 5

Requiere brightnessctl. Haz clic para alternar, desplázate para ajustar.

Bluetooth

Gestiona conexiones y visibilidad Bluetooth.

[widgets.bluetooth]
label = true
tooltip = true

Abre un popover para gestionar dispositivos emparejados y activar/desactivar Bluetooth.

Micrófono

Muestra el estado del micrófono y la opción de silenciar.

[widgets.microphone]
label = false
tooltip = true
show_icon = true

Haz clic para silenciar/activar el micrófono.

Botón de Energía

Menú de energía del sistema con apagado, reinicio, suspensión, hibernación, bloqueo y cierre de sesión.

[widgets.power]
icon = "󰐥"
tooltip = true
items_per_row = 3
icon_size = 100
show_icon = true
label = false
confirm = true

[widgets.power.item_shortcuts]
shutdown = "s"
reboot = "r"
hibernate = "h"
suspend = "u"
lock = "l"
logout = "o"

[widgets.power.buttons]
shutdown = "systemctl poweroff"
reboot = "systemctl reboot"
hibernate = "systemctl hibernate"
suspend = "systemctl suspend"
lock = "loginctl lock-session"
logout = "loginctl terminate-user $USER"

• confirm: Muestra un diálogo de confirmación antes de ejecutar acciones de energía.
• item_shortcuts: Atajos de teclado para los elementos del menú de energía.

Hypridle

Activa/desactiva el daemon de gestión de inactividad de Hyprland.

[widgets.hypridle]
enabled_icon = ""
disabled_icon = ""
label = true
tooltip = true

Hyprsunset

Activa/desactiva el filtro de luz azul (modo nocturno) mediante Hyprsunset.

[widgets.hyprsunset]
temperature = "2800k"
enabled_icon = "󱩌"
disabled_icon = "󰛨"
label = true
tooltip = true

Hyprpicker

Selector de color que captura un color de la pantalla.

[widgets.hyprpicker]
icon = ""
tooltip = true
label = false
quiet = false
show_icon = true

El color seleccionado se copia al portapapeles. En modo silencioso, no se muestra ninguna notificación.

Indicador de Privacidad

Muestra cuándo las aplicaciones están usando el micrófono, la cámara o compartiendo pantalla.

[widgets.privacy_indicator]
tooltip = true
hide_when_inactive = true
modules = ["camera", "microphone", "screen"]

---

Widgets de Escritorio y Espacios de Trabajo

Espacios de Trabajo

Muestra escritorios virtuales con cambio por clic/desplazamiento. Consulta la documentación completa de Espacios de Trabajo para detalles.

[widgets.workspaces]
count = 10
hide_unoccupied = true
ignored = [-99]
reverse_scroll = false
style = "numbered"       # "numbered" | "pill" | "icon" | "default" | "underline" | "bubble"
empty_scroll = false
label_format = "{id}"
icon_map = {}

• style: Elige entre numbered, pill, icon, default, underline o bubble.
• icon_map: Mapea IDs de espacios de trabajo a iconos personalizados: { "1": "", "2": "" }.
• label_format: Cadena de formato con variable {id}.

Título de Ventana

Muestra el título de la ventana actualmente enfocada.

[widgets.window_title]
icon = true
truncation = true
truncation_size = 50
tooltip = true
mappings = true
title_map = []
fallback = "class"       # "class" | "title"

• title_map: Lista de reglas de mapeo para renombrar títulos de ventana.
• fallback: Qué mostrar cuando no hay título disponible.

Conteo de Ventanas

Muestra el número de ventanas en el espacio de trabajo actual.

[widgets.window_count]
label_format = " [{count}]"
hide_when_zero = true
tooltip = true

Variables disponibles en label_format: {count}.

Botón de Overview

Botón que abre la vista general/exposé de ventanas.

[widgets.overview_button]
icon = "󰡃"
tooltip = true
label = false

Barra de Tareas

Muestra las aplicaciones en ejecución como iconos en los que se puede hacer clic, similar a una barra de tareas tradicional.

[widgets.taskbar]
icon_size = 22
ignored = []
tooltip = true

---

Widgets de Fecha, Hora y Calendario

Menú de Fecha y Hora

Muestra la fecha/hora actual con un popover de calendario y notificaciones de eventos.

[widgets.date_time]
date_format = " %a %b %d,"
calendar = true
clock_format = "12h"   # "12h" | "24h"
hover_reveal = false
reveal_duration = 500

[widgets.date_time.notification]
enabled = true
count = true
hide_count_on_zero = true

Reloj Mundial

Muestra la hora en múltiples zonas horarias.

[widgets.world_clock]
icon = "󰃰"
use_24hr = true
show_icon = true
timezones = ["America/New_York", "Asia/Tokyo"]

---

Widgets de Medios y Audio

Controles Multimedia MPRIS

Muestra los medios que se están reproduciendo actualmente con controles de reproducción.

[widgets.mpris]
truncation_size = 20
tooltip = true
label_format = "{title} - {artist}"
hide_when_no_player = true
ignore = []

Variables disponibles en label_format: {title}, {artist}, {album}, {name}.

Requiere playerctl. Se oculta automáticamente cuando no hay ningún reproductor de medios en ejecución.

Visualizador de Audio Cava

Visualización de audio en tiempo real impulsada por Cava.

[widgets.cava]
bars = 10
color = "#89b4fa"

Requiere que Cava esté instalado y configurado.

---

Utilidades del Sistema

Captura de Pantalla

Captura pantallas con soporte de anotaciones.

[widgets.screenshot]
path = "Pictures/Screenshots"
icon = "󰄀"
tooltip = true
annotation = true
delayed = false
delayed_timeout = 5000
label = false
capture_sound = false

Usa grimblast para capturas y satty para anotaciones.

Grabación de Pantalla

Inicia/detiene la grabación de pantalla con audio opcional.

[widgets.recorder]
path = "Videos/Screencasting"
tooltip = true
audio = true
delayed = false
delayed_timeout = 5000

Usa wf-recorder para grabar.

OCR (Reconocimiento Óptico de Caracteres)

Extrae texto de una región de la pantalla usando Tesseract.

[widgets.ocr]
icon = "󰐳"
tooltip = true
label = false
show_icon = true
quiet = false

Requiere tesseract, slurp e imagemagick.

Gestor de Portapapeles

Historial del portapapeles con soporte de imágenes.

[widgets.clipboard]
icon = ""
label = false
tooltip = true
item_tooltip = false
show_images = true
enable_pinning = true

Usa cliphist para el historial del portapapeles.

Gestor USB

Gestiona el montaje y expulsión de unidades USB.

[widgets.usb_manager]
icon = "󰕓"
label = false
tooltip = true
auto_refresh = true
refresh_interval = 5

---

Widgets de Entrada e Idioma

Diseño de Teclado

Muestra el diseño de teclado actual.

[widgets.keyboard]
icon = "󰌌"
label = true
tooltip = true
show_icon = false

Idioma

Muestra el idioma de entrada actual.

[widgets.language]
icon = ""
tooltip = true
truncation_size = 2
show_icon = false

Submapa

Muestra el submapa de atajos de Hyprland activo.

[widgets.submap]
icon = "󰌌"
label = true
tooltip = true
show_icon = false
hide_on_default = false

Se oculta automáticamente cuando el submapa activo es el predeterminado.

---

Widgets de UI y Aplicaciones

Botón de Lanzador de Aplicaciones

Abre el popup del lanzador de aplicaciones.

[widgets.launcher_button]
icon = "view-app-grid-symbolic"
icon_size = 20
tooltip = true

Ajustes Rápidos

Un panel completo de ajustes rápidos con información de usuario, controles, medios y atajos.

[widgets.quick_settings]
hover_reveal = false

[widgets.quick_settings.user]
avatar = "~/.face"
name = "system"
distro_icon = true

[widgets.quick_settings.controls]
sliders = ["brightness", "volume"]

[widgets.quick_settings.media]
enabled = true
ignore = []
truncation_size = 30
show_album = true
show_artist = true
show_time = true
show_time_tooltip = true

[widgets.quick_settings.shortcuts]
enabled = true

[[widgets.quick_settings.shortcuts.items]]
icon = ""
label = "Terminal"
command = "kitty"
tooltip = "Abrir terminal"
icon_size = 18

Bandeja del Sistema

Bandeja del sistema para aplicaciones en segundo plano (NetworkManager, Bluetooth, etc.).

[widgets.system_tray]
icon_size = 16
ignored = []
hidden = []
hide_when_empty = false

Botón de Fondo de Pantalla

Abre el popup de selección de fondo de pantalla.

[widgets.wallpaper]
icon = "󰸉"
label = false
tooltip = true

Botón de Configuración

Abre la GUI de configuración de la aplicación.

[widgets.settings]
icon = "󰒓"
tooltip = true
label = false

Selector de Temas

Cambia rápidamente entre temas instalados.

[widgets.theme_switcher]
icon = ""
notify = false    # Mostrar notificación al cambiar de tema

Cheatsheet

Muestra una hoja de referencia de atajos de Hyprland con búsqueda.

[widgets.cheatsheet]
label = true
label_text = "Teclas"
tooltip = true
title = "Hyprland Cheatsheet"
columns = 3
groups_per_page = 6
max_entries_per_group = 8

Selector de Emojis

Busca e inserta caracteres emoji.

[widgets.emoji_picker]
icon = ""
label = false
tooltip = true
per_row = 9
per_column = 4

Tablero Kanban

Un tablero simple de gestión de tareas Kanban.

[widgets.kanban]
icon = "󱞁"
label = false
tooltip = true

Temporizador Pomodoro

Un temporizador de productividad Pomodoro.

[widgets.pomodoro]
icon = "🍅"
label = true
label_text = "Pomo"
tooltip = true

Acompañante Git

Muestra información del repositorio de GitHub (issues, PRs).

[widgets.git_companion]
icon = ""
label = false
label_text = "Git"
tooltip = true
username = "rubiin"
repository = "rubiin/tsumiki"
avatar_size = 44
default_tab = "issues"      # "issues" | "pull_requests"
cache_ttl = 300

Cloudflare WARP

Gestiona la conexión VPN de Cloudflare WARP — conectar, desconectar y ver estado.

[widgets.cloudflare_warp]
label = false
label_text = "WARP"
tooltip = true
connected_icon = ""
disconnected_icon = ""

• connected_icon / disconnected_icon: Iconos Nerd Font mostrados en la barra para cada estado.
• Haz clic en el widget para abrir un popover con un botón de alternancia.
• Requiere warp-cli de Cloudflare WARP Client para Linux.
• El servicio sondea warp-cli status cada 5 segundos para detectar cambios de estado.

Conmutador DNS

Cambia rápidamente entre proveedores DNS populares directamente desde la barra.

[widgets.dns_switcher]
icon = "󰚘"
label = false
label_text = "DNS"
tooltip = true

Haz clic para abrir un popover con proveedores preconfigurados:

Proveedor	DNS Primario	DNS Secundario
Cloudflare	1.1.1.1	1.0.0.1
Google	8.8.8.8	8.8.4.4
OpenDNS	208.67.222.222	208.67.220.220
AdGuard	94.140.14.14	94.140.15.15
Quad9	9.9.9.9	149.112.112.112

Incluye un botón “Restablecer a Predeterminado (ISP)” para restaurar el DNS automático.

• Usa nmcli (NetworkManager) para gestionar la configuración DNS.
• Los cambios DNS requieren autenticación Polkit (pkexec).
• El servicio sondea nmcli cada 3 segundos para detectar el servidor DNS actual.

Monitor de IP

Muestra la dirección IP actual.

[widgets.ip_monitor]
icon = "󰖟"
label = false
label_text = "IP"
tooltip = true

Cronómetro

Un simple cronómetro/temporizador.

[widgets.stopwatch]
stopped_icon = "󱫞"
running_icon = "󱫠"

Contador de Clics

Un contador que se incrementa con cada clic.

[widgets.click_counter]
count = 0

Respira

Un widget guía de ejercicios de respiración.

[widgets.breathe]
icon = ""
label = false
tooltip = true

Clima

Muestra las condiciones climáticas actuales para una ubicación.

[widgets.weather]
location = "kathmandu"
label_format = "{temperature} {condition}"
tooltip = true
expanded = true
temperature_unit = "celsius"   # "celsius" | "fahrenheit"
wind_speed_unit = "kmh"        # "kmh" | "mph" | "ms" | "beaufort"
interval = 86400
hover_reveal = true
reveal_duration = 500
provider = "open-meteo"        # "open-meteo" | "wttr"

Variables disponibles en label_format: {temperature}, {condition}.

---

Widgets de Diseño y Agrupación

Divisor

Un separador visual entre secciones de la barra.

[widgets.divider]
size = 2

Botón Personalizado

Consulta la Configuración Avanzada para configuración y uso.

Grupo de Botones Personalizados

Consulta la Configuración Avanzada para configuración y uso.

Widget Personalizado

Consulta la Configuración Avanzada para configuración y uso.

Grupos de Widgets y Grupos Plegables

Los widgets se pueden agrupar con estilo compartido:

[[widget_groups]]
widgets = ["workspaces", "window_title"]
spacing = 2
style_classes = ["compact"]

[[collapsible_groups]]
widgets = ["ocr", "screenshot", "recorder"]
spacing = 4
icon = "󰒓"
tooltip = "Utilidades"
style_classes = ["utility-tools"]

Referencia grupos en el diseño usando @group:N o @collapsible:N (índice basado en cero):

[layout]
left_section = ["@group:0", "window_title"]
right_section = ["@group:1", "@collapsible:0", "system_tray"]