๐ User Manual
Complete guide to using Internet Speed Monitor effectively.
๐ฅ๏ธ Interface Overview
Internet Speed Monitor features a clean, intuitive interface designed for easy monitoring of your internet connection performance.
๐ Current Speed Display
Real-time view of your latest speed test results including download, upload, and ping measurements.
๐ฏ Median Statistics
Median values across all historical data providing better insights into typical performance.
๐ Speed History Chart
Interactive chart showing your internet performance over time with customizable time ranges.
โก Test Once Now
Instant speed testing button for immediate results without starting monitoring.
โ๏ธ Dual Scheduling Modes
Choose between Simple Interval mode for regular testing or advanced Cron Expression mode for precise timing control with work hours, daily, and custom schedules.
โฑ๏ธ Status Indicators
Real-time status with visual indicators, test running notifications, and countdown timers.
๐ Recent Tests Table
Detailed table of your most recent speed test results with timestamps and complete metrics.
๐งน Data Management
Export data to CSV, clear history, and manage debug logs with dedicated controls.
๐ Getting Started
Initial Setup
- Launch the Application: Open Internet Speed Monitor from your Applications folder, Start Menu, or desktop shortcut.
- Grant Permissions: If prompted, allow the application to access the internet for speed testing.
- Try a Quick Test: Click "Test Once Now" to run an immediate speed test and verify everything is working.
- Choose Schedule: Select your preferred scheduling mode (Simple Interval or Cron Expression) and choose from preset options or create custom schedules.
- Start Monitoring: Click "Start Monitoring" to begin automatic speed testing with status indicators and countdown timers.
First Speed Test
When you first start monitoring, the application will:
- Run an initial speed test to establish baseline performance
- Display results in the Current Speed section
- Begin plotting data on the Speed History chart
- Continue testing according to your scheduled pattern
โ๏ธ Configuration Options
Bandwidth Usage Guidelines
| Test Frequency | Daily Bandwidth Usage | Monthly Usage (Estimate) | Recommended For |
|---|---|---|---|
| Every 5-10 minutes | 200-400 MB | 6-12 GB | Troubleshooting active issues |
| Every 15-30 minutes | 50-100 MB | 1.5-3 GB | Regular monitoring |
| Every hour | 25-50 MB | 0.75-1.5 GB | Long-term trend analysis |
| Work hours only | 15-30 MB | 0.3-0.6 GB | Business hour monitoring |
| Daily tests | 2-5 MB | 60-150 MB | Minimal usage monitoring |
Scheduling Options
The application offers two powerful scheduling modes to fit your monitoring needs:
Simple Interval Mode
Perfect for consistent, regular monitoring at fixed intervals:
| Preset | Interval | Best For | Data Points/Day |
|---|---|---|---|
| 5m | Every 5 minutes | Troubleshooting, real-time monitoring | 288 |
| 15m | Every 15 minutes | Active monitoring, work hours | 96 |
| 30m | Every 30 minutes | Regular monitoring, balanced data | 48 |
| 1h | Every hour | Long-term trends, minimal bandwidth | 24 |
| 1d | Daily at midnight | Daily summaries, minimal usage | 1 |
Cron Expression Mode
Advanced scheduling using UNIX cron expressions for precise timing control:
- Work Hours Preset: Monitors Monday-Friday, 9 AM to 5 PM, hourly
- Custom Expressions: Create complex schedules using standard cron syntax
- Real-time Validation: Instant feedback on expression validity
- Next Run Preview: See when your next test will execute
Common Cron Patterns
0 */4 * * *- Every 4 hours0 9,17 * * 1-5- 9 AM & 5 PM, weekdays*/30 9-17 * * 1-5- Every 30 min, work hours0 0 * * 0- Every Sunday at midnight
Cron Expression Help
Click the "Help with cron expressions" link to access crontab.guru, an interactive tool for building and understanding cron expressions.
Format: minute hour day month weekday
Monitoring Controls
- Start/Stop Monitoring: Toggle automatic speed testing on or off
- Manual Test: Run a single speed test immediately
- Schedule Type: Switch between Simple Interval and Cron Expression modes
- Preset Buttons: Quick-select common scheduling patterns
- Clear Data: Remove all stored speed test history
Running in the Background
Closing the window does not stop monitoring. The app stays in the system tray (the menu bar on macOS) and keeps testing on your schedule.
- Open the window: Click the tray icon (on macOS, click it and choose "Open Internet Speed Monitor"), or launch the app again
- Close the window: Use the window's close button or File โ Close Window. Monitoring continues
- Quit: Choose Quit in the tray icon menu or File โ Quit. Monitoring stops
- Start with computer: With this option on (โฐ menu), the app starts at login with only the tray icon. Turn on "Auto-start monitoring" as well to begin testing without opening the window
- First launch: The app offers to turn on both options. They stay off unless you choose "Turn On"

Only one copy of the app runs at a time: launching it again shows the window of the copy that is already running. On macOS the Dock icon is shown only while the window is open.
Linux: the tray icon needs a desktop that shows StatusNotifier icons. KDE does; GNOME needs the AppIndicator extension. Without one, launch the app again to get the window back.
๐ Understanding Your Data
Speed Metrics Explained
๐ฅ Download Speed
Measures how quickly you can receive data from the internet. Important for streaming, browsing, and downloading files.
๐ค Upload Speed
How quickly you can send data to the internet. Critical for video calls, cloud backups, and content sharing. This figure is an estimate based on the download result: Fast.com's public API measures download only.
โก Ping/Latency
Measures response time to servers. Lower is better for gaming, video calls, and real-time applications.
Interpreting Speed Results
- Good Performance: Speeds within 80-100% of your ISP's advertised speeds
- Moderate Performance: Speeds between 50-80% of advertised speeds
- Poor Performance: Speeds below 50% of advertised speeds
- Ping Guidelines: <20ms excellent, 20-50ms good, 50-100ms fair, >100ms poor
Chart Features
- Hover Details: Mouse over data points for exact values and timestamps
- Time Range: Show the last 20 tests, the last day, the last 7 days or a date range you choose
๐ค Data Export and Backup
CSV Export
Export your speed test data for analysis in external tools:
- Open the โฐ menu and choose "Export as CSV", then pick the date range
- Choose a location and filename for your export
- Open the file in Excel, Google Sheets, or other spreadsheet applications
Export Data Format
The exported CSV contains the following columns:
DateandTime- When the test ran, in your local timeDownload Speed (Mbps)Upload Speed (Mbps)- EstimatedPing (ms)Network Interface- Wi-Fi, Ethernet or otherISP- Your provider at the time of the test
Data Backup
Your speed test data is automatically saved locally in JSON format. File locations:
- macOS:
~/Library/Application Support/Internet Speed Monitor/speed_tests.json - Windows:
%APPDATA%\Internet Speed Monitor\speed_tests.json - Linux:
~/.config/Internet Speed Monitor/speed_tests.json
๐ง Troubleshooting
Common Issues and Solutions
Speed Tests Failing
- Check your internet connection
- Verify firewall isn't blocking the application
- Try disabling VPN temporarily
- Restart your router/modem
- Contact your ISP if issues persist
Inaccurate Results
- Close bandwidth-intensive applications during testing
- Connect directly to your router via Ethernet if possible
- Ensure no other devices are heavily using the network
- Run multiple tests to establish a baseline
Application Performance
- Reduce test frequency if system performance is affected
- Clear old data periodically to maintain performance
- Ensure adequate disk space for data storage
- Restart the application if it becomes unresponsive
Getting Help
If you continue experiencing issues:
- Check the FAQ page for solutions to common problems
- Report bugs on GitHub Issues
- Include your operating system, app version, and error details
- Provide steps to reproduce the issue
๐ Privacy and Security
Data Privacy
- Local Storage: All data is stored locally on your device
- No Cloud Sync: No data is transmitted to external servers
- No Tracking: The application doesn't track user behavior
- No Personal Data: Only speed test metrics are collected
Network Security
- HTTPS Only: All speed tests use encrypted connections
- Minimal Permissions: App only requests necessary network access
- Open Source: Code is publicly auditable on GitHub
- Regular Updates: Security patches are released promptly