Crate pispas_tray_app

Crate pispas_tray_app 

Source
Expand description

§pispas_tray_app — Windows system-tray companion

Small GUI process that lives in the Windows notification area (“system tray”) and acts as the user-facing front for the background pispas_modules service.

§What it does

  • Shows a tray icon whose colour/state reflects the health of the pispas-modules service: green when BASE/CHECK over wss://local.unpispas.es:<port> succeeds, red when it fails.
  • Right-click menu:
    • Open configurator — launches pispas-configurator-html.
    • Restart service — calls the elevator (see CLAUDE.md §6) to bounce the Windows service.
    • Quit — closes the tray only (the service keeps running).
  • Surfaces balloon notifications when the underlying service emits an error (printer unreachable, cert expired, etc.).

§IPC with pispas-modules

The tray talks to the service through the same WebSocket that web clients use:

  tray-app  --wss://local.unpispas.es:<port>-->  pispas-modules
            <---  BASE / CHECK / PING  -----

This keeps everything on one code path — if the tray can reach the service, so can the browser.

For platform-specific bits, see pispas_tray::PisPasTrayIcon and tray_utils. The binary entry point lives in main.rs alongside this file.

Modules§

pispas_tray
prelude
tray_utils

Constants§

TRY_ICON_LOG_FILE