equisdots
Menú

Herramientas: timex, xturing, login

Referencia del motor de hora y clima timex, la interfaz de ajustes de terminal xturing y el tema de inicio de sesión SDDM estático.

Además del compositor y el shell, tres repositorios proporcionan herramientas específicas: timex (datos de hora y clima más la interfaz de calendario), xturing (todo el panel de ajustes en la terminal) y login (la pantalla de inicio de sesión SDDM estática).

timex

equisdots/timex es el motor de hora y clima. Alimenta el reloj de la barra, el emergente de calendario (SUPER + S), las caras de clima de escritorio y la pestaña de ajustes.

CLI

timex --json                     # cached JSON (throttled refresh)
timex --getdata                  # force a refresh
timex --invalidate               # drop the cache after a config change
timex --current-icon             # bar module reads
timex --current-temp
timex --current-hex
timex --icon | --temp | --hex    # forecast[0] variants
timex providers list             # name|label|needs_key|hint
timex geocode "Tokyo"            # top 5 matches for the UI picker
timex test                       # ok|description or fail|error
timex snapshot                   # icon|temp|max|min|desc|updated_epoch
timex status                     # provider|city|unit|configured|key_set|last_update|last_error
timex keys set OPENWEATHER_KEY <value>
timex keys remove OPENWEATHER_KEY
timex keys list                  # NAME|label|where|0-1

El motor ejecuta exactamente el proveedor seleccionado; no hay alternativas silenciosas. Si al proveedor le falta una ciudad o una clave, la caché recibe un estado de error explícito (Select a provider ["seleccione un proveedor"], Set a city ["establezca una ciudad"], Set the API key ["establezca la clave de API"], Unknown provider ["proveedor desconocido"]). timex se despliega como plugin: el motor, el panel de calendario (ui/TimexPopup.qml, vinculado a SUPER + S), la isla de barra (bar/Weather.qml) y la página de ajustes (settings/TimexPage.qml) viven en .../quickshell/ui/plugins/timex/. La isla consulta el motor directamente y el panel se exporta como provides.panels.calendar; ver Plugins y extensiones.

Proveedores

Nombre Clave Entrada Notas
open-meteo ninguna ciudad o lat,lon Geocodificación en caché; 5 días, por horas.
wttr ninguna ciudad 3 días, por horas.
openweather sí ciudad + clave Plan gratuito; geocodificación con la clave.

Añadir un proveedor es un ejecutable en api/providers/ que imprime el documento JSON normalizado, más una línea de catálogo en core/timex.sh.

Configuración

  • settings.json -> timex: { provider, city, unit } más las claves de diseño de la interfaz (forecastEnabled, forecastPosition below/above, forecastSize, forecastGap, forecastHours, forecastShowTime/Icon/Temp, forecastOrder y clockScale). Sin secretos; el plugin posee sus valores predeterminados y los expone en la página de ajustes de Timex.
  • Claves de API: ~/.local/state/quickshell/timex/keys.conf (modo 600), escritas con timex keys set.
  • Caché: ~/.cache/quickshell/timex/weather.json, con el contrato estable current_temp / current_icon / current_hex / forecast[].

xturing

equisdots/xturing es una TUI de Rust/ratatui que expone todas las opciones del panel de ajustes (el vinculado a SUPER + SHIFT + D). Lee y escribe el mismo settings.json y llama a los mismos scripts, por lo que el panel QML y xturing pueden coexistir.

Uso

xturing                        # installed at ~/.local/bin/xturing
xturing --page d_style         # open a page directly
xturing --search palette       # open the search palette pre-filled
xturing --dry-run              # no external commands; logs to /tmp/xturing-actions.log
xturing --help
Opción Efecto
--settings <path> settings.json alternativo.
--palettes <dir> Directorio de paletas alternativo.
--page <id> Abrir una página (s_general, d_style, d_palette, ...).
--search <query> Abrir la búsqueda prerrellenada.
--dry-run Igual que XTURING_DRY=1.

Páginas

24 páginas repartidas en seis grupos de navegación:

  • Shell: General, Teclado, Monitores, Arranque.
  • Barra: General, Posición, Estilo, Zonas, Módulos, Espacios de trabajo.
  • Tema: Apariencia, Paleta, Animaciones, Sombras, Marco, Cristal.
  • Comportamiento: Lanzador, Notificaciones.
  • Widgets: Emergentes (las secciones de Personalization.js).
  • Sistema: Hyprland, Entrada, GPU, Inactividad, Acerca de.

Teclas

Up/Down or j/k   move selection (wraps across pages)
Left/Right or h/l adjust / cycle
Tab / Shift+Tab  next / previous page
Enter/Space      edit, toggle, run
/ or Ctrl+P      search palette
r                reload settings.json, and in forms record a shortcut
?                help
q / Ctrl+C       quit

Contrato de escritura y pruebas en sandbox

  • settings.json se escribe de forma atómica (tmp + rename) con serde_json, conservando el orden de claves y las claves desconocidas.
  • Las escrituras son inmediatas; los vigilantes del shell las recogen en vivo.
  • Los caracteres de control en los glifos de bar.modules se conservan tal cual.

Pruebe sin tocar nada:

XTURING_DRY=1 xturing
cp ~/.config/hypr/settings.json /tmp/settings-test.json
XTURING_DRY=1 XTURING_SETTINGS=/tmp/settings-test.json xturing
XTURING_DRY=1 XTURING_SETTINGS=/tmp/settings-test.json \
  XTURING_PALETTES_DIR=/tmp/palettes-test xturing

Diferencias conocidas frente al panel QML

La interacción difiere donde el arrastrar y soltar o las muestras de color no se traducen a una TUI; el archivo de ajustes y su formato son idénticos:

  • Zonas: no hay drag and drop; Shift + Left/Right mueven un módulo dentro y entre zonas, Enter lo activa o desactiva.
  • Monitores: los campos Position X/Y sustituyen al lienzo de arrastre.
  • Paleta: los colores se editan como #rrggbb; Nueva paleta clona los 8 colores base de la paleta activa.
  • General: la lista de distribuciones xkb es un campo de texto libre.
  • El botón Refresh de Hyprland funciona aquí (hypr-effects.sh read); en el panel QML actual llama a un método que no existe.

Estructura

src/
  settings.rs   lectura/escritura atómica + tests
  catalog.rs    definición basada en datos de las 24 páginas y sus controles
  app.rs        estado, navegación, edición, páginas especiales, efectos
  ui.rs         renderizado ratatui (rail, contenido, selector, formularios)
  palette.rs    index.json, edición de paletas con backup, crear/borrar
  monitors.rs   hyprctl monitors, aplicar/reset con lua + display-config
  actions.rs    spawn/capture (con modo dry), notify-send

login

equisdots/login es la pantalla de inicio de sesión SDDM: una pantalla negra con el usuario recordado, un campo de contraseña con subrayado blanco, un selector de sesión y pequeños botones de apagado/reinicio, todo monocromo y dibujado con la Hack Nerd Font.

Es deliberadamente estática. El tema anterior sincronizado con la paleta escribía en /usr/share/sddm/themes en tiempo de ejecución, lo que requería sudo desde hooks y corría el riesgo de bloqueos PAM. Este tema se instala una vez y nunca vuelve a escribir:

./install.sh              # one-time sudo: theme + sddm config
./install.sh --uninstall  # remove theme and its sddm config

El instalador copia el tema a /usr/share/sddm/themes/x, lo selecciona en /etc/sddm.conf.d/10-x-theme.conf y desactiva el teclado en pantalla. Si otro gestor de pantalla posee display-manager.service, el enlace se cambia a SDDM (el anterior se respalda como display-manager.service.equisdots-backup). --uninstall lo restaura. El tema vive bajo theme/x/ con metadata.desktop y respeta theme.conf.user; dots system ejecuta el instalador por usted.

dots doctor verifica el archivo de configuración, el tema estático (sin Colors.qml) y que SDDM sea el gestor de pantalla activo.

Aparte, niri-login instala la entrada de sesión Wayland para que los gestores de pantalla (SDDM, GDM, cualquiera que lea wayland-sessions) listen "Niri" al iniciar sesión. Es una instalación de sistema (sudo) y se omite cuando la distro ya incluye una entrada. dotsniri login install|remove|status lo ejecuta; ver Compositor niri.

Páginas relacionadas

Editar esta página en GitHub