v1.3.5 - Gateway Ping for Internet Measurements

What's New

Gateway Ping for Internet Tab

• Internet speedtests now measure and display gateway ping alongside jitter in the 'Jitter & Bufferbloat' chart
• Automatic database migration adds gateway_ping_ms column to existing databases

Bug Fixes

• Fixed gateway ping not being collected during Internet speedtests (was only collected for Homenet)
• Fixed gateway_ping_ms not being saved to database for Internet measurements
• Fixed F5 browser refresh briefly showing Internet tab when on Homenet tab

Technical

• Added gateway_ping_ms to Internet measurements API response
• Updated cache version to v=40

---

Note: Restart your NetWatch server and hard refresh (Ctrl+F5) after updating.

v1.3.4 - Simplified Installation & Improved Charts

What's New in v1.3.4

This release focuses on simplifying installation and improving chart clarity based on user feedback.

🚀 Installation Improvements

Simplified Setup Process

• install-linux.sh now only installs Python dependencies (no more automated service configuration)
• Users have full control over systemd service setup using clear documentation
• Updated README with both quick-start script and manual installation options
• Added comprehensive systemd service example with placeholder values

Better Documentation

• Step-by-step manual installation guide for Linux and Windows
• Clear examples for systemd service configuration
• Improved troubleshooting section
• Added Python symlink command for systems with only python3 installed

📊 Chart Improvements

Internet Tab - Simplified Jitter & Bufferbloat Chart

• Now shows only Gateway Ping and Jitter for clearer focus
• Removed redundant Idle/Download/Upload Ping metrics (available in other charts)
• Easier to identify network quality issues at a glance

Homenet Tab - Consolidated Charts

• Removed duplicate "Jitter & Bufferbloat" chart
• Single comprehensive Ping Analysis chart now shows all 5 metrics:
  • Idle Ping
  • Download Ping
  • Upload Ping
  • Gateway Ping
  • Jitter
• Cleaner dashboard layout with better data organization

🐛 Bug Fixes

• Fixed JavaScript error - Resolved undefined ping variable in Internet tab (changed to pingIdle)
• Chart consolidation - Eliminated duplicate Homenet chart that was confusing users

📖 Metric Differences Explained

Gateway Ping measures round-trip time to your router (local network latency)

• Normal values: 1-5ms
• High values indicate local network issues

Jitter measures ping variation/consistency

• Normal values: 0-5ms
• High values indicate unstable connection

Ping (Download/Upload) measures latency while bandwidth is saturated

• Shows connection responsiveness under load
• Used to detect bufferbloat

Download/Upload Latency measures additional delay added under load

• Calculation: Loaded Ping - Idle Ping
• Shows how much slower your connection gets when busy

Installation

Linux Quick Start

# Clone repository
git clone https://github.com/c4g7-dev/NetWatch.git
cd NetWatch

# Run setup script
bash install-linux.sh

# Activate virtual environment
source .venv/bin/activate

# Start NetWatch
python main.py

For systemd service setup, see the README.

Windows

# Clone repository
git clone https://github.com/c4g7-dev/NetWatch.git
cd NetWatch

# Create virtual environment
python -m venv .venv

# Activate
.venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Start NetWatch
python main.py

Upgrade Instructions

If upgrading from v1.3.3 or earlier:

cd /path/to/netwatch
git pull origin master
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
pip install -r requirements.txt --upgrade

Then restart NetWatch (or systemctl restart netwatch if running as service).

Note: Your measurement data and configuration are preserved during upgrades.

Full Changelog

Full Changelog: v1.3.3...v1.3.4

v1.3.3 - Installation Simplification & Metric Naming Unification

What's Changed

Installation Simplification

• Removed installer.py - The automated installer has been removed. Binary installation now works directly without additional setup scripts
• Simplified netwatch.service - Updated systemd service template with user-configurable placeholders (YOUR_USERNAME, /path/to/netwatch) for easier customization
• Added Python symlink command - For Linux systems with only python3 installed: sudo ln -s /usr/bin/python3 /usr/bin/python

Metric Naming Unification

• Split Loaded Ping metric - Changed from single "Loaded Ping" to separate "Download Ping" and "Upload Ping" metrics on Homenet tab to match Internet tab naming
• Consistent terminology - Both Internet and Homenet tabs now use identical metric names (Idle Ping, Download Ping, Upload Ping, Jitter) for easier comparison
• Updated chart titles - Renamed Homenet charts for clarity:
  • "LAN Latency History" to "Jitter & Bufferbloat"
  • "Bufferbloat (Latency Under Load)" to "Ping Analysis (Idle vs Download vs Upload vs Gateway)"

Chart Enhancements

• Internet tab Jitter & Bufferbloat chart - Enhanced from single Jitter line to 4 datasets:
  • Idle Ping (ms)
  • Download Ping (ms)
  • Upload Ping (ms)
  • Jitter (ms)
• Homenet Latency chart - Now shows 4 datasets: Idle Ping, Download Ping, Upload Ping, and Jitter
• Homenet Bufferbloat chart - Now shows 4 datasets: Idle Ping, Download Ping, Upload Ping, and Gateway Ping

Documentation

• Manual installation guide - Added step-by-step instructions for Linux and Windows in README
• Service setup instructions - Moved systemd service configuration inline with example template

Installation

Linux

1. Download the netwatch binary
2. Make it executable: chmod +x netwatch
3. (Optional) For systems with only python3: sudo ln -s /usr/bin/python3 /usr/bin/python
4. Run: ./netwatch

Windows

1. Download netwatch.exe
2. Run by double-clicking or via command prompt

See the README for detailed instructions and systemd service setup.

Full Changelog: v1.3.2...v1.3.3

v1.3.2 - Fix Metrics Display (Revert v1.3.1)

Fixed

• Internet Metrics Display - Reverted v1.3.1 JavaScript changes that caused all metrics to stop displaying on both Internet and Homenet tabs
• Delta Calculations - Added missing download_latency and upload_latency fields to delta calculation function
• Cache Busting - Updated JavaScript version to v=34 to ensure browsers load the fixed code

Breaking from v1.3.1

v1.3.1 introduced bugs that broke metric display on Linux deployments. This release reverts those changes and applies proper fixes.

Deployment

After updating to v1.3.2 on Linux:

1. Pull latest code: git pull or git checkout v1.3.2
2. Restart your NetWatch service
3. Hard refresh your browser (Ctrl+F5 or Ctrl+Shift+R) to clear cached JavaScript
4. Metrics should now display correctly

v1.3.1 - Fix Homenet Metrics Display

Fixed

• Gateway Ping & Local Latency Display - Fixed data mapping issue where Gateway Ping and Local Latency metrics were not displaying in the Homenet tab even when data was available
• Device Charts Not Showing Devices - Fixed issue where LAN/WiFi device charts showed 'No devices found' when devices had 'unknown' connection type (now included in WiFi/Wireless chart)
• Loaded Ping Mapping - Added proper mapping for loaded ping (ping under load) metric display

v1.3.0 - Homenet: Internal Network Monitoring

🏠 Homenet - Internal Network Monitoring

This release introduces Homenet - a comprehensive internal network monitoring system for testing LAN/WiFi device speeds.

✨ New Features

• Built-in Speedtest Server - Python-based server on port 5201 for LAN testing (no external dependencies)
• Device Discovery - Automatic scanning of network devices via ARP/ping
• LAN & WiFi Device Tracking - Separate charts and stats by connection type
• Bufferbloat Analysis - Idle Ping vs Loaded Ping vs Gateway Ping chart
• Device Management - Name devices, view history, track performance over time
• Auto-Registration - Devices running tests are automatically added
• Gateway Ping - Monitor latency to your router
• Live Test Progress - Real-time waveform visualization during tests
• Tab Navigation - Switch between Internet and Homenet views

🔧 Technical Improvements

• SSE streaming for real-time speedtest progress
• Continuous ping measurement during speedtest for accurate loaded latency
• Separate internal_metrics.db for homenet data
• Auto-start speedtest server on app launch

📖 Documentation

• Updated README with Homenet features and API docs
• Added CHANGELOG.md

---

Full Changelog: v1.2.0...v1.3.0

v1.2.0 - UI Polish

What's Changed

UI Improvements

• Cleaner interval input: Removed spinner arrows from number inputs for a more polished look
• Smoother modal loading: Config is now loaded before showing the modal, preventing the flash of default values
• Better debugging: Improved scheduler skip logging shows exactly why measurements are skipped

Full Changelog

v1.1.0...v1.2.0

v1.1.0 - Advanced Scheduler & Linux Support

What's New

Features

• Interactive Scheduler Configuration - Beautiful modal with 3 modes:
  • Simple: 24/7 monitoring with configurable interval (5-120 min)
  • Weekly: Select active weekdays with time windows
  • Advanced: Per-day custom schedules with multiple time slots
• Multiple Time Slots - Add multiple measurement windows per day
• Server-Side Config Storage - Scheduler settings sync across all devices
• Full Linux Support - systemd service with automated installer

Improvements

• Scheduler now respects UI configuration for all modes
• Overnight time slot support (e.g., 22:00-02:00)
• Scheduler config moved from YAML file to dashboard UI

Documentation

• Comprehensive Linux quick start guide (LINUX-GUIDE.md)
• Updated README with scheduler screenshots
• Removed deprecated scheduler config from docs

---

Full Changelog: v1.0.0...v1.1.0

NetWatch v1.0.0 - Initial Release

🚀 NetWatch v1.0.0 - Initial Release

Features

• ✅ Ookla Speedtest Integration - Automated speed testing with official Ookla CLI
• ✅ 8 Key Metrics - Download, Upload, Ping, Jitter, Loaded Latency (↓/↑), Download/Upload Latency
• ✅ Beautiful Glass-morphism UI - Modern frosted glass design with animations
• ✅ Interactive Charts - Time-series visualization with Chart.js
• ✅ Automated Scheduling - Configurable 30-minute interval measurements
• ✅ Historical Tracking - SQLite database with delta comparison
• ✅ CSV Export - Download filtered or complete datasets
• ✅ Manual Triggers - On-demand speedtest and bufferbloat tests
• ✅ REST API - Full programmatic access to all features

Installation

\\�ash
git clone https://github.com/c4g7-dev/netwatch.git
cd netwatch
python installer.py
\\

Requirements

• Python 3.10+
• Windows/Linux/macOS
• Internet connection for Ookla binary download

Links

• 📖 Full Documentation
• 🐛 Report Issues
• 💬 Discussions

Enjoy monitoring your network! ⭐