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-modulesservice: green whenBASE/CHECKoverwss://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).
- Open configurator — launches
- 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.