pardnchiu/go-web-monitor
Last updated
NoteThis README was generated by SKILL, get the ZH version from here.
WarningArchived on 2026-10-31. go-web-monitor is no longer maintained. The source code and the go run ./cmd/tui setup remain available, but no new features, bug fixes, or security updates will be published, and issues and pull requests are no longer accepted.KEEP EVERY SITE IN SIGHT, RIGHT FROM YOUR TERMINAL!
A Go terminal uptime monitor CLI with HEAD-first website checks, SSL certificate expiry countdown, and consecutive-failure email alerts
Table of Contents
Features
git clone https://github.com/pardnchiu/go-web-monitor && cd go-web-monitor && go run ./cmd/tui · Documentation- Live Terminal Dashboard — A TUI table shows each site's status, response time, status code, and overall uptime, refreshed concurrently every minute with no backend service to deploy.
- HEAD First, GET Fallback — Probes start with a lightweight HEAD request and switch to GET only on failure or 404, saving bandwidth while still handling servers that reject HEAD.
- SSL Expiry Countdown — Reads the certificate on port 443 to compute the days remaining and colors it green, yellow, or red at the 30- and 7-day thresholds.
- Alert Only on Sustained Failure — Sends an email only after 5 consecutive offline checks, filtering out false alarms from transient blips.
- SMTP Configured by Command — Set the host, credentials, and recipients inside the TUI; the client picks implicit TLS on 465 or STARTTLS on 587 and writes every change back to local JSON.
Architecture
Full Architecture
graph TB
Main[cmd/tui entry] --> Store[(.webMonitor.json)]
Main --> UI[TUI]
UI -->|every minute / refresh| Monitor[Monitor core]
UI -->|commands| Monitor
Monitor -->|HEAD → GET| Site[Target site]
Monitor -->|TLS 443| SSL[SSL certificate check]
Monitor -->|5 consecutive failures| SMTP[SMTP mailer]
SMTP --> Mail[Mail server]
Monitor -->|save| Store- graph TB
- Main[cmd/tui entry] --> Store[(.webMonitor.json)]
- Main --> UI[TUI]
- UI -->|every minute / refresh| Monitor[Monitor core]
- UI -->|commands| Monitor
- Monitor -->|HEAD → GET| Site[Target site]
- Monitor -->|TLS 443| SSL[SSL certificate check]
- Monitor -->|5 consecutive failures| SMTP[SMTP mailer]
- SMTP --> Mail[Mail server]
- Monitor -->|save| Store
License
This project is licensed under the MIT LICENSE.
Author
Just open an issue to share an idea.
©️ 2025 邱敬幃 Pardn Chiu