window-service-watcher Svelte Themes

Window Service Watcher

A lightweight, modern desktop application for real-time monitoring and management of Windows services.

#golang#svelte#wails#tailwindcss4#windows#window-service
Demo Download
App Logo

Window Service Watcher

A lightweight, modern desktop application for real-time monitoring and management of Windows services.

āœØ Overview

Provide a seamless dashboard for developers and system admins to monitor status, track resources (CPU/RAM), and control critical services. Default configuration supports monitoring POS services, but can be adapted for any Windows service.

Key Features

Feature Description
āš” Real-time Monitoring Live status updates (Running, Stopped, Paused) with sub-second latency.
šŸ“Š Resource Tracking Visual graphs for CPU usage (%) and Memory consumption (MB).
šŸŽ® Service Control Start, Stop, and Restart services directly from the UI.
šŸ“¦ Smart Installation Install and update service executables/files with one click.
āš™ļø Configurable Simple YAML configuration for managing multiple services.
šŸ”” System Tray (Coming Soon) Background operation and status notifications.

šŸ“ø Screenshots

Real-time Monitoring Configuration & Settings
Main Dashboard Settings
Service Installer OTA Updates
Install Service Update OTA

šŸ—ļø Architecture

Built on the Clean Architecture principle, ensuring separation of concerns and maintainability.

  • Frontend: Svelte 5 + TailwindCSS for a high-performance, reactive UI.
  • Backend: Go + Wails for native Windows API interaction.
  • Bridge: Async communication via Wails runtime events (services-update).
window-service-watcher/
ā”œā”€ā”€ internal/
ā”‚   ā”œā”€ā”€ app/        # App lifecycle & Watcher logic
ā”‚   ā”œā”€ā”€ config/     # Config loader (YAML)
ā”‚   ā”œā”€ā”€ domain/     # Interfaces & DTOs
ā”‚   ā””ā”€ā”€ service/    # Windows SCM implementation
ā”œā”€ā”€ frontend/src/   # Svelte 5 UI Components
ā”œā”€ā”€ main.go         # Entry point
ā””ā”€ā”€ wails.json      # Wails config

āš™ļø Installation and Setup

Prerequisites

  • Go (v1.25+)
  • Node.js (LTS)
  • Wails CLI: go install github.com/wailsapp/wails/v2/cmd/wails@latest

šŸ› ļø Steps

  1. Clone & Install Dependencies

    git clone https://github.com/zenkiet/window-service-watcher.git
cd window-service-watcher

# Install backend & frontend deps
make deps
cd frontend && pnpm install

  2. Run in Development Mode

    wails dev

  3. Build for Production

    wails build
# Output: ./build/bin/window-service-watcher.exe

šŸš€ Usage Guide

Configuration (config.yaml)

The app auto-generates this file on first run.

services:
  - id: "550e8400-e29b-41d4-a716-446655440000" # Unique ID
    name: "Payment Gateway Service"           # Display Name
    serviceName: "PaymentSvc"                 # Actual Windows Service Name
    path: "C:\\Services\\Payment\\app.exe"    # Executable Path
    installable: true                         # Allow file updates

Dashboard Controls

  • Status Cards: (šŸŸ¢ Running, šŸ”“ Stopped, šŸŸ” Pending).
  • Play/Stop: Toggle service state.
  • Metrics: Hover over cards to see detailed CPU/RAM history.

šŸ”Œ API / Key Functions

Backend (Go)

Function Description
Startup(ctx) Initializes Service Manager connection.
Start/StopService(id) Controls specific service state.
InstallService(id, files) Updates binary files and restarts service.
GetConfig() Returns the current loaded configuration.

Frontend Events

Event Payload Description
services-update map[string]Status Real-time status stream (1Hz).

šŸž Troubleshooting

āŒ Service Not Found / Error Fetching State
  • Cause: serviceName in config.yaml doesn't match the actual Windows Service name.
  • Fix: Check services.msc for the exact Service Name (not Display Name) and update config.
šŸš« Permission Denied
  • Cause: Controlling Windows services requires Administrator privileges.
  • Fix: Run the application or terminal as Administrator.
šŸ“‰ Metrics Not Showing
  • Cause: The service might be running but the process ID (PID) cannot be retrieved, or monitoring is blocked.
  • Fix: Ensure the service is actually running and you have permissions to query its process information.

šŸ¤ Contributing

Contributions are welcome! Please open issues or pull requests for bug fixes, features, or improvements.

šŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

If this project helped you, please consider supporting its development

Star the repository ā­
Share it with your network šŸ“¢

Made with ā¤ļø by ZenKiet

Top categories

tailwinddaisyuiadmin templatepopupmdsvexportfolioblogformecommerceuicarouselauthdarkseoimagerouting
Loading Svelte Themes