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,forecastPositionbelow/above,forecastSize,forecastGap,forecastHours,forecastShowTime/Icon/Temp,forecastOrderyclockScale). 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 contimex keys set. - Caché:
~/.cache/quickshell/timex/weather.json, con el contrato establecurrent_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.jsonse escribe de forma atómica (tmp + rename) conserde_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.modulesse 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/Rightmueven 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
- Shell Quickshell para el panel de ajustes que xturing replica.
- Temas y paletas para los destinos controlados por paletas.
- Arquitectura y repositorios para las rutas de instalación.