Measures download speeds on a local internet connection and sends an email (or SMS) alert when speeds are below a predefined threshold.
Sometimes routers or modems have bad days and need to be reboot, and sometimes ISPs have outages/service degredation and don't communicate with their customers or provide credits unless their customers contact them regarding the issue. This repository exists to provide people with a convenient way to stay informed about their internet speeds so that issues can be quickly mitigated.
- Clone this repository: "git clone https://github.com/pauldevnull/speedtest-alert.git"
- Navigate to the cloned repository: "cd speedtest-alert"
- Install dependencies: "npm install"
- Fill out the settings.json file:
{
// This is the threshold (in MBPS) that will trigger the alert if download speeds are less than the provided value
"threshold": 800,
// The service used to send the email or sms alert
"service": "gmail",
// The email address used to send the email or sms alert
"email": "[email protected]",
// The email address used to send the email or sms alert
"password": "[email protected]",
// The address that will receive the alert
"receiver": "[email protected]"
}
- Run the script: "node speedtest-alert.js"
To receive SMS alerts, use your phone number for the "receiver" value in the "config.json" formatted depending on your cell service provider (e.g. "receiver": "[email protected]"):
AT&T [email protected]
Carolina West Wireless [email protected]
Cellular One [email protected]
Illinois Valley Cellular [email protected]
Inland Cellular Telephone [email protected]
Sprint [email protected]
T-Mobile [email protected]
US Cellular [email protected]
Sprint [email protected]
T-Mobile [email protected]
US Cellular [email protected]
Verizon [email protected]
Virgin Mobile [email protected]
This script can be scheduled to run at a fixed interval. Guides can be found below depending on your operating system: