📊 Uptime Watcher
A Electron desktop application for uptime monitoring Track multiple services simultaneously with real-time updates, response time analytics, and historical data visualization
🎯 What is Uptime Watcher?
Uptime Watcher is a desktop application built with modern web technologies that provides monitoring capabilities for websites, APIs, servers, and network services. Unlike most monitoring tools, there's no cloud dependency or command-line interface required. You can monitor everything with ease from a GUI.
✨ Key Features
| 🌐 Multi-Protocol Monitoring | 📊 Real-Time Analytics | 🔔 Smart Notifications |
|---|---|---|
| HTTP/HTTPS websites & APIs | Live status updates | Desktop alerts for outages |
| TCP port connectivity | Response time tracking | Sound notifications |
| ICMP ping monitoring | Historical data visualization | Custom alert thresholds |
| DNS record validation | Performance metrics | Status change detection |
🛠️ Core Capabilities
- 🎯 Multi-Service Monitoring: Supports HTTP/HTTPS, TCP ports, ICMP ping, and DNS monitoring
- ⚡ Real-Time Updates: Live status changes with sub-second responsiveness
- 📈 Performance Analytics: Response time tracking with trend analysis
- 📜 Historical Data: Comprehensive uptime history with SQLite storage
- ⚙️ Flexible Configuration: Customizable check intervals from 30 seconds to 30 minutes
- 💾 Data Persistence: Local SQLite database with backup/restore functionality
📋 Monitor Types
| Type | Purpose | Features |
|---|---|---|
| HTTP/HTTPS | Website & API monitoring | Status codes, redirects, custom headers, SSL validation |
| TCP Port | Port connectivity testing | Socket connection validation, timeout handling |
| ICMP Ping | Network reachability | Packet loss monitoring, latency measurement |
| DNS | DNS resolution monitoring | Support for A, AAAA, CNAME, MX, TXT, NS, SRV, CAA, PTR, NAPTR, SOA, TLSA, ANY records |
🛠️ Technology Stack
🚀 Quick Start
Installation
Option 1: Download Release (Recommended)
# Download the latest release from GitHub
# Available for Windows, macOS, and Linux
Option 2: Build from Source
# Clone the repository
git clone https://github.com/Nick2bad4u/Uptime-Watcher.git
cd Uptime-Watcher
# Install dependencies
npm install
# Start development environment
npm run electron-dev
🖼️ Screenshots & Demo
Main Dashboard
Real-time monitoring dashboard with multiple service status overview
Monitor Configuration
Easy-to-use monitor configuration with multiple protocol support
Historical Analytics
Comprehensive analytics with response time graphs and uptime statistics
Notification System
Smart desktop notifications with customizable alert preferences👨💻 Development
Development Setup
# Start Vite dev server only
npm run dev
# Start Electron only (requires Vite to be running)
npm run electron
# Start both Vite and Electron concurrently (recommended)
npm run electron-dev
# Build for production
npm run build
# Package the application
npm run dist
Development Prerequisites
| Requirement | Version | Download |
|---|---|---|
| Node.js | 22.0+ (recommended) | Download |
| npm | 11.5.2+ (included with Node.js) | Docs |
| Git | Latest version | Download |
> 💡 Tip: Check out the Developer Quick Start Guide for detailed setup instructions and architecture overview.
Architectural Principles
The application follows a service-oriented architecture with clear separation of concerns:
🔧 Core Components
- 🖥️ Main Process (Electron): Service container with dependency injection
- 🎨 Renderer Process (React): Component-based UI with Zustand state management
- 🔗 IPC Communication: Type-safe communication via contextBridge
- 🗃️ Database Layer: Repository pattern with SQLite and transaction safety
- 📡 Event System: TypedEventBus for cross-service communication
- 📊 Monitoring System: Enhanced monitoring with operation correlation
🎯 Key Design Features
- 🏗️ Service-Oriented Architecture: Modular, testable service design
- 🔒 Type Safety: Strict TypeScript with comprehensive interfaces
- 📊 Enhanced Monitoring: Race condition prevention and operation correlation
- 🗃️ Repository Pattern: Transactional database operations
- 🎯 Event-Driven: Reactive communication between services
🤝 Contributing
We welcome contributions from the community! Here's how you can help:
🎯 Ways to Contribute
- 🐛 Bug Reports: Found an issue? Open an issue
- 💡 Feature Requests: Have an idea? Start a discussion
- 🔧 Code Contributions: Submit pull requests with improvements
- 📚 Documentation: Help improve our docs and guides
- 🧪 Testing: Help test new features and report issues
📋 Development Guidelines
- Fork the Repository and create a feature branch
- Follow Code Standards (TypeScript, ESLint, Prettier)
- Write Tests for new functionality
- Update Documentation for any user-facing changes
- Submit a Pull Request with a clear description
📄 License
This project is released under the Unlicense - Public Domain
You are free to use, modify, and distribute this software for any purpose, commercial or non-commercial, without any restrictions. Credit is appreciated but not required.
💬 Get Help
Last updated: August 2025 • Version 12.9.0